Códigos de Status de Chamada

Esta seção descreve os principais códigos de status que podem ser retornados no campo hangup_cause das chamadas. Esses códigos indicam o motivo pelo qual uma chamada foi encerrada.

Códigos Principais

Código	Descrição
NORMAL_CLEARING	Atendida
USER_BUSY	Ocupado
UNALLOCATED_NUMBER	Número não encontrado
NUMBER_CHANGED	Caixa postal
ORIGINATOR_CANCEL	Cancelamento da ligação
ALLOTTED_TIMEOUT	Tempo expirado

Uso na API

Quando você consulta as chamadas através da API, o campo hangup_cause conterá um dos códigos listados acima, permitindo que você identifique o motivo específico do término da chamada.

{
  "id": "3b46c0c6-5acc-4dfb-9ceb-14e37f1d3040",
  "hangup_cause": "NORMAL_CLEARING",
  "duration": 60,
  "started_at": "2025-01-01T00:00:00.000Z",
  "ended_at": "2025-01-01T00:01:00.000Z"
}

Referências

Para mais informações sobre todos os códigos de status possíveis, consulte a documentação oficial do FreeSWITCH.