Gerenciar consentimento em várias ferramentas pode ser desafiador—mas não precisa ser. Com o 2-Way Sync da iubenda, parte do Consent Database, a sincronização dos seus consentimentos de marketing entre plataformas é perfeita, em tempo real e totalmente compatível.
Este guia o orienta sobre como integrar o Banco de Consentimento da iubenda com plataformas de terceiros usando webhooks de saída, incluindo ferramentas como Zapier, Make e N8N. Também abordaremos tópicos avançados, como lidar com tentativas falhadas, reintentos e entender a estrutura do payload do webhook.
Como Integrar um Webhook de Saída com o Zapier
1. Criar um Zap:
Faça login no Zapier, crie um novo Zap e escolha Webhooks by Zapier.
Selecione Catch Hook como o evento de gatilho e copie a URL do webhook que o Zapier fornece.
2. Configurar o Webhook no iubenda:
No iubenda, vá para a seção Outbound Webhooks. (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 sabe como acessar a seção de webhooks, verifique aqui
Crie um novo webhook de saída, cole a URL do Zapier e selecione a preferência que deseja atualizar (por exemplo, assinatura de newsletter).
Salve o webhook.
3. Teste e Publique:
Acione um evento (por exemplo, uma atualização de assinatura) e teste o acionador no Zapier.
[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 em Make e crie um novo cenário com Webhooks. Escolha Webhook personalizado e copie a URL.
2. Configurar o Webhook no iubenda:
No iubenda, vá para a seção Outbound Webhooks. (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 sabe como acessar a seção de webhooks, verifique aqui
Crie um novo webhook de saída, cole a URL do Make e selecione a preferência que você deseja acompanhar (por exemplo, atualizações de boletins informativos).
Salve o webhook.
3. Executar e Automatizar
No Make, clique Redeterminar estrutura de dados e acione um evento no iubenda (por exemplo, uma atualização de assinatura de newsletter) e deixe o Make detectá-lo.
Agora você pode vincular o webhook a um serviço como Mailchimp e aplicar as atualizações, como gerenciar assinantes com base em seu e-mail.
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:
Em N8N, crie um novo fluxo de trabalho e adicione um Webhook nó. Defina o método para POST e copie a URL do webhook.
2. Configurar o Webhook no iubenda:
No iubenda, vá para a seção Outbound Webhooks. (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 sabe como acessar a seção de webhooks, verifique 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
Se um webhook falhar porque o servidor de destino não está respondendo, iubenda tenta a solicitação várias vezes:
Ele tenta novamente 10 vezes, começando 2 minutos após a primeira falha e aumentando o tempo de espera após cada tentativa. 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:
