Webhooks
🌐 O que é um Webhook?
Um Webhook é uma forma de o NextChat avisar outro sistema automaticamente (em tempo real) sempre que algo acontece: uma mensagem recebida, um ticket aberto, um ticket transferido, um ticket fechado, etc.
- 👉 Você não precisa ficar consultando o NextChat o tempo todo.
- 👉 O NextChat envia uma requisição
POST(com os dados em formatoJSON) para a URL que você configurar, toda vez que um evento selecionado acontecer.
Resumo simples:
| Tipo | Função principal | Exemplo de uso |
|---|---|---|
| WebHook | O NextChat envia informações para você em tempo real | Ser notificado sobre novas mensagens ou alterações no atendimento |
| API | Você envia informações para o NextChat | Enviar mensagens, atualizar contatos, mudar status de ticket |
📍 Onde configurar
No NextChat, todo o Webhook (e o N8N) é configurado em um único lugar:
Automação e Integrações → Webhooks/N8N
A tela possui duas abas:
- Integrações por Canal — o webhook vale para todos os atendimentos de um canal (ex.: um WhatsApp conectado).
- Integrações por Fila — o webhook vale apenas para os atendimentos de uma fila (integrações do tipo N8N, vinculadas a uma fila).
🔐 A página fica disponível para perfis Admin e Supervisor e depende do recurso Webhooks estar liberado no seu plano.
🚀 Como começar (resumo)
Pelo Canal (mais simples):
- Abra a aba Integrações por Canal.
- Clique em Configurar no canal desejado.
- Ative Integração Ativada.
- Informe a URL que receberá os eventos.
- Marque os Eventos desejados.
- (Opcional) Informe o Bearer Token / API Key em Mostrar configurações avançadas.
- Clique em Testar integração e depois em Salvar.
Pela Fila (N8N):
- Abra a aba Integrações por Fila.
- Clique em Nova Integração N8N, dê um nome, informe a URL e marque os Eventos.
- Salve e clique no botão de foguete para vincular a fila (o assistente cria/víncula a fila e libera a integração).
- Pronto: os atendimentos que caírem nessa fila passam a enviar eventos para a URL.
📚 Páginas desta seção
- Webhook e N8N — guia completo: como criar, configurar, testar e entender cada opção da tela.
- Webhook de Canal — formato exato dos dados enviados pelos eventos de canal.
- Webhook de Integrações — formato exato dos dados enviados pelas integrações de fila.
- Instalação N8N — como instalar o N8N na mesma VPS do NextChat.