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
NAME DESCRIPTION TYPE
api Tipo de reporte requerido String
date_ini Fecha Inicial (YYYYmmddHHiiss) String
date_end Fecha Final (YYYYmmddHHiiss) String
agent_dni DNI del agente String
RESPONSE
NAME DESCRIPTION TYPE
conn_id Corresponde al número de identificación del chat String
channel Hace referencia al canal usado en la interacción               String
date Indica la fecha con formato año-mes -día-Hora String
customer_name Nombre del cliente String
customer_email Es el correo electrónico del cliente String
customer_phone Es el teléfono del cliente String
customer_chars Indica la cantidad numérica de los carácteres digitados por el cliente String
agent_id Se refiere a la identificación numerica de cada uno de los usuarios de wolkvox Agente String
agent_name Nombre del agente String
agent_chars Indica la cantidad numérica de los carácteres digitados por el agente String
time_on_agent Indica el tiempo que el agente empleó en la atención String
chat_duration Indica tiempo de duración de la interacción en unidades de segundos String
cod_act Es el ID del código de tipificación o codificación usado por el agente String
description_cod_act Indica la descripción del código de tipificación String
comments Texto tipo comentario de la interacción String
customer_id Corresponde al número de identificación del cliente String
skill_id Es la identificación numérica del grupo de la skill              String
ASA El tiempo que transcurre desde que el chat es iniciado por el cliente y respondido por el asesor String
last_participant_who_spoke Indica el último participante que interactuó String
extra_field Campo adicional para guardar información String
comment Texto tipo comentario de la interacción String
user_id Identificación del usuario String
feeling Sentimiento reconocido String
agent_anwers Número de veces que escribe agente al cliente String
Posibles códigos de respuesta
				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL =&gt; 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/reports_manager.php?api=chat_1&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": "",
            "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