Configurar webhooks para sistemas externos

Um webhook faz o AtendeBot avisar um sistema externo toda vez que algo acontece — uma mensagem recebida, um atendimento concluído, um card movido de etapa. Você informa uma URL e escolhe os eventos, e o AtendeBot envia os dados para lá automaticamente.

Objetivo

Cadastrar um webhook para que sistemas externos recebam notificações de eventos da sua conta.

Pré-requisitos

Perfil Administrador.
Uma URL pública pronta para receber os dados (ex.: um fluxo no n8n, Zapier ou um endpoint do seu sistema).

Tempo estimado

5 minutos.

Caminho de acesso

Ajustes → Integrações → Webhooks

Passo a passo

Abra Ajustes → Integrações e fique na sub-aba Webhooks.

🖼️ PRINT — Sub-aba Webhooks selecionada, com o botão Novo destacado.
Clique em Novo.
Em Nome, dê um nome ao webhook (ex.: Notificação N8N).
Em URL, cole o endereço que vai receber as notificações (começando com https://).
Em Status, deixe em Ativo para começar a enviar imediatamente (ou Inativo para deixar pronto e ligar depois).
Em Eventos, marque quais acontecimentos disparam o envio. Eles estão agrupados:
- Atendimentos: Atendimento criado, Atendimento alterado, Atendimento concluído.
- Mensagens: Mensagem recebida, Mensagem enviada, Mensagem atualizada.
- Contatos: Contato criado, Contato alterado, Etiqueta alterada.
- Cards: Card criado, Card alterado, Card movido de etapa, Anotação criada, Anotação alterada.
🖼️ PRINT — Diálogo Novo Webhook com os campos Nome, URL, Status e a lista de Eventos por grupo.
Clique em Criar.

Resultado esperado

O webhook aparece na lista com o nome, a marca ATIVO, a URL e as etiquetas dos eventos escolhidos. A partir daí, cada evento marcado envia uma notificação para a sua URL. Para ajustar depois, clique no ícone de lápis e altere; para desligar sem apagar, mude o Status para Inativo.

Erros comuns

Sintoma: o botão Criar fica desabilitado. Solução: preencha Nome e URL e marque pelo menos um evento — todos os três são obrigatórios.
Sintoma: o sistema externo não recebe nada. Solução: confira se o webhook está ATIVO, se a URL está correta e acessível publicamente, e se os eventos certos foram marcados. O histórico de disparos fica em Ajustes → Auditoria.