fbpx
Search
Close this search box.
Search
Close this search box.

< / >

APIs Customer

3. Reporte de CDR de llamadas

URL:

https://wv{{wolkvox_server}}.wolkvox.com/api/v2/customer.php?api=cdr_calls&date_ini={{YYYYmmddHHiiss}}&date_end={{YYYYmmddHHiiss}}

Descripción:

Este reporte entrega una visión completa de los detalles de la interacción, especificando los datos de llamada como ID, tipo, duración, tipificación, teléfono y fecha exacta (día de la semana, mes, hora); además indica el agente que atendió la interacción, los indicadores de desempeño, los servicios asociados a la operación como grabación de pantalla y el costo total de la llamada.

Beneficio:

Este reporte permite hacer seguimiento a los detalles de la llamada y a la contabilidad al indicar el valor del consumo de servicios de voz.

Cómo funciona:

  • El consumo de esta API se realiza por método GET.
  • Para consumir esta API debe reemplazar en la url {{wolkvox_server}} por la nomenclatura del servidor de la operación.
  • Se debe hacer uso del header wolkvox-token: {{token}} para hacer uso de el token de autorización.
  • Tenga en cuenta que un mismo token no puede ser consumidos de manera simultanea, por lo cual puede programar que la siguiente API sea consumida cuando el resultado de la anterior sea exitoso.
  • En términos de tiempo, para hacer seguimiento a su operación puede hacer un consumo cada 5 minutos de la información.

REQUEST

NAME DESCRIPTION TYPE
api API requerida. String
date_ini Fecha Inicial (YYYYmmddHHiiss). String
date_end Fecha Final (YYYYmmddHHiiss). String

RESPONSE

NAME DESCRIPTION TYPE
conn_id Corresponde al número de identificación de la llamada. String
type_call Es el tipo de llamada (inbound, outbound e internal). String
talk_time Indica la duración expresada en unidad de tiempo de segundos. String
agent_id Número de extensión del agente. String
agent_name Nombre del agente. String
agent_dni Se refiere al documento de identidad de cada uno de los usuarios de wolkvox Agent. String
skill_id Es la identificación numérica de la skill. String
date Indica la fecha con formato año-mes -día -hora. String
hour Indica en formato de hora militar. String
day_of_week Indica el día de la semana. String
cod_act Es el ID del código de tipificación o codificación usado por el agente. Puede arrojar el valor “TIMEOUTACW” si en la operación está activa la temporización del proceso de tipificación y el agente dejó pasar el tiempo límite para tipificar la interacción. String
description_cod_act Indica la descripción del código de tipificación. String
cod_act_2 Es el ID del código de tipificación o codificación usado por el agente para una tarea específica. Puede arrojar el valor “TIMEOUTACW” si en la operación está activa la temporización del proceso de tipificación y el agente dejó pasar el tiempo límite para tipificar la interacción. String
description_cod_act_2 Indica la descripción del código de tipificación. String
hit Indicador de desempeño del agente que indica logro o venta exitosa. String
telephone_destination Indica el destino número telefónico al que se realizó la llamada. String
telephone_costs Indica el costo por el uso de la telefonía. String
telephone Indica el número telefónico al que se realizó la llamada. String
hang_up Muestra quién colgó la llamada, si fue el agente (agent) o el cliente (customer). String
customer_id Corresponde al número de identificación del cliente. String
month Indica en número el mes de la interacción. String
screen_recording Indica si la interacción usó la funcionalidad de grabación de pantalla (yes) o no (no). String
operation Indica el nombre de la operación. String
ring Indica el tiempo transcurrido desde que la llamada es marcada hasta que es respondida. String
abandon Es el resultado de las llamadas inbound colgadas por parte del cliente antes de la atención del asesor. String

Posibles códigos de respuesta
				
					$curl = curl_init();
 
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/customer.php?api=cdr_calls&date_ini={{YYYYmmddHHiiss}}&date_end={{YYYYmmddHHiiss}}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'wolkvox-token: {{token}}'
  ),
));
 
$response = curl_exec($curl);
 
curl_close($curl);
echo $response;
				
			

RESPONSE

				
					{
    "code": 200,
    "error": null,
    "msg": "1 records were found",
    "data": [
        {
            "conn_id": "",
            "type_call": "",
            "talk_time": "",
            "agent_id": "",
            "agent_name": "",
            "agent_dni": "",
            "skill_id": "",
            "date": "",
            "hour": "",
            "day_of_week": "",
            "cod_act": "",
            "description_cod_act": "",
            "cod_act_2": "",
            "description_cod_act_2": "",
            "hit": "no",
            "telephone_destination": "",
            "telephone_costs": "",
            "telephone": "",
            "hang_up": "",
            "customer_id": "",
            "month": "",
            "screen_recording": "",
            "operation": "microdllo",
            "ring": "--",
            "abandon": "--"
        }
    ]
} 

				
			

Hacemos uso de cookies, si continúas navegando asumiremos que estás de acuerdo. Puede leer más sobre el uso de cookies en nuestras políticas de privacidad y tratamiento de datos personales

Hacemos uso de cookies, si continúas navegando asumiremos que estás de acuerdo. Puede leer más sobre el uso de cookies en nuestras políticas de privacidad y tratamiento de datos personales