Chamadas e Campanhas
Listar Chamadas
Recuperar uma lista de todas as chamadas para o ambiente autenticado
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_hereParâmetros de consulta
string
Filtrar por status da chamada. Opções:
initiated, ringing, answered, completed, failed, busy, no-answerstring
Filtrar por direção da chamada. Opções:
inbound, outboundstring
Filtrar por ID do agente
string
Filtrar chamadas a partir da data (YYYY-MM-DD)
string
Filtrar chamadas até a data (YYYY-MM-DD)
string
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
- Use paginação - Sempre use paginação para grandes conjuntos de dados
- Filtre por período - Use filtros de data para analisar chamadas em períodos específicos
- Monitore status - Filtre por status para acompanhar o progresso das chamadas
- Identifique testes - Use
is_testingpara separar chamadas de teste das de produção - Filtre por agente - Use
agent_idpara 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