Códigos de motivo e status

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:

Motivos de falha na chamada

Motivos de falha do chat

Os seguintes códigos de motivo de falha podem ser visualizados:

  • No relatório padrão Histórico de ligações individuais.

  • Nos painéis de Chamadas e Chats concluídos.

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