Dinamize - Como Integrar
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 Loading...
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 Workflow.
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 fluxo 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 fluxos. No exemplo abaixo estamos enviando o nome e o e-mail de titulares que forem criados na Privacy Tools
Crie um gatilho com o evento “Titular criado” e relacione este evento com o fluxo 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 fluxo 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, fluxo criado, agora vamos criar o gatilho.
Note que este gatilho acima será executada quando um titular revogar seu consentimento. Ao fazer isso o mesmo gatilho vai chamar o fluxo da Dinamize e também o fluxo do Mailchimp, garantindo assim a atualização em dois sistemas juntos, por exemplo.
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.
Autorizando envio de emails para titulares
Primeiro, crie um fluxo com o serviço ‘upsert’ e no corpo da requisição utilize o atributo “date_rest” em branco.
Pronto, fluxo criado, agora vamos criar o gatilho.
Note que este gatilho acima será executada quando um titular aceitar seu consentimento. Ao fazer isso o mesmo gatilho vai chamar o fluxo da Dinamize e também o fluxo do Mailchimp, garantindo assim a atualização em dois sistemas juntos, por exemplo.
Pronto! Agora quando este consentimento for aceito, o usuário vai perder a “data de descanso” e voltará a receber emails