fbpx

< / >

APIs Reports Manager

1. Chats

URL:

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

Descripción:

Este reporte permite conocer a profundidad la gestión de los canales de chat atendidos por agentes humanos, pormenorizando los detalles del chat (ID chat, fecha, duración, codificación, skill y canal), del cliente (ID, nombre, email, teléfono, caracteres enviados), el agente (ID, nombre, caracteres enviados) y medidores de eficiencia (ASA y Last Participant).

Beneficio:

Brinda una visión completa de la interacción no automatizadas por chat entre cliente y asesor.

Cómo funciona:

  • El consumo de esta API se realiza por método GET.
  • Para consumir esta API debe reemplazar en la url {ip_ipdialbox} por la nomenclatura del servidor de la operación y el {token} generado desde wolkvox Manager para obtener la información de manera segura.
  • 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
apiTipo de reporte requeridoString
date_iniFecha Inicial (YYYYmmddHHiiss)String
date_endFecha Final (YYYYmmddHHiiss)String
agent_dniDNI del agenteString

RESPONSE
NAMEDESCRIPTIONTYPE
conn_idCorresponde al número de identificación del chatString
channelHace referencia al canal usado en la interacción              String
dateIndica la fecha con formato año-mes -día-HoraString
customer_nameNombre del clienteString
customer_emailEs el correo electrónico del clienteString
customer_phoneEs el teléfono del clienteString
customer_charsIndica la cantidad numérica de los carácteres digitados por el clienteString
agent_idSe refiere a la identificación numerica de cada uno de los usuarios de wolkvox AgenteString
agent_nameNombre del agenteString
agent_charsIndica la cantidad numérica de los carácteres digitados por el agenteString
time_on_agentIndica el tiempo que el agente empleó en la atenciónString
chat_durationIndica tiempo de duración de la interacción en unidades de segundosString
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
commentsTexto tipo comentario de la interacciónString
customer_idCorresponde al número de identificación del clienteString
skill_idEs la identificación numérica del grupo de la skill             String
ASAEl tiempo que transcurre desde que el chat es iniciado por el cliente y respondido por el asesorString
last_participant_who_spokeIndica el último participante que interactuóString
extra_fieldCampo adicional para guardar informaciónString
commentTexto tipo comentario de la interacciónString
user_idIdentificación del usuarioString
feelingSentimiento reconocidoString
agent_anwersNúmero de veces que escribe agente al clienteString

Posibles códigos de respuesta
				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/reports_manager.php?api=chat_1&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": "",
            "channel": "",
            "date": "",
            "customer_name": "",
            "customer_email": "",
            "customer_phone": "",
            "customer_chars": "",
            "agent_id": "",
            "agent_name": "",
            "agent_chars": "",
            "time_on_agent": "",
            "chat_duration": "",
            "cod_act": "",
            "description_cod_act": "",
            "comments": "test",
            "customer_id": "",
            "skill_id": "",
            "ASA": "",
            "last_participant_who_spoke": "",
            "extra_field": "",
            "comment": "",
            "user_id": "",
            "feeling": "",
            "agent_anwers ": ""
        }
    ]
}
				
			

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