Skip to main content
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 pendiente
  • closed - Llamada completada exitosamente
  • rong-phone-forno-answer - Número equivocado o sin respuesta
  • wmat - Esperando acción manual
  • failed - Llamada fallida
  • recall-scheduled - Rellamada programada
  • voicemail - 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 from se 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 daysFromNow es 90 días