Webhooks e N8N

Um webhook é um aviso automático que o Zontalk envia a outro sistema sempre que algo acontece: chegou uma mensagem, um ticket foi criado ou fechado. Com ele, você alimenta planilhas, ERPs, CRMs e automações no N8N, sem ninguém digitar.

Abra Configurações → Automação e Integrações → Webhooks/N8N. É o lugar único para configurar webhooks e N8N, por canal ou por fila.

A tela tem cinco abas:

• Integrações por canal: o webhook vale para todos os atendimentos do canal.
• Integrações por fila: vale para os atendimentos de uma fila.
• Webhook da Agenda.
• Webhook do Kanban.
• Webhook do Kanban Pro.

Cada linha mostra o nome, o status (Inativo ou ativo), o tipo de canal e o botão Configurar.

Configurar um webhook

1. Escolha a aba e clique em Configurar no canal ou na fila.
2. Ligue Integração ativada.
3. Em URL do Webhook/N8N, cole o endereço que vai receber os eventos.
4. Marque os eventos que deseja enviar:
   • mensagem recebida;
   • mensagem enviada;
   • novo ticket;
   • ticket transferido;
   • ticket fechado;
   • ticket em atendimento;
   • ticket pendente;
   • mensagens de grupo.
5. Se o sistema de destino precisar, marque Enviar mídia em base64. Em Mostrar configurações avançadas, há mais opções.
6. Use Testar integração para enviar um evento de teste.
7. Clique em Salvar.

Dicas

• Marque só os eventos de que você precisa. Enviar tudo gera tráfego e ruído.
• O endereço de destino precisa estar acessível pela internet e responder rápido.
• Proteja o endereço: quem tiver a URL pode enviar dados ao seu sistema. Use um endereço difícil de adivinhar ou uma chave.
• No N8N, crie um fluxo que começa em um nó Webhook e cole aqui a URL que ele gerar.

Para consultar ou enviar dados ao Zontalk, use a API.