📤 Webhooks de Saída¶
Webhooks de Saída são o caminho inverso dos Webhooks de Entrada: em vez de receber um aviso, o Atende Ágil avisa o seu sistema quando algo acontece dentro dele. Uma mensagem chegou, um atendimento foi fechado, um card mudou de etapa, e o seu sistema recebe isso na hora, sem precisar ficar perguntando. 🔔
🧠 Como funciona¶
- Vá em Configurações → Integrações e, no card Webhooks de Saída (Eventos), clique em Novo Webhook de Saída.
- Informe o endereço que vai receber os avisos (precisa ser
https). - Marque os eventos que você quer receber. Existe um botão Marcar/desmarcar todos.
- Se quiser, adicione cabeçalhos extras (por exemplo, um token de autenticação do seu sistema).
- Salve. O botão de teste dispara um evento de exemplo pro seu endereço, pra você conferir se chegou.
Cada aviso é um POST com o conteúdo completo do que aconteceu. O botão Ver payload, em cada evento, mostra exatamente o formato que vai chegar.
📋 Eventos disponíveis¶
| Grupo | Evento | Quando dispara |
|---|---|---|
| Mensagens | Mensagem criada | Toda mensagem nova, tanto a do contato quanto a enviada pela equipe, pela IA ou por automação |
| Atendimento | Atendimento aberto | Uma conversa foi aberta ou reaberta |
| Atendimento | Atendimento fechado | Uma conversa foi encerrada (traz motivo, responsável e duração) |
| Atendimento | Atendimento atribuído | Uma conversa ganhou ou perdeu responsável |
| Atendimento | Transbordo para humano | O contato pediu um humano ou a IA transferiu |
| Contatos | Contato criado | Um contato novo entrou na base |
| CRM | Contato movido de etapa | Um card mudou de etapa (traz de/para e quem moveu) |
| CRM | Negócio criado | Um card novo foi criado no funil |
| Agenda | Agendamento criado | Um compromisso novo foi marcado |
| Tarefas | Tarefa criada | Uma tarefa nova foi criada |
| Tarefas | Tarefa concluída | Uma tarefa foi concluída |
💬 Mensagem recebida e enviada são o mesmo evento
Existe um único evento de mensagem. O que muda é quem mandou (contato, atendente, IA ou automação) e a direção, ambos no payload. É assim pra você tratar todas as mensagens num lugar só.
🔒 Segurança¶
- Assinatura: cada envio leva o cabeçalho
X-Webhook-Signature, calculado com o segredo do webhook. Confira no seu sistema pra ter certeza de que o aviso veio do Atende Ágil. O segredo pode ser copiado ou trocado por um novo na própria tela. - Só
https: endereços semhttpsou que apontam pra rede interna são recusados. - Ligar e desligar: com o webhook desligado, os eventos deixam de ser enviados e nada fica em fila esperando.
🔎 Conferir o que foi enviado¶
Em Configurações → Logs existe o histórico dos Webhooks de Saída disparados, com evento, destino, status e tempo de cada tentativa. Ótimo pra descobrir por que um aviso não chegou.
🧭 Qual usar?
Quer que outro sistema te avise quando algo acontece aqui? Use Webhooks de Saída. Quer mandar algo pra cá? Use Webhooks de Entrada ou a API Pública.