Configurar webhooks

Envie eventos como novos leads ou marcações de forma automática e assinada para os seus próprios sistemas.

Última verificação: 2026-10-20

Com os webhooks de saída, a Zentor App informa imediatamente os seus sistemas quando algo acontece – por exemplo: com o módulo de automatização, envia novos leads para o seu CRM por webhook. Cria os webhooks sozinho na área «Automatização», separador «Webhooks». Cada entrega é assinada com HMAC-SHA256 através da sua chave secreta e as entregas falhadas são repetidas automaticamente. Os webhooks fazem parte do módulo adicional «Automatizações/n8n».

Passo a passo

  1. Abrir o separador «Webhooks»Abra «Automatização» na barra lateral e selecione o separador «Webhooks».
  2. Criar um webhookEm «Os seus webhooks», introduza um nome e o endereço HTTPS do seu sistema e selecione os eventos, por exemplo «Lead criado», «Marcação criada», «Marcação cancelada», «Formulário enviado», «Ticket criado», «Estado do ticket alterado» ou «Mensagem recebida». Clique em «Criar webhook».
  3. Guardar a chave de assinaturaApós a criação, a sua chave de assinatura é apresentada uma única vez. Guarde-a em segurança – o seu sistema utiliza-a para verificar a assinatura HMAC de cada entrega. Se necessário, gere uma nova com «Renovar chave».
  4. Fazer um envio de testeCom «Enviar teste», envia uma entrega de teste para o seu endereço e verifica assim se o seu sistema a aceita.
  5. Verificar as entregasEm «Entregas», vê cada entrega com o evento, o estado, o número de tentativas e a próxima tentativa prevista.
  6. Repetir execuções de workflow falhadasA Zentor App repete automaticamente as entregas de webhooks. Se, em vez disso, enviar dados através de um workflow com a ação «Enviar pedido HTTP», reinicie sozinho as execuções falhadas no separador «Execuções» com «Repetir».

Resultado esperado

O seu sistema recebe automaticamente os eventos escolhidos, verifica a sua origem através da assinatura e cada entrega fica rastreável no registo.

Casos de erro frequentes

O separador «Webhooks» não aparece.

Causa: O módulo adicional «Automatizações/n8n» não está contratado para a sua conta.

Solução: Contacte a Zentor; receberá uma proposta para o módulo.

A entrega de teste falha.

Causa: O seu endereço não está acessível, não utiliza um HTTPS válido ou o seu sistema responde com um erro.

Solução: Verifique o endereço e o certificado do seu sistema e certifique-se de que aceita pedidos externos. Depois, envie o teste novamente.

O meu sistema rejeita entregas devido a uma assinatura inválida.

Causa: O seu sistema utiliza uma chave de assinatura errada ou desatualizada.

Solução: Gere uma nova chave com «Renovar chave» e registe-a no seu sistema.

Artigos relacionados

← Voltar à categoria