Com 22 mil clientes, mais de 1.000 Dinamize Partner, 8 filiais no Brasil, filiais no exterior, incluindo Portugal, Angola, Inglaterra, Canadá e Estados Unidos, a Dinamize é líder absoluta em e-mail marketing no Brasil e possui um dos mais relevantes softwares de automação de marketing do país.
Premissa: Você precisa ter um usuário e senha da conta de desenvolvedor da Dinamize. Caso não tenha um, solicite para a mesma.
A documentação da API da Dinamize está em https://panel.dinamize.com/apidoc/partner/#api-_
1 - Obtenha um ConnectionToken
Usando o Postman, faça uma requisição com:
Cabeçalhos para HOMOLOGAÇÃO:
Authorization = Application eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBfaWQiOjUyfQ.P__HnqAVpx09evunGahJqEJHOM0CRXA2RAfnVYf5cBHHd9YcwroOvKSNSw4y2XxRCzVHH2BfA2hBYnVI2-XUqg
Content-Type = application/json;charset=utf-8
Cabeçalhos para PRODUÇÃO:
Authorization = Application eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBfaWQiOjUxfQ.b-CVZEiNgqmCNlz7bkHm1un-VO2nn5k3_fTm9T3S8spelVWppMO1q0VPQ2gn4TBFfXpA9QN9AOaAr8jIutXYoA
Content-Type = application/json;charset=utf-8
Corpo (raw/json)
{
"redirect_url":"https://www.privacytools.com.br",
"requested_permissions":["EMKT_READ_CONTACTS","EMKT_WRITE_CONTACTS"],
"connection_id":"<< SEU EMAIL DE LOGIN PRIVACY TOOLS >>"
}
Pronto, com isso você obtém o ConnectionToken. Agora temos que obter o ConsentToken. Na imagem abaixo mostra onde aparece o ConnectionToken.
2 - Obtenha um ConsentToken
Para obter este token você precisa usar o nosso ‘ConnectionToken’ configurado na Dinamize. Para isso, troque o token no link abaixo pelo ConnectionToken.
https://panel.dinamize.com/connect?code=CONNECTIONTOKEN
Faça login na sua conta Dinamize e clique em ‘Continuar’ na tela abaixo.
Após continuar, mantenha a autorização de leitura e escrita e clique em Continuar.
Ao concluir você receberá um email com o Token definitivo. Certifique-se de ter usado um email correto no campo SEU EMAIL DE LOGIN PRIVACY TOOLS . Talvez demore 1 ou 2 minutos.
Pronto, com o ConsentToken você pode fazer as integrações!
Na imagem abaixo você tem um exemplo do email que será recebido por você.
Agora que você já tem o ‘Consent-token’ você pode usar as API’s da dinamize através do recurso de Webhooks. Se não sabe usar um webhook, leia mais em Webhooks
Enviando Titulares para a Dinamize
Escopo: Quando um titular for criado ou atualizado na Privacy Tools, você quer enviar o email do mesmo para a plataforma da Dinamize.
Primeiro, crie um webhook com a API de criação de contatos:
Caso você queira inserir OU atualizar um contato, pode usar o serviço https://api.dinamize.com/emkt/contact/upsert
Configura o cabeçalho de autenticação com o seu Consent-Token
No corpo da requisição use as marcações disponíveis no manual de webhooks. No exemplo abaixo estamos enviando o nome e o email de titulares que forem criados na Privacy Tools
Crie uma trigger com o evento “Titular criado” e relacione este evento com o webhook criado.
Pronto, agora novos titulares que aparecerem na plataforma serão enviados para a Dinamize.
Removendo Titulares dos envios
Se você tem uma finalidade que, quando revogada pelo titular, deve fazer com que a Dinamize deixe de enviar emails para ele, você pode usar o recurso de “Data de descanso” com uma data bem longa (2099) para “remover” do usuário dos envios.
Primeiro, crie um webhook com o serviço ‘upsert’ e no corpo da requisição utilize o atributo “date_rest”. Vamos colocar uma data muito longa, como 01/01/2099
Pronto, webhook criado, agora vamos criar a trigger.
Note que esta trigger acima será executada quando um titular revogar seu consentimento. Ao fazer isso a mesma trigger vai chamar o webhook da Dinamize e também o webhook do Mailchimp, garantindo assim a atualização em dois sistemas juntos, por exemplo.
Um ponto importante desta execução é a condição para execução. Se você não colocar nenhuma condição, então todo e qualquer revogação de consentimento vai executar o webhook. Já com o uso de uma condição, apenas consentimentos da finalidade que tenha determinado código é que serão revogados.
Pronto! Agora quando este consentimento for revogado, o usuário vai receber uma data muito longa na dinamize e não será usado nos envios de email.
Vinculando Listas com Finalidades da LGPD
Manual em construção
Gerando Links de Consentimento para Email Marketing
Manual em construção
Gerando Links do Portal da Privacidade
Manual em construção