A entidade Queued Case Information (Informações de Atendimento por Fila) registra cada ciclo de atendimento originado a partir de uma fila — da entrada na espera até a desatribuição do agente, a transferência para outra fila ou o encerramento do caso.
Qual a diferença para o Case Information? O Case Information tem uma linha por caso e consolida os tempos de todas as filas pelas quais o atendimento passou. O Queued Case Information tem uma linha por fila visitada: um caso que passou por três filas gera três registros aqui e apenas um no Case Information. Isso permite analisar a performance de cada fila de forma isolada — tempo de espera, TMA, Nível de serviço e volume de interações segmentados por fila.
Qual a diferença para o Case Delivery Summary? O Case Delivery Summary registra cada evento de roteamento (entrada, transferência, abandono). O Queued Case Information vai além: além dos instantes, consolida durações calculadas, contagens de interação e métricas de nível de serviço prontas para agregação direta em relatórios.
Quando usar: Use o Queued Case Information para analisar a operação fila a fila — TME (Tempo Médio de Espera), TMA por fila, TMPR (Tempo Médio de Primeira Resposta), Nível de Serviço por fila e volume de interações por canal. É a entidade certa para dashboards operacionais de filas.
Disponibilidade dos dados: Os dados desta entidade são computados a partir de 23/10. Análises anteriores a essa data não terão registros nesta entidade.
Atenção a ciclos abertos: Sempre filtre por
Cycle Closed Atpreenchido ao calcular métricas finais. Um ciclo em aberto ainda está acumulando tempo e contagens — incluí-lo distorce TMA, TME e qualquer soma de duração.
O que está consolidado nesta entidade?
|
Categoria |
O que você encontra |
|---|---|
|
Identificação |
Caso, fila, Unidade de Negócio e canal de origem e atual |
|
Tempos do ciclo |
Espera na fila, atendimento humano, primeira resposta, pós-atendimento e conversa de voz |
|
Tempos de resposta |
Soma e contagem de respostas do agente e do cliente, para calcular médias corretas entre ciclos |
|
Volume de interações |
Mensagens, e-mails e chamadas enviadas e recebidas no ciclo |
|
Nível de Serviço |
Se a espera ficou dentro do limite da fila e qual era a meta configurada |
Como os registros são criados?
Cada registro representa um Ciclo de Fila: o período em que um caso esteve vinculado a uma fila específica, da entrada na espera até a saída — seja por encerramento, desatribuição ou transferência para outra fila.
O que gera um novo registro:
-
O caso entra em uma nova fila (seja pela primeira vez ou após transferência)
-
Um agente é atribuído ao caso a partir dessa fila
-
O ciclo é encerrado quando o agente é desatribuído, o caso é transferido ou o caso é encerrado
O que não gera registro:
-
Caso encerrado na espera sem nunca ter sido atribuído a um agente (abandono na fila)
-
Atendimento realizado exclusivamente pelo bot, sem passar por fila humana
-
Atribuição manual sem roteamento por fila
Transferência direta entre agentes não abre um novo registro — o tempo dos dois agentes é somado dentro do mesmo ciclo.
Atenção ao comparar totais: como cada caso pode gerar múltiplos registros, somar volumes diretamente com o Case Information dará diferenças. Para contar casos únicos, use
COUNT(DISTINCT Case Id)— nãoCOUNT(*).
Exemplos práticos de uso
Pergunta: Qual é o TME (Tempo Médio de Espera) por fila nesta semana? → Calcule a média de Queue Time, agrupando por Distribution Rule Name e filtrando pelo intervalo de Assigned At. Desconsidere registros onde Queue Time é nulo (espera não mensurada).
Pergunta: Qual é o TMA por fila no mês? → Calcule a média de Attendance Time, agrupando por Distribution Rule Name e filtrando por ciclos encerrados via Cycle Closed At.
Pergunta: Qual é o TMPR (Tempo Médio de Primeira Resposta) por canal? → Calcule a média de First Response Time, agrupando por Source Channel Type. Registros com First Response Time nulo (sem resposta do agente) são automaticamente excluídos da média.
Pergunta: Qual o percentual de atendimentos dentro do nível de serviço por fila? → Divida a contagem de registros com Is Service Level Ok = true pelo total de registros onde Is Service Level Ok não é nulo, agrupando por Distribution Rule Name.
Pergunta: Qual o tempo médio de resposta do agente por fila? → Some Sum Response Time e divida por Count Response, agrupando por Distribution Rule Name. Não calcule a média direta do campo Response Time — esse campo é uma média por ciclo e a média de médias distorce o resultado.
Pergunta: Quantas mensagens foram trocadas por canal nesta semana? → Some Count Sent Messages + Count Received Messages, agrupando por Source Channel.
Dicionário de Campos
Identificação do Caso
Chave natural do ciclo: cada registro é identificado de forma única pela combinação de
Case Id+Distribution Rule Id+Enqueued At+Assigned At. Use essa combinação para unir esta entidade com outras tabelas ou para identificar um ciclo específico sem ambiguidade.
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Case Id |
Texto |
Identificador único do caso. Use |
|
Case Business Id |
Número |
Número do caso exibido na interface da plataforma. Use para buscas e exibição em relatórios. |
Fila e Unidade de Negócio
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Distribution Rule Id |
Texto |
Identificador único da fila responsável por este ciclo de atendimento. Campo obrigatório para análises por fila. |
|
Distribution Rule Name |
Texto |
Nome da fila no momento da criação do ciclo. Alterações posteriores no nome da fila não afetam registros já criados. |
|
Business Unit Id |
Texto |
Identificador da Unidade de Negócio do atendimento. Em casos de troca de Unidade, cada ciclo mantém a Unidade que estava ativa no seu período. |
|
Business Unit Name |
Texto |
Nome da Unidade de Negócio vinculada ao ciclo. |
Canal de Origem
Campos gravados no momento da criação do caso e nunca atualizados — representam sempre o canal pelo qual o cliente entrou.
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Source Channel |
Texto |
Canal de origem do caso (ex: WHATSAPP, VOICE, EMAIL). |
|
Source Channel Type |
Texto |
Tipo do canal de origem: CHAT, VOICE ou CASE_LIST (e-mail e SMS). |
|
Source Channel Id |
Texto |
Identificador técnico do canal de origem. |
|
Source Channel Key Id |
Texto |
Chave de integração do canal de origem (ex: ID do número de WhatsApp). |
|
Source Channel Key Name |
Texto |
Nome da conta integrada ao canal de origem (ex: número de WhatsApp da empresa). |
|
Origin Direction |
Texto |
Direção do contato: INBOUND (receptivo — cliente entrou em contato) ou OUTBOUND (ativo — empresa entrou em contato). |
Canal Atual
Campos que refletem o último canal do caso dentro deste ciclo. Uma troca de canal após o encerramento do ciclo não altera estes valores.
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Current Channel |
Texto |
Canal em que o atendimento estava no momento do encerramento do ciclo. |
|
Current Channel Type |
Texto |
Tipo do canal atual: CHAT, VOICE ou CASE_LIST. |
|
Current Channel Id |
Texto |
Identificador técnico do canal atual. |
|
Current Channel Key Id |
Texto |
Chave de integração do canal atual. |
|
Current Channel Key Name |
Texto |
Nome da conta integrada ao canal atual. |
Instantes do Ciclo
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Enqueued At |
Data/Hora |
Momento em que o caso entrou na fila de espera. Nulo quando o ciclo nasceu diretamente de uma atribuição, sem passagem pela espera ( |
|
Assigned At |
Data/Hora |
Momento em que o caso foi atribuído ao agente pela fila. É o início do atendimento humano no ciclo. |
|
Cycle Closed At |
Data/Hora |
Momento de encerramento do ciclo — por desatribuição, transferência para outra fila ou encerramento do caso. Nulo indica que o ciclo ainda está em aberto. Para métricas consolidadas, sempre filtre por ciclos com este campo preenchido. |
|
First Agent Response At |
Data/Hora |
Instante da primeira resposta do agente que encerrou o TPR. Útil para auditoria do Tempo de Primeira Resposta. |
|
First Customer Message Date |
Data/Hora |
Instante da primeira mensagem do cliente dentro do ciclo. Ponto de início do TPR no modo "aguardar cliente". |
|
Call End Date |
Data/Hora |
Fim da última chamada de voz com interação humana no ciclo. Marca o início do pós-atendimento (ACW). Preenchido apenas em ciclos de voz. |
|
Opened At Enqueue |
Verdadeiro/Falso |
Indica se o ciclo nasceu de uma espera em fila ( |
Auditoria de Instantes
Campos de apoio para investigação do TPR e do canal. Não são necessários para métricas operacionais rotineiras.
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Auto Message Start Time |
Data/Hora |
Instante em que a saudação automática foi enviada ao cliente. A saudação não conta como primeira resposta do agente e não encerra o TPR — serve apenas para auditoria do comportamento da mensagem automática. |
|
First Response Start Time |
Data/Hora |
Instante da mensagem que efetivamente encerrou o TPR. Útil para auditar qual mensagem foi considerada pelo sistema como a primeira resposta válida do agente. |
|
Current Channel Updated At |
Data/Hora |
Instante em que ocorreu a troca de canal que registrou o valor atual do |
Tempos do Ciclo
Todos os campos de tempo estão em milissegundos (ms). Campos nulos indicam ausência real do dado — não substitua por zero antes de calcular médias, pois o banco já ignora nulos automaticamente.
Espera e Atendimento
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Queue Time |
Número (ms) |
Tempo de espera na fila: de |
|
Attendance Time |
Número (ms) |
Tempo total com agente atribuído no ciclo — inclui conversa, toque de chamadas de saída e pós-atendimento. Em transferências diretas entre agentes na mesma fila, os tempos são somados no mesmo ciclo. Use a média deste campo para calcular o TMA por fila. |
|
First Response Time |
Número (ms) |
Tempo de Primeira Resposta (TPR): da atribuição do agente até a primeira mensagem enviada ao cliente. No modo "aguardar cliente", começa a contar a partir da primeira mensagem do cliente. Nulo em ciclos sem resposta do agente — esses ciclos não entram na média do TMPR. |
|
After Call Work Time |
Número (ms) |
Tempo de pós-atendimento de voz (ACW): do fim da última chamada ( |
Voz
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Talking Time |
Número (ms) |
Soma da duração de todas as chamadas de voz atendidas neste ciclo. |
|
Ringing Time |
Número (ms) |
Soma do tempo de toque (chamadas de saída antes da conexão) em todas as chamadas do ciclo. Para calcular o TMA sem incluir o tempo de toque de saída: |
Tempos de Resposta (Chat)
Os campos
Response TimeeCustomer Response Timesão médias calculadas dentro do próprio ciclo. Nunca calcule a média desses campos entre ciclos — isso produz média de médias e distorce o resultado. Para calcular a média correta entre múltiplos ciclos, use sempre a soma dividida pela contagem.
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Sum Response Time |
Número (ms) |
Soma de todos os tempos de resposta do agente no ciclo, incluindo a primeira resposta. Para obter o tempo médio de resposta do agente entre vários ciclos: |
|
Count Response |
Número |
Quantidade de respostas do agente medidas no ciclo. É o divisor correto de |
|
Response Time |
Número (ms) |
Média do tempo de resposta do agente calculada dentro do ciclo ( |
|
Sum Customer Response Time |
Número (ms) |
Soma de todos os tempos de resposta do cliente no ciclo. Para a média entre ciclos: |
|
Count Customer Response Time |
Número |
Quantidade de respostas do cliente medidas no ciclo. É o divisor correto de |
|
Customer Response Time |
Número (ms) |
Média do tempo de resposta do cliente calculada dentro do ciclo. Não agregue entre ciclos com AVG — use a soma e a contagem. |
Volume de Interações
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Count Sent Messages |
Número |
Total de mensagens de chat enviadas pelo agente ao cliente neste ciclo. |
|
Count Received Messages |
Número |
Total de mensagens de chat recebidas do cliente neste ciclo. |
|
Count Sent Emails |
Número |
Total de e-mails enviados pelo agente ao cliente. Envios automáticos também são contados. |
|
Count Received Emails |
Número |
Total de e-mails recebidos do cliente neste ciclo. |
|
Count Inbound Calls |
Número |
Total de chamadas de voz receptivas atendidas neste ciclo. |
|
Count Outbound Calls |
Número |
Total de chamadas de voz ativas realizadas pelo agente neste ciclo. |
|
Rejected Calls |
Número |
Total de toques rejeitados manualmente pelo agente neste ciclo. |
|
Ignored Calls |
Número |
Total de toques ignorados (sem aceitar nem rejeitar) pelo agente neste ciclo. |
Nível de Serviço
O Nível de Serviço é medido com base no
Queue Time— o tempo de espera na fila. Atendimentos sem espera mensurada (Opened At Enqueue = false) têmIs Service Level Oknulo e não devem entrar no denominador do percentual. Atendimentos via e-mail e SMS (Source Channel Type = CASE_LIST) também têm estes campos nulos — Lista de Casos não possui meta de nível de serviço.Atalho: se precisar do percentual de Nível de Serviço já calculado e agregado por fila e hora, consulte a entidade Service Level Information (campo
Service Level) — ela dispensa o cálculo manual a partir desta entidade.
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Is Service Level Ok |
Verdadeiro/Falso |
Indica se o tempo de espera na fila ficou dentro do limite configurado. |
|
Service Level Time Limit |
Número (ms) |
Tempo máximo de espera (em ms) configurado na fila no momento da criação do ciclo. Este valor é congelado na criação — alterações posteriores na configuração da fila não afetam ciclos já registrados. |
|
Service Level Percentage Limit |
Número |
Meta percentual de Nível de Serviço da fila (de 0 a 100) no momento da criação do ciclo. Compare com o percentual atingido para avaliar o desempenho. |
Campos de Controle e Auditoria
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Created At |
Data/Hora |
Data e hora em que o registro foi criado no sistema. |
|
Updated At |
Data/Hora |
Data e hora da última atualização no registro. Atualizado a cada evento aplicado ao ciclo. |
|
Deleted |
Verdadeiro/Falso |
Indica se o registro foi excluído. Sempre filtre por |
|
Deleted At |
Data/Hora |
Data e hora exatas em que o registro foi excluído. |
|
Active |
Verdadeiro/Falso |
Indica se o registro está ativo e válido no banco de dados. |
Entidade de suporte: Case Queue Cycle
O Case Queue Cycle é a linha do tempo de espera do caso — um registro por entrada em fila, incluindo as esperas que não chegaram a atendimento (abandonos antes da atribuição). É a única fonte para analisar casos que desistiram durante a espera.
Enquanto o Queued Case Information só tem registros de ciclos que chegaram à atribuição de um agente, o Case Queue Cycle mostra toda a jornada de fila, incluindo as esperas encerradas sem atendimento.
Estados possíveis de um registro
|
Estado |
Assigned At |
Cycle Closed At |
Tem registro no Queued Case Information? |
|---|---|---|---|
|
Em espera |
Nulo |
Nulo |
Não — ainda aguardando |
|
Abandono na fila |
Nulo |
Preenchido |
Não — saiu da fila sem ser atendido |
|
Atendido |
Preenchido |
Nulo (em andamento) ou Preenchido |
Sim — há um ciclo correspondente |
Campos principais
|
Campo |
Tipo |
Descrição |
|---|---|---|
|
Case Id |
Texto |
Identificador do caso. Chave de junção com o Queued Case Information. |
|
Distribution Rule Id |
Texto |
Fila da atribuição. Nulo enquanto o registro ainda está em espera. |
|
Enqueued At |
Data/Hora |
Entrada na fila de espera. |
|
Assigned At |
Data/Hora |
Momento da atribuição ao agente. Nulo se o caso ainda não foi ou nunca será atendido. |
|
Closed At |
Data/Hora |
Fim do registro (desatribuição, transferência ou encerramento do caso). Nulo = registro ainda em aberto. |
|
Opened At Enqueue |
Verdadeiro/Falso |
Mesma lógica do campo no Queued Case Information — indica se o registro nasceu de uma espera real. |