Integração de Webhooks com Serviços de Terceiros

Gerir o consentimento em várias plataformas é um desafio comum para as empresas, mas não tem de ser assim. Com a 2-Way Sync da iubenda, parte da Consent Database, pode manter os estados de consentimento atualizados em tempo real em todas as suas ferramentas de terceiros. Esta funcionalidade ajuda-o a manter-se em conformidade, melhorar a precisão e simplificar o processo de gestão de preferências do utilizador.

Este guia mostrar-lhe-á como configurar a 2-Way Sync utilizando a Consent Database da iubenda com ferramentas como Zapier, Make e N8N. Aprenderá ainda a lidar com problemas comuns, como novas tentativas e tentativas falhadas, tudo numa estrutura simples e fácil de seguir.

Como Integrar um Webhook de Saída com o Zapier

1. Criar um Zap:

• Inicie sessão na Zapier, crie um novo Zap e selecione Webhooks by Zapier como a aplicação.



• Escolha Catch Hook como evento acionador e copie o URL do webhook fornecido pela Zapier.

2. Configurar o Webhook no iubenda:

• Na iubenda, aceda à secção Webhooks da Consent Database. (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, veja aqui ⬇️



• Crie um novo Webhook de saída, cole o URL fornecido pela Zapier e selecione a preferência que pretende sincronizar (por exemplo, subscrição de newsletter).



• Guarde o webhook.

3. Testar e Publicar:

• Acione um evento na iubenda (por exemplo, uma atualização de subscrição).
• Teste o webhook na Zapier e ligue-o ao serviço de terceiros que pretende sincronizar (por exemplo, Mailchimp).



• [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.

Como Integrar um Webhook de Saída com o Make

1. Criar um Cenário:

• Inicie sessão no Make e crie um novo cenário.
• Selecione Webhooks, escolha Webhook personalizado e copie o URL fornecido.

2. Configurar o Webhook no iubenda:

• Na iubenda, aceda à secção Webhooks da Consent Database. (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, veja aqui ⬇️



• Crie um novo Webhook de saída, cole o URL do Make e selecione a preferência que pretende rastrear (por exemplo, atualizações de newsletters).



• Guarde o webhook.

3. Executar e Automatizar

• No Make, clique em Redefinir estrutura de dados e acione um evento na iubenda (por exemplo, uma atualização de subscrição de newsletter).
• Deixe que o Make detete a estrutura de dados e ligue o webhook a uma ferramenta de terceiros (por exemplo, o HubSpot).
• Agora pode ligar o webhook a um serviço como o Mailchimp ou HubSpot 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.

Como integrar um webhook de saída com o N8N

1. Criar um Fluxo de Trabalho:

• Abra o N8N e crie um novo fluxo de trabalho.
• Adicione um Webhook node, defina o método como POST e copie o URL do webhook.

2. Configurar o Webhook no iubenda:

• Na iubenda, aceda à secção Webhooks da Consent Database. (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, veja aqui ⬇️



• Crie um novo Webhook de saída, cole o URL do N8N e selecione a preferência que pretende rastrear.



• 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.

Avançado: O que fazer se um Webhook falhar

Por vezes, um webhook pode falhar devido a problemas com o servidor de destino. Quando tal acontece, a iubenda repete automaticamente o pedido até 10 vezes, do seguinte modo:

1. 2 minutos após a primeira falha.
2. Intervalos crescentes (5 minutos, 10 minutos, até 3 horas).
3. Após 10 tentativas falhadas, o webhook fica marcado como falhado, sendo 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 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:

{
"subject": {
"id": "9b05c70c5c78a31aeaf13f8f27c1f890",
"email": "subject@email.com"
},
"consent_preferences": {
"newsletter": "false"
},
"changes": {
"newsletter": "false"
}
}

• subject: O ID e o email do utilizador.
• consent_preferences: As preferências de consentimento atualizadas, como subscrever ou cancelar a subscrição de uma newsletter.
• changes: Quaisquer alterações ao registo de consentimento anterior.