Evento
POST voice/pbx/channel/dialComo 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:
{
"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.
