Gerir o consentimento em várias ferramentas pode ser desafiante—mas não tem de ser. Com o 2-Way Sync da iubenda, parte da Consent Database, a sincronização dos seus consentimentos de marketing entre plataformas é simples, em tempo real e totalmente conforme.
Este guia orienta-o sobre como integrar a Consent Database da iubenda com plataformas de terceiros utilizando 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:
Inicie sessão em Zapier, crie um novo Zap e escolha Webhooks by Zapier.
Selecione Catch Hook como o evento de disparo e copie a URL do webhook que o Zapier fornece.
2. Configurar o Webhook no iubenda:
No iubenda, vá à seção Webhooks de Saída. (Do painel do iubenda, selecione o projeto e clique no ícone de configurações, Abra Webhooks da Consent Database: No menu lateral, clique em “Webhooks da Consent Database”.
Se não sabe como aceder à secçã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, subscrição de newsletter).
Guarde o webhook.
3. Testar e Publicar:
Dispare um evento (por exemplo, uma atualização de subscrição) e teste o disparador no Zapier.
[Opcional] Defina Filtros ou Caminhos:
Se enviar vários valores através de 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 “verdadeiro”.
Adicione o serviço que deseja conectar (por exemplo, Mailchimp) e especifique as alterações que deseja aplicar, como atualizar o status do assinante com base no campo de email no webhook.
Uma vez que tudo funcione, publique o Zap.
💡 Dica: Use Histórico do Zap para garantir que tudo está a funcionar corretamente.
Como Integrar um Webhook de Saída com o Make
1. Criar um Cenário:
Inicie sessão em Fazer e crie um novo cenário com Webhooks. Escolha Webhook personalizado e copie a URL.
2. Configurar o Webhook no iubenda:
No iubenda, vá à seção Webhooks de Saída. (Do painel do iubenda, selecione o projeto e clique no ícone de configurações, Abra Webhooks da Consent Database: No menu lateral, clique em “Webhooks da Consent Database”.
Se não sabe como aceder à secção de webhooks, verifique aqui
Crie um novo webhook de saída, cole a URL do Make e selecione a preferência que deseja acompanhar (por exemplo, atualizações de boletins informativos).
Guarde o webhook.
3. Executar e Automatizar
No Make, clique Redeterminar estrutura de dados e desencadeie um evento no iubenda (por exemplo, uma atualização de subscrição de newsletter) e deixe o Make detectá-lo.
Agora pode ligar o webhook a um serviço como Mailchimp e aplicar as atualizações, como gerir subscritores com base no seu email.
Uma vez confirmado, o sistema funcionará automaticamente.
[Opcional] Adicionar Filtros:
Se enviar vários valores, defina filtros no Make para ativar apenas quando valores específicos forem enviados.
💡 Dica: Verifique o Fazer painel para monitorizar a integração.
Como integrar um webhook de saída com o 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á à seção Webhooks de Saída. (Do painel do iubenda, selecione o projeto e clique no ícone de configurações, Abra Webhooks da Consent Database: No menu lateral, clique em “Webhooks da Consent Database”.
Se não sabe como aceder à secção de webhooks, verifique aqui
Crie um novo webhook de saída, cole a URL do N8N e selecione a preferência que deseja acompanhar.
Guarde o webhook.
3. Teste e Vá ao Vivo:
No N8N, ouça o evento de teste (por exemplo, uma atualização de subscrição) e deixe o N8N confirmar a estrutura dos dados.
[Opcional] Adicionar Filtros ou Caminhos:
Se enviar múltiplos valores, pode configurar filtros para processar apenas certos valores ou criar diferentes caminhos para vários resultados.
Agora, conecte o webhook a uma aplicação como Mailchimp e aplique quaisquer alterações, como criar um novo contacto.
Guarde o seu fluxo de trabalho e ative-o. A partir de agora, sempre que um assinante for adicionado à Consent Database, será automaticamente sincronizado com o Mailchimp.
💡 Dica: Use a aba de Execução no N8N para garantir que tudo está a funcionar corretamente.
Avançado: O que fazer se um Webhook falhar
Se um webhook falhar porque o servidor de destino não está a responder, a iubenda tenta novamente o pedido várias vezes:
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 Depois de mais 45 minutos
Sexta tentativa Após 1 hora
sétima tentativa Após 1,5 horas
Tentativa oitava Após 2 horas
Nova tentativa: Após 2,5 horas
Décima tentativa Após 3 horas
Após 10 tentativas falhadas, o webhook é marcado como falhado e não será tentado novamente.
Disjuntor
Se um webhook falhar 10 vezes seguidas, será automaticamente desativado. Você receberá um e-mail, e ele será marcado como desativado nas suas configurações de webhook.
Exemplo de Payload de Webhook
Aqui está um exemplo dos dados que o iubenda envia em um webhook:
