SparkTG

Documentación de Informe CDR (v2)

Informe CDR (v2)

v2

Informe CDR (v2)

Registros de detalle de llamadas para un intervalo de tiempo

API v2v21 endpoint

Descripción general

Facturable: esta API se cobra según el número de registros devueltos. Contacte a su gestor de cuenta para conocer los detalles de precios. Devuelve los registros de detalle de llamadas del servicio y del intervalo de tiempo. Envíe un cuerpo JSON (Content-Type: application/json). start_time y end_time son obligatorios, como en todos los endpoints de informes; una solicitud sin ellos devuelve 400. svc_id es opcional y por defecto es el servicio del token; si lo envía, el usuario del token debe tener autorización para ese servicio; de lo contrario, la solicitud devuelve 403. El campo mode selecciona normal (predeterminado, una lista CDR estándar con totales) o extended (los mismos registros más los tiempos de IVR y de cola y los tiempos de espera). El cuerpo de la solicitud es idéntico en ambos modos. limit tiene un tope de 5000; si pide más, se reduce a 5000, así que use offset para recorrer conjuntos de resultados más grandes. Los parámetros desconocidos se ignoran.

Endpoints disponibles

POST/api/v2/reports/cdr

Parámetros clave

mode(String)

normal (predeterminado) o extended.

svc_id(Integer)

Servicio sobre el que se genera el informe. Por defecto, el servicio del token.

start_time(Integer (epoch ms))

Inicio del intervalo.

end_time(Integer (epoch ms))

Fin del intervalo (exclusivo respecto a la hora de inicio de la llamada).

offset(Integer)

Desplazamiento de paginación (igual en ambos modos). Por defecto 0.

limit(Integer)

Tamaño de página. Por defecto 30. Máximo 5000; los valores mayores se reducen al máximo.

Escenarios de uso

Modo normal

El predeterminado. ring_start_time, start_time y end_time se devuelven como cadenas yyyy-MM-ddTHH:mm:ss en IST.

0 parámetrosDisponible en Ejemplos

Modo extendido

Establezca mode en extended. La envoltura y todos los campos del modo normal no cambian; además, cada registro incluye agent_answered, ivr_in_time, ivr_out_time, ivr_duration, queue_in_time, queue_out_time, queue_duration y total_wait_duration.

0 parámetrosDisponible en Ejemplos

Ejemplo rápido

Prueba esta API con un sencillo comando cURL

Llamada básica a la API
curl -X POST 'https://telephonycloud.co.in/api/v2/reports/cdr' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"svc_id": 3, "start_time": 1775759400000, "end_time": 1776364200000, "offset": 0, "limit": 30, "call_type": "OUTBOUND", "disposition": "ANSWER"}'
💡 Sustituye <YOUR_TOKEN> por tu token de API

Vista previa de la respuesta

Respuesta de ejemplo de esta API

Respuesta de ejemplo
{"count":268,"data":[{"call_transaction_id":"d341e47a-767a-44fb-8d79-9bf38f4caa28","svc_id":3,"call_type":"OUTBOUND","customer_number":"9634780846","agent_number":"10101","disposition":"Answer","durat...
Consulta el formato completo de la respuesta en la sección Respuesta