Skip to main content
GET

Listar Chamadas

Recuperar uma lista de todas as chamadas para o ambiente autenticado com opções de filtragem por status, direção, agente e datas.

Endpoint

Cabeçalhos da requisição

string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here

Parâmetros de consulta

string
Filtrar por status da chamada. Opções: initiated, ringing, answered, completed, failed, busy, no-answer
string
Filtrar por direção da chamada. Opções: inbound, outbound
string
Filtrar por ID do agente
string
Filtrar chamadas a partir da data (YYYY-MM-DD)
string
Filtrar chamadas até a data (YYYY-MM-DD)
Pesquisar em números de telefone ou SID da chamada
integer
Número de itens por página (padrão: 20, máximo: 100)
integer
Número da página (padrão: 1)

Exemplos de Requisição

Resposta

Resposta de Sucesso (200 OK)

Campos da Resposta

boolean
obrigatório
Indica se a operação foi bem-sucedida.
array
obrigatório
Array de objetos de chamada.
object
obrigatório
Metadados de paginação.

Respostas de erro

401 Não Autorizado

422 Erro de Validação

500 Erro do Servidor

Códigos de erro

Notas Importantes

Suporte à paginação. Use parâmetros page e per_page para navegar pelos resultados.
Filtros de data. Use date_from e date_to para filtrar chamadas por período específico.
Filtros de status. Filtre por status para acompanhar o progresso das chamadas.
Chamadas de teste. Use is_testing para identificar chamadas de teste vs. produção.

Melhores Práticas

  1. Use paginação - Sempre use paginação para grandes conjuntos de dados
  2. Filtre por período - Use filtros de data para analisar chamadas em períodos específicos
  3. Monitore status - Filtre por status para acompanhar o progresso das chamadas
  4. Identifique testes - Use is_testing para separar chamadas de teste das de produção
  5. Filtre por agente - Use agent_id para analisar desempenho de agentes específicos

Endpoints relacionados

  • Obter Chamadas do Agente: GET /api/v1/agents/{agent_id}/calls
  • Fazer Chamada: POST /api/v1/calls
  • Fazer Chamada de Campanha: POST /api/v1/campaigns/{campaign_id}/call