fbpx

< / >

APIs Reports Manager

8. Chats transferidos a agente

URL:

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

Descripción:

Este reporte permite hacer trazabilidad a las interacciones que inician en un chat gestionadas por un bot y que son transferidas para atención por agente humano.

De la atención por el chatbot este reporte detalla el ID del chat, ID de la interacción, fecha de inicio y cierre, tiempo de uso del chatbot, el punto de enrutamiento y el canal usado.

Del cliente indica el nombre, teléfono, caracteres digitados y ID; mientras que del agente informa el ID, nombre del agente y tiempo de atención al usuario.

Brindando además el tiempo total de atención y la cantidad total de caracteres digitados.

Beneficio:

Identificar las acciones en las cuales el usuario ha sido transferido a agente humano permite evaluar el modelo de autogestión del chat y detallar las acciones en las cuales es indispensable la atención por asesor.

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
NAME DESCRIPTION TYPE
api Tipo de reporte requerido 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 del chat String
session_id identificador de cliente vs canal y/o conector String
times_chatted Indica la cantidad de mensajes que fueron enviados String
start_date Fecha de inicio String
end_date Fecha de finalización String
time_on_chatbot Indica el tiempo que el cliente fue atendido por el bot String
rp_id Indica la identificación numérica del punto de enrutamiento      String
channel Hace referencia al canal usado en la interacción               String
go_to_agent Permite identificar si la interacción tuvo paso a agente String
customer_phone Se refiere al teléfono del cliente String
customer_name Nombre del 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
time_with_agent Indica el tiempo que el agente empleó en la atención    String
total_time Indica la cantidad de tiempo que se usó para gestionar la interacción String
customer_chars Indica la cantidad numérica de los carácteres digitados por el cliente String
agent_chars Indica la cantidad numérica de los carácteres digitados por el agente String
total_chars Indica la cantidad de caracteres que fueron digitados por el cliente y el asesor String
asa El tiempo que transcurre desde que el chat es iniciado por el cliente y respondido por el asesor String
last_sender Indica el último participante que interactuó String
customer_id Corresponde al número de identificación del cliente String
customer_email Es el correo electrónico del 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_8&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": "-",
            "session_id": "",
            "times_chatted": "",
            "start_date": "",
            "end_date": "",
            "time_on_chatbot": "",
            "rp_id": "",
            "channel": "",
            "go_to_agent": "",
            "customer_phone": "",
            "customer_name": "",
            "agent_id": "",
            "agent_name": "",
            "time_with_agent": "",
            "total_time": "",
            "customer_chars": "",
            "agent_chars": "",
            "total_chars": "",
            "asa": "",
            "last_sender": "",
            "customer_id": "",
            "customer_email": ""
        }
    ]
}
				
			

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