Listar Llamadas
Endpoints
Listar Llamadas
Recupera una lista de llamadas con opciones de filtrado
GET
Listar Llamadas
Descripción General
Este endpoint recupera una lista de llamadas asociadas con los asistentes del usuario autenticado. Puedes filtrar llamadas por rango de fechas, estado y playbook.Autenticación
Este endpoint requiere autenticación usando un token Bearer en el header Authorization.Parámetros de Query
string
Fecha de inicio para filtrar llamadas. Formato:
YYYY-MM-DD o YYYY-MM-DD HH:mm:ssSi no se proporciona, se calculará basándose en el parámetro daysFromNow.string
Fecha de fin para filtrar llamadas. Formato:
YYYY-MM-DD o YYYY-MM-DD HH:mm:ssSi no se proporciona, será por defecto la fecha/hora actual.number
predeterminado:"15"
Número de días hacia atrás desde hoy. Solo se usa si
startDate y endDate no se proporcionan.- Mínimo: 1
- Máximo: 90
- Por defecto: 15
string
Filtrar llamadas por estado. Valores válidos:
open- Llamada en progreso o pendienteclosed- Llamada completada exitosamenterong-phone-forno-answer- Número equivocado o sin respuestawmat- Esperando acción manualfailed- Llamada fallidarecall-scheduled- Rellamada programadavoicemail- Llamada fue al buzón de voz
string
Filtrar llamadas por un ID de playbook (asistente) específico. Debe ser un UUID válido.
Respuesta
array
Array de objetos de llamada, ordenados por
created_time descendente (más recientes primero).Ejemplos de Peticiones
Obtener llamadas de los últimos 30 días
Obtener llamadas en un rango de fechas específico
Obtener solo llamadas cerradas
Obtener llamadas para un playbook específico
Combinar filtros
Ejemplo de Respuesta
Respuestas de Error
Notas
- Todas las fechas se manejan en zona horaria Europe/Madrid y se convierten a UTC en la respuesta
- El campo
fromse sanitiza automáticamente para eliminar entradas inválidas - Las transcripciones están formateadas con etiquetas HTML para mejor legibilidad
- El endpoint filtra automáticamente las llamadas para mostrar solo las pertenecientes a asistentes del usuario autenticado
- El rango máximo de fechas usando
daysFromNowes 90 días

