Saltar al contenido principal

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​

AuthorizationBearer

Autentica 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 1

Número de página a obtener (empezando en 1). Valores menores a 1 se ajustan a 1.

limitintegerOpcionalPor defecto 20

Cantidad de llamadas por página. Máximo 100.

agentstringOpcional

Devuelve solo las llamadas atendidas por el agente con este slug. Devuelve 404 si el slug no existe o esta clave no tiene acceso.

startDatestringOpcional

Devuelve solo las llamadas creadas en esta fecha o después (ISO 8601, p. ej. 2026-08-01). Debe enviarse junto con endDate.

endDatestringOpcional

Devuelve solo las llamadas creadas en esta fecha o antes (ISO 8601). Debe enviarse junto con startDate.

Respuesta​

totalinteger
Número total de llamadas que coinciden con la consulta.
limitinteger
Tamaño de página usado en esta respuesta.
offsetinteger
Cantidad de llamadas omitidas antes de esta página.
currentPageinteger
Página devuelta.
totalPagesinteger
Número total de páginas disponibles.
callsarray
Lista de llamadas, de la más reciente a la más antigua.
calls[].uidstring

Identificador único de la llamada. Úsalo en Consultar llamada.

calls[].agentobject
El agente que atendió la llamada (name y slug).
calls[].toNumberstring
Número telefónico al que se llamó, en formato E.164.
calls[].endedReasonstring
Motivo por el que terminó la llamada (p. ej. customer-ended-call, voicemail).
calls[].createdAtstring
Cuándo se creó la llamada (se encoló).
calls[].startAtstring | null
Cuándo se contestó la llamada. null si nunca se conectó.
calls[].endAtstring | null
Cuándo terminó la llamada.
calls[].durationSecondsinteger
Duración de la llamada en segundos. 0 si nunca se conectó.
calls[].successEvaluationboolean
Si la llamada cumplió los criterios de éxito del agente.
calls[].inputDataobject

Las variables enviadas al crear la llamada (p. ej. vía Iniciar una llamada).

tip

Usa el uid que se devuelve aquí como identificador en las solicitudes de Consultar llamada.

Errores​

404
El slug de agent no existe o esta API Key no tiene acceso a él.