Skip to main content
POST

Encerrar Chamada

Desliga uma chamada ativa realizada por um agente específico. Use isto para paradas de emergência, cancelamentos solicitados pelo usuário ou para impor lógica de timeout customizada a partir da sua aplicação.

Endpoint

Parâmetros de caminho

string
obrigatório
UUID do agente que possui a chamada.

Cabeçalhos da requisição

string
obrigatório
Token Bearer. Formato: Bearer talq_your_environment_token_here
string
obrigatório
Deve ser definido como application/json

Corpo da requisição

string
obrigatório
Identificador da chamada a desligar. Use o id retornado por Realizar uma Chamada.

Exemplos

Resposta

Respostas de erro

404 — Chamada Não Encontrada

409 — Chamada Já Encerrada

Observações

  • A propagação do hangup é assíncrona. O status da chamada muda para completed logo após este endpoint retornar.
  • O ended_reason será ended_by_api para diferenciar de hangups naturais.
  • Eventos de webhook event_phone_call_ended serão disparados normalmente.