Objetivo da integração: Sempre que um titular de dados for criado na plataforma, um email deve ser enviado para o responsável configurado no webhook.
Documentação da API Mailgun:
https://documentation.mailgun.com/en/latest/api_reference.html
Premissas para integração
Ter uma conta no Mailgun (https://www.mailgun.com/)
Ter uma conta na Privacy Tools
Passo 1 - Pegar as chaves de integração no Mailgun
No menu esquerdo, clique em Settings -> API Keys. Na aba “Api Security”, clique no ícone de “olho” para visualizar a “Private API key”. Copie a chave para ser usada nos próximos passos.
Passo 2 - Configurar webhook
2.1 Crie um webhook na Privacy Tools, em Webhooks -> Meus webhooks. Preenchas os seguintes valores:
Método: POST
Endpoint: https://api.mailgun.net/v3/privacytools.com.br/messages
Método de autenticação: Basic
Usuário: api
Senha: cole a Private API key obtida no Passo 1.
Na aba “Corpo da requisição”, escolha “Form Data” e adicione os seguintes pares de Nome e Valor:
Nome: from Valor: email remetente. Exemplo: “Suporte Privacy Tools <suporte@privacytools.com.br>”
Nome: to Valor: email do destinatário. Exemplo alerta-titular@privacytools.com.br
Nome: subject Valor: título do email
Nome: text Valor: texto do email
Após preencher o formulário, é possível e recomendado testar o webhook clicando no botão “Testar Webhook”. Na modal seguinte, se exibir algum campo de formulário, preencha com qualquer valor de teste. Clique no botão “Testar”.
Se a configuração funcionou, deve mostrar o resultado com Http Staus 200 e um email é enviado para o endereço preenchido no atributo “to“ da aba “Corpo da requisição”.
Se retornar algum Http status diferente de 200, revise os valores preenchidos na configuração do webhook e faça o teste novamente.
Se tudo ocorrer bem, salve o webhook para concluir o cadastro.
2.1 Crie uma trigger para disparar o webhook
Com o webhook criado agora vamos configurar uma trigger para executar o webhook quando acontecer algum evento.
Acesse o menu “Minhas triggers” e crie uma nova conforme o exemplo abaixo. Esta é uma trigger que vai executar o webhook de envio de e-mail através do Mailgun sempre que um titular for cadastrado na Privacy Tools.
Titulares são cadastrados quando uma solicitação (DSAR) é enviada para a empresa ou quando um consentimento é dado ou revogado. Em ambos os casos o titular só é cadastrado na primeira interação com a empresa.