Neste documento, descrevemos os códigos e status de motivo de chamada e chat usados na CCAI Platform.
Status de ocupação
| Horário disponível | A soma do tempo em que os agentes ficaram ociosos e prontos para lidar com uma interação. |
| Horário de login | A soma do tempo em que os agentes ficaram conectados. |
| Tempo de finalização | A soma do tempo em que os agentes estavam no estado de finalização após o término de uma interação. |
| Intervalo | A soma do tempo em que os agentes estavam no status "Intervalo". |
| Tempo de inatividade | A soma do tempo em que os agentes estavam no status "Inativo". |
| Tempo em chamada | A soma do tempo que os agentes passaram atendendo chamadas. |
| Tempo no chat | A soma do tempo que os agentes passaram lidando com chats. |
| Hora da refeição | A soma do tempo em que os agentes estavam no status "Refeição". |
| Horário da ligação perdida | A soma do tempo em que os agentes ficaram com o status "Ligação perdida". |
| Tempo de chat perdido | A soma do tempo em que os agentes estavam no status "Chat perdido". |
| Tempo off-line | A soma do tempo em que os agentes ficaram desconectados. |
| Hora da tarefa especial | A soma do tempo em que os agentes estavam no status "Tarefa especial". |
| Tempo indisponível | A soma do tempo em que os agentes estavam no status "Indisponível". |
| Tempo sem resposta | A soma do tempo em que os agentes estavam no status "Não responsivo". |
Ver e identificar códigos de motivo de falha
Esta página pode ajudar você a identificar:
Os seguintes códigos de motivo de falha podem ser visualizados:
No relatório padrão Histórico de ligações individuais.
Usando a API.
Motivos de falha na chamada
| Código | Nome da métrica | Descrição |
|---|---|---|
| nada: 0 | Nenhum erro: chamada | A soma das chamadas que não falharam. |
| desconhecido: 10001 | Desconhecido: chamada | A soma das chamadas que falharam por motivos desconhecidos. |
| expirou: 11001 | Expirado: chamada | A soma das chamadas que falharam devido ao tempo limite da conexão. |
| transfer_expired: 11002 | A transferência expirou | A soma das chamadas que falharam porque a conexão de transferência expirou. |
| eu_canceled: 20001 | Cancelado | A soma das chamadas em que o usuário final desligou enquanto estava sendo conectado a um agente. |
| eu_rejected: 20002 | Recusado | A soma das chamadas de saída que foram recusadas pelo usuário final. |
| eu_abandoned: 20003 | Abandonada | A soma das chamadas que foram abandonadas pelo usuário final enquanto aguardava na fila. |
| eu_in_menu_abandoned: 20004 | Abandono no menu | A soma das chamadas que foram abandonadas pelo usuário final enquanto estavam no menu da URA. |
| eu_repeated_voicemail: 20005 | Correio de voz repetido |
A soma das chamadas que falharam porque o usuário final já tinha deixado uma mensagem de correio de voz aguardando resposta. Para mais informações sobre as configurações de correio de voz, consulte Desvio de chamadas e chats fora do horário de atendimento. |
| eu_repeated_callback: 20006 | Callback repetido | A soma das chamadas que falharam porque o usuário final já havia solicitado um retorno de chamada. |
| eu_busy: 21001 | Ocupado | A soma das chamadas de saída que chegaram ao usuário final em um estado ocupado. |
| eu_wrong_number: 21002 | Wrong Number | A soma das chamadas feitas para um número de telefone inválido. |
| eu_no_answer: 21003 | No Answer | A soma das chamadas feitas em que o usuário final não atendeu. |
| eu_noti_failed: 22001 | Falha na notificação | A soma das ligações que não foram conectadas ao agente porque ele não ativou as notificações do navegador. |
| ag_canceled: 30001 | Agente cancelado | A soma das chamadas que falharam ao serem conectadas ao agente. Os possíveis motivos incluem o agente fechar o navegador ou um erro de rede. |
| ag_hung_up_to_callback: 30002 | Status da chamada | O agente humano desliga a chamada devido a problemas de áudio ou de rede, com a intenção de retornar a ligação. |
| ag_ignored: 30002 | Agente ignorado | A soma das ligações que não foram atendidas pelo agente. |
| ag_mic_no_device: 31001 | Agente sem microfone | A soma das chamadas que falharam porque o agente não tinha um microfone. |
| ag_mic_denied: 31002 | Acesso ao microfone do agente negado | A soma das ligações que falharam porque o agente não tinha o acesso ao microfone ativado. |
| ag_called_blocked_num 32002 | Ligação agêntica para número bloqueado | O consumidor está bloqueando a chamada. |
| Não foi possível conectar a chamada ao número de telefone discado 32003 | Tempo limite de conexão do agente | A soma das chamadas que não foram conectadas porque o dispositivo do agente perdeu a conectividade de rede ou não conseguiu se registrar no servidor. |
| voip_twilio_error: 41001 | Erro de VOIP | A soma das chamadas que falharam devido a um problema com o provedor de voz. |
| voip_tokbox_error: 42001 | Erro de VOIP | A soma das chamadas que falharam devido a um problema com o provedor de voz Tokbox. |
| voip_invalid_token: 43001 | Token de VOIP inválido | A soma das chamadas que falharam porque o provedor de voz forneceu um token inválido. |
| voip_conn_general: 44001 | VOIP General | A soma das chamadas que falharam devido a um problema geral do provedor de voz. |
| voip_conn_timeout: 44002 | Tempo limite de VOIP | A soma das chamadas que falharam porque a conexão do provedor de voz expirou. |
| voip_conn_signal: 44003 | Sinal de VoIP | A soma das chamadas que falharam devido a uma conexão ruim com o provedor de voz. |
| voip_nexmo_error: 45001 | Erro de VOIP | A soma das chamadas que falharam devido a um problema com o provedor de voz Nexmo. |
| stuck_due_to_api_error: 50001 | Travado devido à API | A soma das chamadas que falharam devido a um problema na API. |
| group_deleted_no_substitute: 50002 | Grupo excluído: chamada | A soma das chamadas que falharam porque um grupo em cascata foi excluído sem nenhuma alternativa disponível. |
| menu_deleted: 50003 | Menu excluído | A soma das chamadas que falharam porque a fila foi excluída depois que o usuário final já havia entrado nela. |
| direct_pstn_call_to_fallback_number: 60001 | Direcionado para fallback | A soma das chamadas que foram direcionadas para um número de fallback. |
Motivos de falha no chat
| Código | Nome da métrica | Descrição |
| nada: 0 | Sem erro: chat | A soma das conversas que não falharam. |
| unknown: 1 | Desconhecido - Chat | A soma das conversas que falharam por motivos desconhecidos. |
| no_response: 2 | Sem resposta | A soma das conversas que terminaram porque o usuário final não respondeu. |
| expirado: 3 | Expirado: chat | A soma das conversas que falharam devido ao tempo limite da conexão. |
| after_hours: 4 | Eventos após as sessões | A soma dos chats que chegaram a uma fila fora do horário de funcionamento. |
| expired_menu_selection: 31 | Menu expirado | A soma dos chats em que os usuários finais selecionaram uma fila que não existia mais. |
| end_user_opt_out: 41 | Desativado | A soma das conversas em que os usuários finais optaram por não ser gravados. |
| over_cap_email: 50001 | E-mail de capacidade excedida | A soma dos chats em que os usuários finais enviaram um e-mail porque a fila estava com capacidade excedida. |
| group_deleted_no_substitute: 60001 | Grupo excluído: chat | A soma dos chats que falharam porque um grupo em cascata foi excluído sem nenhuma alternativa disponível. |
Dicionário de dados: API de exemplo e scripts de cálculo
Veja a seguir exemplos de scripts de API e de cálculo.
Exemplos de scripts de API e cálculo
Este é um script de exemplo que pode ser executado para testar algumas das métricas da CCAI Platform que existem no painel do portal do administrador. Ele exemplifica como qualquer uma das métricas pode ser recuperada e calculada.
O exemplo mostra a definição de variáveis, funções e scripts de cálculo para calcular o volume total e o nível de serviço.
Variáveis
Matriz de chamadas: adicione uma matriz de chamadas definida para a variável callsArray.
Tipos de chamada: é uma matriz de todos os tipos de chamada que existem na CCAI Platform.
//É possível remover elementos dessa matriz para testar métricas de apenas um determinado tipo de chamada. Por exemplo:
Total de horas: é uma variável de total de horas. Calcule a diferença em horas com base nos parâmetros da solicitação.
SLA: é calculado usando um limite configurado no portal do administrador. Mude a variável com o valor configurado. Este exemplo mostra um SLA de 60 segundos. Por exemplo:
Funções
Função de registro de chamada: //checkCallRecord foi projetada para validar se um registro de chamada está no status adequado, não falhou de uma determinada maneira e, em alguns casos, se o valor de "connected" é nulo.
Função de volume total de chamadas: getTotalVolumeOfCalls foi projetada para retornar um volume total de chamadas, por exemplo:
Função de nível de serviço: getServiceLevel foi projetada para retornar o nível de serviço de um tipo de chamada, por exemplo:
Scripts de cálculo
Exemplos de scripts de cálculo.
Para o volume total:
// 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 SLA:
// 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);
}
};
Definições de status do chat
Status comuns do chat
| Status do Chat | Descrição |
| Na fila | O chat está na fila e aguardando um agente |
| Atribuído | O chat é atribuído a um agente |
| Em andamento | O chat está ativo com um agente e um usuário final |
| Concluído | Chat concluído (motivos de conclusão listados abaixo) |
| Abandonada | Chat cancelado pelo usuário final antes de ser atribuído a um agente |
| Desviada | O chat foi cancelado e desviado para o e-mail de capacidade excedida |
| Falha | Falha no chat (motivos da falha listados) |
Status de chat finalizado
| Status de chat finalizado | Descrição |
|---|---|
| Concluído | O chat foi concluído sem outras informações |
| Concluído: desconectado pelo agente | O chat foi encerrado, e o agente se desconectou |
| Concluído: desconectado pelo usuário final | O chat foi encerrado, desconectado pelo usuário final |
| Concluído: nenhuma mensagem | O chat foi encerrado porque não houve resposta |
| Concluído: nenhuma mensagem desconectada pelo agente | O chat foi encerrado, não houve resposta e o agente se desconectou |
| Concluído: nenhuma mensagem desconectada pelo usuário final | O chat foi encerrado, não houve resposta e o usuário final se desconectou |
| Tempo limite: tempo limite por agente sem mensagens | O tempo limite do chat se esgotou, e o agente não enviou nenhuma mensagem durante o atendimento. Para chats encaminhados de um agente virtual, apenas as mensagens do agente humano são contadas. |
| Tempo limite: tempo limite por usuário final sem mensagens | O chat expirou, e o usuário final não enviou nenhuma mensagem durante o chat, inclusive para o agente virtual antes de um encaminhamento. Se o usuário final tiver enviado pelo menos uma mensagem antes no chat e depois tiver ficado em silêncio, o chat será registrado como "Tempo limite: o usuário final parou de responder". |
| Tempo limite: o agente parou de responder | O chat expirou enquanto a mensagem mais recente sem resposta era do usuário final. O agente havia respondido antes, mas parou. |
| Tempo limite: o usuário final parou de responder | O tempo limite do chat foi atingido depois que o usuário final parou de responder. O usuário final enviou pelo menos uma mensagem no chat para o agente virtual ou para o agente e depois ficou em silêncio. |
Valores do motivo de encerramento da conversa (exportação de conversas do BigQuery)
| Valor | Definição |
|---|---|
| 0 | Nenhum motivo específico para a conclusão. O status exibido ("Concluído" / "Concluído: desconectado pelo agente" / "Concluído: desconectado pelo usuário final") é determinado pela coluna disconnected_by (0 = desconhecido, 1 = agente, 2 = usuário final). |
| 1 | Sem resposta. Corresponde aos status "Concluído: sem mensagens", combinados com disconnected_by, conforme descrito anteriormente. |
| 2 | Tempo limite: tempo limite por agente sem mensagens |
| 3 | Tempo limite: o agente parou de responder |
| 4 | Tempo limite: o agente parou de responder |
| 5 | Tempo limite: o usuário final parou de responder |
| 6 | O usuário final recusou (por exemplo, respondeu PARAR no SMS) |
| 7 | O tempo limite da confirmação do consumidor expirou |
| 8 | Chat encerrado pela orquestração da API (resultado end_chat do ponto de acesso direto) |
Motivos da falha no chat
| Motivo da falha | Definição |
|---|---|
| Falha | Falha na sessão de chat por um motivo desconhecido |
| Expirado | O chat expirou em uma fila e não foi atendido por um agente |
Definições de status da ligação
Os seguintes status de chamada podem aparecer no relatório de histórico de performance de chamadas.
| Status da chamada | Descrição |
|---|---|
| Abandonada | Uma chamada está aguardando na fila e é desconectada pelo autor antes de ser aceita por um agente. Exclui abandonos no menu e curtos. |
| Ocupado | O usuário final estava ocupado |
| Cancelado | O usuário final cancelou a chamada |
| Concluído | Uma chamada é concluída sem erros |
| Erro | A chamada tem um erro |
| Falha | Uma chamada é encerrada devido a um erro. Inclui um motivo de falha para mais contexto. |
| No Answer | O usuário final não respondeu |
| Recuperado | Uma chamada com falha é retornada. A nova chamada é filha da original. Inclui se o retorno de chamada é concluído sem erros. |