> For the complete documentation index, see [llms.txt](https://ereemby.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ereemby.gitbook.io/docs/desenvolvedores/webhooks/chat.md).

# Chat

Receba eventos de **chat/suporte** em tempo real via webhook.\
Use isso pra notificar atendentes, abrir tickets e automatizar respostas.

{% hint style="info" %}
Para configurar a URL do webhook e validar assinatura HMAC, veja: [Webhooks](/docs/desenvolvedores/webhooks.md).
{% endhint %}

{% hint style="success" %}
Tem um tutorial completo de automação (com exemplo em Node.js) em: [Bot de suporte](/docs/desenvolvedores/documentacao-api-publica/bot-de-suporte.md).
{% endhint %}

### Eventos disponíveis

* `chat_created`: disparado quando um chat é criado.
* `chat_message`: disparado quando chega uma nova mensagem no chat.

### Evento `chat_created`

Dispara quando um chat é criado.\
Normalmente acontece quando o cliente abre atendimento relacionado a um pedido.

Exemplos de uso:

* Notificar um canal de suporte no Discord/Telegram: “novo chat aberto”.
* Vincular `chat.id` ao `pedido` no seu CRM pra rastrear histórico.

{% openapi-webhook spec="Webhook-Chats" name="chat\_created" method="post" %}
[Webhook-Chats](https://4401d86825a13bf607936cc3a9f3897a.r2.cloudflarestorage.com/gitbook-x-prod-openapi/raw/9663df1721abd2b2a2ab05d9f80c3b6422c704e192e7ffd033069e966ef4b061.json?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=0cc7c3f440ca5fd44ab53362d4a69dfe%2F20261115%2Fauto%2Fs3%2Faws4_request\&X-Amz-Date=20261115T200711Z\&X-Amz-Expires=172800\&X-Amz-Signature=934b8f78a3920409c66f30149c8e423a4ec557f1b37acc9acf946f4cf2a33d68\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)
{% endopenapi-webhook %}

### Evento `chat_message`

Dispara quando chega uma mensagem no chat.

Exemplos de uso:

* Fazer “ponte” de atendimento:
  * cliente fala na Ereemby → você posta num canal privado do Discord.
  * atendente responde → seu bot responde no chat.
* Automatizar respostas por regras:
  * fora do horário → enviar mensagem de “suporte offline”.
  * palavra-chave (ex: “reembolso”) → notificar os atendentes da loja.

{% openapi-webhook spec="Webhook-Chats" name="chat\_message" method="post" %}
[Webhook-Chats](https://4401d86825a13bf607936cc3a9f3897a.r2.cloudflarestorage.com/gitbook-x-prod-openapi/raw/9663df1721abd2b2a2ab05d9f80c3b6422c704e192e7ffd033069e966ef4b061.json?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=0cc7c3f440ca5fd44ab53362d4a69dfe%2F20261115%2Fauto%2Fs3%2Faws4_request\&X-Amz-Date=20261115T200711Z\&X-Amz-Expires=172800\&X-Amz-Signature=934b8f78a3920409c66f30149c8e423a4ec557f1b37acc9acf946f4cf2a33d68\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)
{% endopenapi-webhook %}

### Dicas rápidas pra não dar dor de cabeça

* Valide `x-webhook-signature` antes de processar.
* Trate como “pelo menos uma vez”. Pode haver reenvio.
* Responda com `2xx` rápido e processe em background quando possível.
* Evite enviar email do cliente em canais públicos.