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

# Webhook de Ligações

Os webhooks `CALL_RECEIVED` e `CALL_ROUTING` são disparados quando uma ligação começa a tocar na integração.

* `CALL_RECEIVED` apenas avisa da ligação: ela continua tocando para os atendentes.
* `CALL_ROUTING` (somente HyperMeow com ligações) encaminha a ligação para a sua aplicação: ela **não aparece para os atendentes** e deve ser tratada pela [API de ligações](https://docs.multchats.com/api-reference/call/introduction.md).

## Payload do Webhook

Os dois tipos enviam o mesmo payload:

```json theme={null}
{
  "type": "CALL_ROUTING",
  "integrationId": "cm5abc123def456",
  "chat": {
    "id": "cm5xyz789ghi012",
    "name": "João Silva",
    "chatId": "5511999998888@c.us",
    "picture": "https://example.com/photo.jpg",
    "type": "individual",
    "sectorId": "cm5sector123",
    "status": "open",
    "attendantId": null,
    "lastMessageId": "cm5msg789",
    "lastMessageAt": "2024-01-15T10:30:00.000Z",
    "createdAt": "2024-01-10T08:00:00.000Z"
  },
  "call": {
    "callId": "8A1F3C2B9D4E5F60",
    "direction": "inbound",
    "from": "5511999998888",
    "contactName": "João Silva",
    "receivedAt": "2024-01-15T10:30:00.000Z"
  }
}
```

| Campo | Descrição |
| - | - |
| `chat` | A conversa do contato, ou `null` quando ele ainda não tem conversa |
| `call.callId` | ID da ligação, usado nas rotas de `/call` e no WebSocket de áudio |
| `call.from` | Número de quem está ligando (ou o ID do WhatsApp quando não há número) |
| `call.contactName` | Nome do contato, quando conhecido |
| `call.receivedAt` | Quando a ligação começou a tocar |

## Áudio de espera

No cadastro do webhook `CALL_ROUTING` você pode informar um `holdAudioUrl`: um arquivo de áudio (mp3, wav, ogg...) que toca em loop para o contato enquanto uma ligação transferida para a fila espera um atendente. Sem ele, o contato fica em silêncio.

O arquivo é baixado e validado no cadastro (até 20 MB; são usados os primeiros 5 minutos). Se não puder ser lido, o cadastro é recusado com `HOLD_AUDIO_INVALID`.


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