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.
...
| Info |
|---|
Premissa: Você precisa ter um usuário e senha da conta de desenvolvedor da Dinamize. Caso não tenha um, solicite para a mesma. |
Criando um app na Dinamize
No seu painel de desenvolvedor da Dinamize, escolha o menu “DevPartner” e clique em “Adicionar aplicativo”
...
Na próxima tela cadastre um aplicativo conforme exemplo abaixo.
...
Caso tenha alguma dúvida sobre o preenchimento dos campos adicionais no aplicativo, verifique nos manuais da Dinamize ou entre em contato com eles. Após salvar o aplicativo a tela abaixo aparecerá com a sua chave de integração.
| Warning |
|---|
ATENÇÃO - Nem a Dinamize nem a Privacy Tools tem como recuperar esta chave caso você perca. Guarde com cuidado. |
...
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 Workflow.
Enviando Titulares para a Dinamize
| Info |
|---|
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
| Info |
|---|
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.
| Note |
|---|
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 fluxo. 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.
Autorizando envio de emails para titulares
| Info |
|---|
Se você tem uma finalidade que, quando aceite pelo titular, deve fazer com que a Dinamize envie e-mails para ele, você precisa remover a data de descanso. |
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.
| Note |
|---|
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 aceite de consentimento vai executar o fluxo. Já com o uso de uma condição, apenas consentimentos da finalidade que tenha determinado código é que serão aceitos. |
Pronto! Agora quando este consentimento for aceito, o usuário vai perder a “data de descanso” e voltará a receber emails