Gerenciar o consentimento em diferentes plataformas é um desafio comum para as empresas, mas não precisa ser assim. Com a 2-Way Sync da iubenda, que faz parte do Consent Database, você pode manter os status de consentimento atualizados em tempo real em todas as suas ferramentas de terceiros. Este recurso ajuda você a permanecer em conformidade, melhorar a precisão e simplificar o processo de gerenciamento das preferências do usuário.
Este guia mostrará como configurar a 2-Way Sync usando o Consent Database da iubenda com ferramentas como Zapier, Make e N8N. Você também aprenderá a lidar com problemas comuns, como tentativas de repetição e falhas, tudo em uma estrutura simples e fácil de seguir.
A 2-Way Sync garante que as preferências de consentimento coletadas por meio da iubenda sejam automaticamente atualizadas nas ferramentas de terceiros conectadas. Da mesma forma, as alterações feitas nessas ferramentas podem ser refletidas no Consent Database da iubenda, mantendo tudo sincronizado e em conformidade.
Com os webhooks, o processo fica perfeito:
Atualizações em tempo real: aciona ações no momento em que uma preferência de consentimento é alterada.
Fluxo de dados bidirecional: mantém os status de consentimento consistentes entre ferramentas como HubSpot, Mailchimp e muito mais.
Como Integrar um Webhook de Saída com o Zapier
1. Criar um Zap:
Faça login no Zapier, crie um novo Zap e selecione Webhooks by Zapier como o aplicativo.
Escolha o Catch Hook como o evento acionador e copie a URL do webhook fornecida pelo Zapier.
2. Configurar o Webhook no iubenda:
Na iubenda, acesse a seção Webhooks do Consent Database. (No dashboard da iubenda, selecione o projeto e clique no ícone de configurações, Abra a os Webhooks do Consent Database: No menu lateral, clique em “Webhooks do Consent Database“)
Se você não souber como acessar a seção de webhooks, confira aqui ⬇️
Crie um novo webhook de saída, cole a URL fornecida pelo Zapier e selecione a preferência que você deseja sincronizar (por exemplo, assinatura de boletim informativo).
Salve o webhook.
3. Teste e Publique:
Acione um evento na iubenda (por exemplo, uma atualização de assinatura).
Teste o webhook no Zapier e conecte-o ao serviço de terceiros que você deseja sincronizar (por exemplo, Mailchimp).
[Opcional] Defina Filtros ou Caminhos:
Se você estiver enviando múltiplos valores via webhooks (por exemplo, todas as preferências de newsletter), configure filtros ou caminhos no Zapier para prosseguir apenas com valores específicos, como apenas quando a preferência estiver definida como “true”.
Adicione o serviço que você deseja conectar (por exemplo, Mailchimp) e especifique as alterações que deseja aplicar, como atualizar o status do assinante com base no campo de e-mail no webhook.
Uma vez que tudo funcione, publique o Zap.
💡 Dica: Use Histórico do Zap para garantir que tudo esteja funcionando corretamente.
Como Integrar um Webhook de Saída com o Make
1. Criar um Cenário:
Faça login no Make e crie um novo cenário.
Selecione Webhooks, escolha Webhook personalizado e copie a URL fornecida.
2. Configurar o Webhook no iubenda:
Na iubenda, acesse a seção Webhooks do Consent Database. (Do painel do iubenda, selecione o projeto e clique no ícone de configurações, Abra a Base de Dados de Consentimento Webhooks: No menu lateral, clique em “Webhooks do Consent Database“)
Se você não souber como acessar a seção de webhooks, confira aqui ⬇️
Crie um novo Webhook de saída, cole a URL do Make e selecione a preferência que você deseja rastrear (por exemplo, atualizações de boletins informativos).
Salve o webhook.
3. Executar e Automatizar
No Make, clique em Redeterminar estrutura de dados e acione um evento na iubenda (por exemplo, uma atualização de assinatura de boletim informativo).
Deixe o Make detectar a estrutura de dados e conectar o webhook a uma ferramenta de terceiros (por exemplo, HubSpot).
Agora você pode vincular o webhook a um serviço como Mailchimp ou HubSpot e aplicar as atualizações, como gerenciar assinantes com base no e-mail deles.
Uma vez confirmado, o sistema será executado automaticamente.
[Opcional] Adicionar Filtros
Se você enviar vários valores, defina filtros no Make para acionar apenas quando valores específicos forem enviados.
💡 Dica: Verifique o Fazer dashboard para monitorar a integração.
Como Integrar um Webhook de Saída com N8N
1. Criar um Fluxo de Trabalho:
Abra o N8N e crie um novo fluxo de trabalho.
Adicione um nó de Webhook, defina o método como POST e copie a URL do webhook.
2. Configurar o Webhook no iubenda:
Na iubenda, acesse a seção Webhooks do Consent Database. (Do painel do iubenda, selecione o projeto e clique no ícone de configurações, Abra a Base de Dados de Consentimento Webhooks: No menu lateral, clique em “Webhooks do Consent Database“)
Se você não souber como acessar a seção de webhooks, confira aqui ⬇️
Crie um novo Webhook de saída, cole a URL do N8N e selecione a preferência que deseja rastrear.
Salve o webhook.
3. Teste e Vá ao Vivo:
No N8N, ouça o evento de teste (por exemplo, uma atualização de assinatura), e deixe o N8N confirmar a estrutura dos dados.
[Opcional] Adicionar Filtros ou Caminhos
Se você estiver enviando múltiplos valores, pode configurar filtros para processar apenas certos valores ou criar diferentes caminhos para vários resultados.
Agora, conecte o webhook a um aplicativo como Mailchimp e aplique quaisquer alterações, como criar um novo contato.
Salve seu fluxo de trabalho e ative-o. A partir de agora, toda vez que um assinante for adicionado ao Consent Database, ele será sincronizado automaticamente com o Mailchimp.
💡 Dica: Use a aba de Execução no N8N para garantir que tudo esteja funcionando corretamente.
Advanced: O que fazer se um Webhook falhar
Às vezes, um webhook pode falhar devido a problemas com o servidor de destino. Quando isso acontece, a iubenda automaticamente tenta a solicitação até 10 vezes, seguindo este cronograma:
2 minutos após a primeira falha.
Aumentando os intervalos (5 minutos, 10 minutos, até 3 horas).
Após 10 tentativas fracassadas, o webhook é marcado como falho e desativado.
Aqui está o cronograma de tentativas:
Primeira tentativa Após 2 minutos
Segunda tentativa Depois de mais 5 minutos
Terceira tentativa Depois de mais 10 minutos
Quarta tentativa Depois de mais 20 minutos
Quinta tentativa Após mais 45 minutos
sexta tentativa Depois de 1 hora
Sete tentativa Após 1,5 horas
Tentativa oitava Após 2 horas
Tentativa nona: Após 2,5 horas
Décima tentativa Após 3 horas
Após 10 tentativas falhadas, o webhook é marcado como falhou e não será tentado novamente.
Disjuntor:
Se um webhook falhar 10 vezes seguidas, ele será automaticamente desativado. Você receberá um e-mail, e ele será marcado como desativado nas configurações do seu webhook.
Exemplo de Payload de Webhook
Aqui está um exemplo dos dados que a iubenda envia em um webhook:
{
"subject":{
"id":"9b05c70c5c78a31aeaf13f8f27c1f890",
"email":"subject@email.com"
},
"consent_preferences":{
"newsletter":"false"
},
"changes":{
"newsletter":"false"
}
}
subject: O ID e o e-mail do usuário.
consent_preferences: As preferências de consentimento atualizadas, como assinar ou cancelar a assinatura de um boletim informativo.
changes: Quaisquer alterações no registro de consentimento anterior.
