Llamadas
Listar llamadas
Devuelve las llamadas a las que tu API Key tiene acceso, de la más reciente a la más antigua. Una clave con alcance Todos los agentes devuelve las llamadas de todos los agentes de tu empresa; una clave con alcance Agentes específicos devuelve únicamente las llamadas atendidas por los agentes vinculados a esa clave.
Autenticación
AuthorizationBearerAutentica las solicitudes desde tu servidor con una API Key de Fonema. Créala en la sección de API Keys del Dashboard y envíala en el encabezado Authorization como Bearer <token>. No pongas tus claves en código del navegador ni en repositorios públicos.
Parámetros de consulta
pageintegerOpcionalPor defecto 1Número de página a obtener (empezando en 1). Valores menores a 1 se ajustan a 1.
limitintegerOpcionalPor defecto 20Cantidad de llamadas por página. Máximo 100.
agentstringOpcionalDevuelve solo las llamadas atendidas por el agente con este slug. Devuelve 404 si el slug no existe o esta clave no tiene acceso.
startDatestringOpcionalDevuelve solo las llamadas creadas en esta fecha o después (ISO 8601, p. ej. 2026-08-01). Debe enviarse junto con endDate.
endDatestringOpcionalDevuelve solo las llamadas creadas en esta fecha o antes (ISO 8601). Debe enviarse junto con startDate.
Respuesta
totalintegerlimitintegeroffsetintegercurrentPageintegertotalPagesintegercallsarraycalls[].uidstringIdentificador único de la llamada. Úsalo en Consultar llamada.
calls[].agentobjectname y slug).calls[].toNumberstringcalls[].endedReasonstringcustomer-ended-call, voicemail).calls[].createdAtstringcalls[].startAtstring | nullnull si nunca se conectó.calls[].endAtstring | nullcalls[].durationSecondsinteger0 si nunca se conectó.calls[].successEvaluationbooleancalls[].inputDataobjectLas variables enviadas al crear la llamada (p. ej. vía Iniciar una llamada).
Usa el uid que se devuelve aquí como identificador en las solicitudes de Consultar llamada.
Errores
404slug de agent no existe o esta API Key no tiene acceso a él.