fbpx

< / >

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 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
NAMEDESCRIPTIONTYPE
apiAPI requeridaString
date_iniFecha Inicial (YYYYmmddHHiiss)String
date_endFecha Final (YYYYmmddHHiiss)String
RESPONSE
NAMEDESCRIPTIONTYPE
conn_idString
type_callEs el tipo de llamada (inbound, outbound e internal)String
talk_timeIndica la duración expresada en unidad de tiempo de segundosString
agent_idSe refiere a la identificación numerica de cada uno de los usuarios de wolkvox AgenteString
agent_nameNombre del agenteString
agent_dniSe refiere al documento de identidad de cada uno de los usuarios de wolkvox AgenteString
skill_idEs la identificación numérica de la skillString
dateIndica la fecha con formato año-mes -día -horaString
hourIndica en formato de hora militarString
day_of_weekIndica el día de la semanaString
cod_actEs el ID del código de tipificación o codificación usado por el agenteString
description_cod_actIndica la descripción del código de tipificaciónString
cod_act_2Es el ID del código de tipificación o codificación usado por el agente para una tarea específicaString
description_cod_act_2Indica la descripción del código de tipificaciónString
hitIndicador de desempeño del agente que indica logro o venta exitosa.String
telephone_destinationIndica el destino número telefónico al que se realizó la llamadaString
telephone_costsIndica el costo por el uso de la telefoníaString
telephoneIndica el número teléfonico al que se realizó la llamadaString
hang_upIndica quien finalizó la interacciónString
customer_idCorresponde al número de identificación del clienteString
monthIndica en número el mes de la interacciónString
screen_recordingIndica si la interacción usó la funcionalidad de grabación de pantallaString
operationIndica el nombre de la operaciónString
ringIndica el tiempo transcurrido desde que la llamada es marcada hasta que es respondidaString
abandonEs el resultado de las llamadas inbound colgadas por parte del cliente antes de la atención del asesorString
Posibles códigos de respuesta
				
					$curl = curl_init();
 
curl_setopt_array($curl, array(
  CURLOPT_URL =&gt; 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/customer.php?api=cdr_calls&amp;date_ini={{YYYYmmddHHiiss}}&amp;date_end={{YYYYmmddHHiiss}}',
  CURLOPT_RETURNTRANSFER =&gt; true,
  CURLOPT_ENCODING =&gt; '',
  CURLOPT_MAXREDIRS =&gt; 10,
  CURLOPT_TIMEOUT =&gt; 0,
  CURLOPT_FOLLOWLOCATION =&gt; true,
  CURLOPT_HTTP_VERSION =&gt; CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =&gt; 'GET',
  CURLOPT_HTTPHEADER =&gt; 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