# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-05-27T06:59:03.800Z

## Página

- Título: Channel - Discagem
- URL humana: https://agilize.app/docs/desenvolvedores/webhooks/voice-pbx/channel/post-voice-pbx-channel-dial
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload.

## Seções

- Evento
- Como receber
- Payload
- Respostas
- Boas práticas

## Conteúdo da página

## Evento

```http
POST voice/pbx/channel/dial
```

## Como receber

Configure uma URL HTTPS pública para receber este evento e responda rapidamente com status de sucesso após aceitar o payload.

## Payload

- Content-Type: application/json

| Campo | Tipo | Obrigatório | Valores / Exemplo | Descrição |
| --- | --- | --- | --- | --- |
| channel | string | Sim | Exemplo: SIP/101_pabx9999999.ligou.me-00001234 | Identificador do canal da ligação |
| uniqueid | string | Sim | Exemplo: srv999-91234567.99 | Id da Chamada (Origem) |
| subevent | string | Não | Exemplo: Begin | Definição do sub-evento. |
| dialstatus | string | Não | Aceita: CHANUNAVAIL, CONGESTION, NOANSWER, BUSY, ANSWER, CANCEL · Exemplo: CANCEL | Status atual da chamada |
| calleridnum | string | Não | Exemplo: 101 | Número da Bina (Canal Origem) |
| calleridname | string | Não | Exemplo: Ramal João | Nome da Bina (Canal Origem) |
| connectedlinenum | string | Não | Exemplo: 03140637007 | Nome da Bina (Canal Conectado) |
| connectedlinename | string | Não | Exemplo: empty | Número da Bina (Canal Conectado) |
| pbx | string | Não | Exemplo: SIP/101_pabx9999999.ligou.me-00001234 | Identificador do canal da ligação |
| eventName | string | Não | Exemplo: voice/pbx/channel/dial | Nome completo do evento |
| eventType | string | Não | Aceita: custom, db · Exemplo: custom | Tipo de evento |
| project | string | Não | Exemplo: project | Identificador do projeto |
| verifyKey | string | Não |  | Chave de verificação da integração. |

Exemplo básico recebido:

```json
{
  "channel": "SIP/101_pabx9999999.ligou.me-00001234",
  "uniqueid": "srv999-91234567.99"
}
```

## Respostas

| Status | Descrição | Conteúdo |
| --- | --- | --- |
| 200 | Return a 200 status to indicate that the data was received successfully |  |

## Boas práticas

- Trate reenvios como possibilidade real.
- Valide o payload antes de executar regras de negócio.
- Registre o identificador do evento ou do registro recebido para auditoria.