# 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
1. Abra **Ajustes → Integrações** e fique na sub-aba **Webhooks**.

   <p class="callout info">🖼️ <strong>PRINT</strong> — Sub-aba <strong>Webhooks</strong> selecionada, com o botão <strong>Novo</strong> destacado.</p>

2. Clique em **Novo**.
3. Em **Nome**, dê um nome ao webhook (ex.: `Notificação N8N`).
4. Em **URL**, cole o endereço que vai receber as notificações (começando com `https://`).
5. Em **Status**, deixe em **Ativo** para começar a enviar imediatamente (ou **Inativo** para deixar pronto e ligar depois).
6. 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.

   <p class="callout info">🖼️ <strong>PRINT</strong> — Diálogo <strong>Novo Webhook</strong> com os campos <strong>Nome</strong>, <strong>URL</strong>, <strong>Status</strong> e a lista de <strong>Eventos</strong> por grupo.</p>

7. 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**.

## Artigos relacionados
- [Gerar tokens de API para integrações](/books/canais-e-integracoes/page/gerar-tokens-de-api-para-integracoes)
- [Criar sua primeira automação](/books/automacoes/page/criar-sua-primeira-automacao)
- [Concluir e classificar um atendimento](/books/atendimentos/page/concluir-e-classificar-um-atendimento)