Códigos y estados de motivos

En este documento, se describen los códigos y estados de los motivos de las llamadas y los chats que se usan en CCAI Platform.

Estados de ocupación

Tiempo disponible Es la suma del tiempo que los agentes estuvieron inactivos y listos para controlar una interacción.
Hora de acceso La suma del tiempo que los agentes estuvieron conectados.
Tiempo de cierre Es la suma del tiempo que los agentes estuvieron en el estado de cierre después de finalizar una interacción.
Tiempo de descanso Es la suma del tiempo que los agentes estuvieron en el estado En pausa.
Tiempo de inactividad Es la suma del tiempo que los agentes estuvieron en el estado Inactivo.
Tiempo durante la llamada Es la suma del tiempo que los agentes estuvieron atendiendo llamadas.
Tiempo en el chat Es la suma del tiempo que los agentes estuvieron atendiendo chats.
Hora de comer Es la suma del tiempo que los agentes estuvieron en el estado Comida.
Hora de la llamada perdida Es la suma del tiempo que los agentes estuvieron en el estado Llamada perdida.
Tiempo de chat perdido Es la suma del tiempo que los agentes estuvieron en el estado de chat perdido.
Tiempo sin conexión Es la suma del tiempo que los agentes estuvieron desconectados.
Tiempo de tareas especiales Es la suma del tiempo que los agentes estuvieron en el estado Tarea especial.
Tiempo no disponible Es la suma del tiempo que los agentes estuvieron en el estado No disponible.
Tiempo sin respuesta Es la suma del tiempo que los agentes estuvieron en el estado No responde.

Consulta e identifica los códigos de motivo de error

Esta página puede ayudarte a identificar lo siguiente:

Motivos de las fallas de llamadas

Motivos por los que fallan los chats

Se pueden ver los siguientes códigos de Failed Reason:

  • En el informe estándar Historial de llamadas individuales

  • En los paneles de Llamadas y Chats completados.

  • Usa la API.

Motivos de las fallas de llamadas

Código Nombre de la métrica Descripción
nothing: 0 Sin errores: Llamada Es la suma de las llamadas que no fallaron.
unknown: 10001 Desconocido: Llamada Es la suma de las llamadas que fallaron por motivos desconocidos.
vencido: 11001 Vencido: Llamada Es la suma de las llamadas que fallaron debido a que se agotó el tiempo de espera de la conexión.
transfer_expired: 11002 La transferencia venció Es la suma de las llamadas que fallaron debido a que se agotó el tiempo de espera de la conexión de transferencia.
eu_canceled: 20001 Cancelado Es la suma de las llamadas en las que el usuario final colgó mientras estaba conectado con un agente.
eu_rejected: 20002 Rechazado Es la suma de las llamadas salientes que rechazó el usuario final.
eu_abandoned: 20003 Abandonada Es la suma de las llamadas que abandonó el usuario final mientras esperaba en la fila.
eu_in_menu_abandoned: 20004 Abandono en el menú Es la suma de las llamadas que el usuario final abandonó mientras estaba en el menú de IVR.
eu_repeated_voicemail: 20005 Mensaje de voz repetido

Es la suma de las llamadas que fallaron porque el usuario final ya había dejado un mensaje de voz en espera de respuesta.

Para obtener más información sobre la configuración del buzón de voz, consulta Desvío de llamadas y chats fuera del horario de atención.

eu_repeated_callback: 20006 Devolución de llamada repetida Es la suma de las llamadas que fallaron porque el usuario final ya había solicitado una devolución de llamada.
eu_busy: 21001 Ocupado Es la suma de las llamadas salientes que llegaron al usuario final en estado ocupado.
eu_wrong_number: 21002 Wrong Number Es la suma de las llamadas salientes que se realizaron a un número de teléfono no válido.
eu_no_answer: 21003 Sin respuesta Es la suma de las llamadas salientes que el usuario final no respondió.
eu_noti_failed: 22001 No se pudo enviar la notificación Es la suma de las llamadas que no se conectaron con el agente porque este no tenía habilitadas las notificaciones del navegador.
ag_canceled: 30001 Se canceló el agente Es la suma de las llamadas que fallaron mientras se conectaban al agente. Entre los posibles motivos, se incluyen que el agente haya cerrado el navegador o un error de red.
ag_hung_up_to_callback: 30002 Estado de llamada El agente humano cuelga la llamada debido a problemas de audio o de red, con la intención de volver a llamar.
ag_ignored: 30002 Se ignoró el agente Es la suma de las llamadas que el agente no atendió.
ag_mic_no_device: 31001 Agente sin micrófono Es la suma de las llamadas que fallaron porque el agente no tenía un micrófono.
ag_mic_denied: 31002 Se denegó el acceso al micrófono del agente Es la suma de las llamadas que fallaron porque el agente no tenía habilitado el acceso al micrófono.
ag_called_blocked_num 32002 El agente llamó a un número bloqueado El consumidor está bloqueando la llamada.
No se puede conectar la llamada al número de teléfono marcado 32003 Tiempo de espera de conexión del agente Es la suma de las llamadas que no se pudieron conectar porque el dispositivo del agente perdió la conectividad de red o no se pudo registrar en el servidor.
voip_twilio_error: 41001 Error de VoIP Es la suma de las llamadas que fallaron debido a un problema del proveedor de voz.
voip_tokbox_error: 42001 Error de VoIP Es la suma de las llamadas que fallaron debido a un problema con el proveedor de voz de Tokbox.
voip_invalid_token: 43001 Token de VoIP no válido Es la suma de las llamadas que fallaron porque el proveedor de voz proporcionó un token no válido.
voip_conn_general: 44001 VOIP General Es la suma de las llamadas que fallaron debido a un problema general del proveedor de voz.
voip_conn_timeout: 44002 Tiempo de espera de VOIP Es la suma de las llamadas que fallaron debido a que se agotó el tiempo de espera de la conexión con el proveedor de voz.
voip_conn_signal: 44003 Señal de VOIP Es la suma de las llamadas que fallaron debido a una mala conexión con el proveedor de voz.
voip_nexmo_error: 45001 Error de VoIP Es la suma de las llamadas que fallaron debido a un problema con el proveedor de voz de Nexmo.
stuck_due_to_api_error: 50001 Se detuvo debido a la API Es la suma de las llamadas que fallaron debido a un problema de la API.
group_deleted_no_substitute: 50002 Se borró el grupo: Llamada Es la suma de las llamadas que fallaron debido a que se borró un grupo en cascada sin ninguna alternativa disponible.
menu_deleted: 50003 Se borró el menú Es la suma de las llamadas que fallaron porque se borró la cola después de que el usuario final ya había ingresado a ella.
direct_pstn_call_to_fallback_number: 60001 Se dirige al resguardo Es la suma de las llamadas que se dirigieron a un número de resguardo.

Motivos de los errores de chat

Código Nombre de la métrica Descripción
nothing: 0 No Error - Chat Es la suma de los chats que no fallaron.
unknown: 1 Desconocido: Chat Es la suma de los chats que fallaron por motivos desconocidos.
no_response: 2 Sin respuesta Es la suma de los chats que finalizaron porque el usuario final no respondió.
vencidos: 3 Vencido: Chat Es la suma de los chats que fallaron debido a que se agotó el tiempo de espera de la conexión.
after_hours: 4 Salidas nocturnas Es la suma de los chats que llegaron a una fila fuera del horario de atención.
expired_menu_selection: 31 Menú vencido Es la suma de los chats en los que los usuarios finales seleccionaron una fila que ya no existía.
end_user_opt_out: 41 Inhabilitado Es la suma de los chats en los que los usuarios finales optaron por no ser grabados.
over_cap_email: 50001 Correo electrónico de exceso de capacidad Es la suma de los chats en los que los usuarios finales enviaron un correo electrónico debido a que la fila estaba en un estado de exceso de capacidad.
group_deleted_no_substitute: 60001 Se borró el grupo: Chat Es la suma de los chats que fallaron debido a que se borró un grupo en cascada sin ninguna alternativa disponible.

Diccionario de datos: API de ejemplo y secuencias de comandos de cálculo

A continuación, se muestran ejemplos de secuencias de comandos de API y de cálculo.

Secuencias de comandos de cálculo y de la API de muestra

Este es un ejemplo de secuencia de comandos que se puede ejecutar para probar un par de las métricas de CCAI Platform que existen en el panel del portal del administrador. En él, se muestra cómo se puede recuperar y calcular cualquiera de las métricas.

En el ejemplo, se explica la definición de variables, funciones y secuencias de comandos de cálculo para calcular el volumen total y el nivel de servicio.

Variables

  • Array de llamadas: Agrega un array de llamadas establecido en la variable callsArray.

  • Tipos de llamadas: Es un array de todos los tipos de llamadas que existen en CCAI Platform.

    //Puedes quitar elementos de este array para probar las métricas de solo un tipo de llamadas, por ejemplo:

  • Total hours: Es una variable de horas totales. Calcula la diferencia en horas según los parámetros de tu solicitud.

  • SLA: Se calcula con un umbral configurado en el portal del administrador. Cambia la variable por el importe configurado. En este ejemplo, se muestra un ANS de 60 segundos, por ejemplo:

Funciones

  • Función de registro de llamadas: //checkCallRecord está diseñada para validar si un registro de llamadas tiene el estado correcto, no falló de una manera determinada y, en algunos casos, si el valor de connected es nulo.

  • Función de volumen total de llamadas: getTotalVolumeOfCalls está diseñada para devolver un volumen total de llamadas, por ejemplo:

  • Función de nivel de servicio: getServiceLevel está diseñada para devolver el nivel de servicio de un tipo de llamada, p.ej.:

Secuencias de comandos de cálculo

Ejemplos de secuencias de comandos de cálculo

Para el volumen total, haz lo siguiente:

// TOTAL VOLUME SECTION

for(var i = 0; i\<call_type.length;i++){

var vol = getTotalVolumeOfCalls(callsArray,call_type\[i\]);

if(vol \> 0){

var volPerHour = Math.round(vol/total_hours\*10)/10

var stringToPrint = \"the per hour volume of \"+call_type\[i\]+\" is \"+
volPerHour.toString()

console.log(stringToPrint);

};

}

Para el ANS:

// SLA SECTION

for(var i = 0;i\<call_type.length;i++){

var SLACalc =
(getServiceLevel(callsArray,call_type\[i\])/getTotalVolumeOfCalls(callsArray,call_type\[i\],false,\['eu_in_menu_abandoned'\]));

if (isNaN(SLACalc) == false){

var stringToPrint = \"the SLA of \"+call_type\[i\]+\" is \"+
SLACalc.toString();

console.log(stringToPrint);

} else {

var stringToPrint = \"the SLA of \"+call_type\[i\]+\" cannot be
calculated due to lack of volume\";

console.log(stringToPrint);

}

};

Definiciones de los estados del chat

Estados de chat comunes

Estados de Chat Descripción
En cola El chat está en cola y espera a un agente
Asignado El chat se asigna a un agente.
En curso El chat está activo con un agente y un usuario final
Finalizado El chat finalizó correctamente (los motivos de finalización se indican a continuación)
Abandonada El usuario final canceló el chat antes de que se asignara a un agente
Se desvió la pelota Se canceló el chat y se desvió al correo electrónico de capacidad excedida
Con errores Error en el chat (se indican los motivos del error)

Estados de chat finalizado

Estados de chat finalizados Descripción
Finalizado El chat finalizó correctamente sin información adicional
Finalizada: El agente desconectó la llamada Se finalizó el chat y se desconectó el agente
Finalizada: El usuario final la desconectó El chat finalizó, el usuario final lo desconectó
Finalizado: No hay mensajes Se finalizó el chat porque no hubo respuesta
Finalizado: No hay mensajes desconectados por el agente Se finalizó el chat, no hubo respuesta y el agente se desconectó
Finalizado: El usuario final no desconectó ningún mensaje Se finalizó el chat, no hubo respuesta y el usuario final se desconectó
Tiempo de espera: Tiempo de espera por agente sin mensajes Se agotó el tiempo de espera del chat y el agente nunca envió un mensaje mientras lo administraba. En el caso de los chats derivados de un agente virtual, solo se cuentan los mensajes del agente humano.
Tiempo de espera: Tiempo de espera del usuario final sin mensajes Se agotó el tiempo de espera del chat y el usuario final nunca envió un mensaje en ningún momento durante el chat, incluido al agente virtual antes de una derivación. Si el usuario final envió al menos un mensaje antes en el chat y, luego, no envió más, el chat se registra como "Tiempo de espera: el usuario final dejó de responder".
Tiempo de espera agotado: el agente dejó de responder Se agotó el tiempo de espera del chat mientras el mensaje sin respuesta más reciente era del usuario final; el agente había respondido antes, pero se detuvo.
Tiempo de espera agotado: El usuario final dejó de responder Se agotó el tiempo de espera del chat después de que el usuario final dejó de responder. El usuario final envió al menos un mensaje antes en el chat, al agente virtual o al agente, y luego dejó de responder.

Valores de los motivos de finalización del chat (exportación de chats de BigQuery)

Valor Definición
0 No hay un motivo de finalización específico. El estado que se muestra ("Finalizado" / "Finalizado: Desconectado por el agente" / "Finalizado: Desconectado por el usuario final") se determina según la columna disconnected_by (0 = desconocido, 1 = agente, 2 = usuario final).
1 No hay respuesta. Corresponde a los estados "Finalizado: Sin mensajes", combinados con disconnected_by como se describió anteriormente.
2 Tiempo de espera: Tiempo de espera por agente sin mensajes
3 Tiempo de espera agotado: el agente dejó de responder
4 Tiempo de espera agotado: el agente dejó de responder
5 Tiempo de espera agotado: El usuario final dejó de responder
6 El usuario final inhabilitó la opción (por ejemplo, respondió STOP por SMS).
7 Se agotó el tiempo de espera de la comprobación del consumidor
8 El chat finalizó por la organización de la API (resultado end_chat del punto de acceso directo)

Motivos de los errores del chat

Motivo del error Definición
Con errores No se pudo iniciar la sesión de chat por un motivo desconocido
Vencido El chat venció en una cola y un agente no lo atendió

Definiciones de los estados de las llamadas

Los siguientes estados de llamada pueden aparecer en el informe del historial de rendimiento de las llamadas.

Estado de llamada Descripción
Abandonada Una llamada está esperando en la cola y el emisor la desconecta antes de que un agente la acepte. Se excluyen los abandonos en el menú y los abandonos cortos.
Ocupado El usuario final estaba ocupado
Cancelado El usuario final canceló la llamada
Completado La llamada se completa correctamente sin errores.
Error La llamada tiene un error
Con errores Una llamada finaliza debido a un error. Incluye un motivo de error para obtener más contexto.
Sin respuesta El usuario final no respondió
Recuperada Se devuelve una llamada fallida. La llamada nueva es un elemento secundario de la llamada original. Incluye si la devolución de llamada finaliza sin errores.