Chamadas

Consulta ao histórico de chamadas da conta. Este recurso é somente leitura — os registros são criados automaticamente pelo sistema durante o atendimento real (via Janus, Twilio ou WhatsApp), não pela API.

Endpoints

Método	Rota	Descrição
GET	/api/v1/calls	Lista chamadas
GET	/api/v1/calls/{call}	Exibe uma chamada

Filtros de listagem

Parâmetro	Descrição
status	received, answered, missed, failed ou completed.
date_start / date_end	Filtra pelo início da chamada (date_end deve ser igual ou posterior a date_start).
agent_id	Chamadas atendidas por um agente específico.
contact_id	Chamadas associadas a um contato.
sip_connection_id / whatsapp_connection_id	Chamadas de uma conexão específica.
search	Busca pelo número do chamador (caller_number).
per_page	Itens por página.

Exemplos com curl

Listar chamadas concluídas de um agente

curl "$ROUXINOL_URL/api/v1/calls?agent_id=12&status=completed" \
  -H "Authorization: Bearer $ROUXINOL_TOKEN"

Listar chamadas por período

curl "$ROUXINOL_URL/api/v1/calls?date_start=2026-08-01&date_end=2026-08-18" \
  -H "Authorization: Bearer $ROUXINOL_TOKEN"

Exibir o detalhe de uma chamada

curl "$ROUXINOL_URL/api/v1/calls/501" \
  -H "Authorization: Bearer $ROUXINOL_TOKEN"

Listagem (resumida)

Cada item da listagem traz um resumo, sem transcrição:

{
  "id": 501,
  "caller_number": "+5511988887777",
  "status": "completed",
  "status_label": "Concluída",
  "agent_id": 12,
  "contact_id": null,
  "sip_connection_id": 5,
  "whatsapp_connection_id": null,
  "duration_seconds": 184,
  "sentiment": "positive",
  "has_recording": true,
  "started_at": "2026-08-01T12:00:00Z",
  "ended_at": "2026-08-01T12:03:04Z"
}

Detalhe da chamada

GET /api/v1/calls/{call} traz os dados completos, incluindo transcrição e análise da conversa:

Campo	Descrição
transferred_from_call_id	Chamada de origem, se esta for resultado de uma transferência.
duration_formatted	Duração formatada (ex: 03:04).
recording_url	URL da gravação, quando disponível.
transcription	Transcrição completa em texto.
transcript_segments	Transcrição segmentada (por falante/trecho).
summary	Resumo da conversa gerado pela IA.
topics / keywords	Tópicos e palavras-chave identificados.
competitors_mentioned	Concorrentes citados durante a conversa.
main_interest	Principal interesse identificado do cliente.
sentiment_label	Rótulo do sentimento: feliz, positivo, neutro, negativo ou frustrado.