> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blu.direct/llms.txt
> Use this file to discover all available pages before exploring further.

# Envie dados do agente para o seu sistema

> Faça o agente de IA avisar seu CRM, planilha ou automação quando algo acontecer na conversa.

Com os webhooks do agente, o [agente de IA](https://docs.blu.direct/atendimento/agentes-ia.md) envia uma notificação para uma URL sua quando uma condição acontece na conversa, por exemplo quando o cliente confirma um pedido ou pede um orçamento. Use para registrar o lead no seu CRM, criar uma linha em uma planilha ou disparar uma automação no Zapier, Make ou n8n.

Você descreve em texto quando o webhook deve ser chamado, e o agente decide o momento durante a conversa.

> [!NOTE]
>
> Webhooks e as demais integrações são exclusivos de agentes de nível
> **Enterprise**. Se a sua assinatura tem um agente Enterprise, [mude o
> nível](https://docs.blu.direct/atendimento/ajustar-agente.md#nivel-do-agente) do agente. Se não, [fale
> com a equipe do
> blü](https://wa.me/559186130008?text=Ol%C3%A1!%20Gostaria%20de%20saber%20mais%20sobre%20o%20complemento%20Agente%20Enterprise%20para%20integra%C3%A7%C3%B5es.)
> para contratar um.

## Configure um webhook

**1. Abra as integrações do agente**

Em **Agentes I.A.**, abra o agente e clique na aba **Integrações**.

**2. Ative a integração**

No card **Webhook**, ative a chave e clique em **Configurar**.

**3. Adicione o webhook**

Clique em **Adicionar webhook** e preencha:

* **Nome**: identifica o webhook para você, por exemplo “Encaminhar para CRM”.
* **URL (https\://)**: o endereço que vai receber a notificação. Precisa começar com `https://`.
* **Instruções (quando chamar)**: quando o agente deve chamar o webhook, por exemplo “Chame quando o cliente confirmar um pedido”.
* **Cabeçalhos HTTP (opcional)**: clique em **Adicionar cabeçalho** para enviar, por exemplo, uma chave de acesso exigida pelo seu sistema.

**4. Salve**

Clique em **Salvar**. A chave ao lado do nome liga e desliga cada webhook sem apagá-lo.

Cada agente pode ter até 10 webhooks ativos.

## Escreva boas instruções

O agente decide quando chamar o webhook a partir do texto em **Instruções (quando chamar)**. Descreva uma situação concreta e o que precisa ter acontecido antes:

* “Chame quando o cliente confirmar o pedido e informar o endereço de entrega.”
* “Chame quando o cliente pedir para falar com um vendedor.”
* “Chame depois que o cliente informar nome, e-mail e o produto de interesse.”

Evite instruções vagas, como “chame quando for importante”. Se precisar de dados específicos no seu sistema, peça nas [instruções do agente](https://docs.blu.direct/atendimento/instrucoes.md) que ele colete essas informações antes.

## O que o seu sistema recebe

O blü faz um `POST` para a URL com um corpo JSON:

```json theme={null}
{
  "chatNumber": "5511999999999",
  "contactName": "Maria",
  "lastMessage": "Pode confirmar, quero 2 unidades",
  "context": "Cliente confirmou pedido de 2 unidades do produto X, entrega na Rua das Flores, 123."
}
```

| Campo | Conteúdo |
| - | - |
| `chatNumber` | Telefone do contato, com DDI e DDD. |
| `contactName` | Nome do contato no WhatsApp, quando disponível. |
| `lastMessage` | Texto da última mensagem do contato. |
| `context` | Resumo escrito pelo agente sobre o motivo da chamada e os dados relevantes. |

Os cabeçalhos que você cadastrou são enviados junto, além de `Content-Type: application/json`.

Seu sistema deve responder em até 8 segundos. O agente só vê se a chamada deu certo ou não; o conteúdo da resposta não chega a ele nem ao cliente.

## Limites e cuidados

* A URL precisa usar `https://` e ser acessível pela internet. Endereços locais ou de rede interna, como `localhost` ou `192.168.x.x`, são ignorados.
* O agente pode chamar o mesmo webhook mais de uma vez na mesma conversa se a situação se repetir. Trate duplicidades no seu sistema, por exemplo pelo `chatNumber`.
* A [simulação](https://docs.blu.direct/atendimento/ajustar-agente.md#simule-uma-conversa) não chama webhooks. Para testar, use um número conectado e uma URL de teste, como a de um serviço de inspeção de requisições.
* Não coloque senhas ou chaves nas instruções; use os **Cabeçalhos HTTP**.

Para enviar mensagens pelo WhatsApp a partir do seu sistema, o caminho é o inverso: veja [enviar mensagens por webhook](https://docs.blu.direct/integracoes/enviar-por-webhook.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.