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
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. |