Visão Geral: Queued Case Information

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 At preenchido 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ão COUNT(*).


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 COUNT(DISTINCT Case Id) para contar atendimentos únicos — COUNT(*) conta ciclos (uma linha por fila visitada). Campo obrigatório — é a chave de relacionamento com o Case Information e demais entidades.

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 (Opened At Enqueue = false).

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 (true) ou se a atribuição aconteceu diretamente, sem espera registrada (false). Quando false, os campos Enqueued At, Queue Time e Is Service Level Ok ficam nulos.

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 Current Channel. Permite rastrear quando e se houve mudança de canal durante o ciclo.


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 Enqueued At até Assigned At. Nulo quando a espera não foi mensurada (Opened At Enqueue = false). Use a média deste campo para calcular o TME (Tempo Médio de Espera) por fila.

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 (Call End Date) até o encerramento do ciclo. Nulo em ciclos de chat e e-mail — apenas voz gera pós-atendimento.

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: Attendance Time − Ringing Time.


Tempos de Resposta (Chat)

Os campos Response Time e Customer Response Time sã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: SUM(Sum Response Time) ÷ SUM(Count Response).

Count Response

Número

Quantidade de respostas do agente medidas no ciclo. É o divisor correto de Sum Response Time.

Response Time

Número (ms)

Média do tempo de resposta do agente calculada dentro do ciclo (Sum Response Time ÷ Count Response). Não agregue entre ciclos com AVG — use a soma e a contagem.

Sum Customer Response Time

Número (ms)

Soma de todos os tempos de resposta do cliente no ciclo. Para a média entre ciclos: SUM(Sum Customer Response Time) ÷ SUM(Count Customer Response Time).

Count Customer Response Time

Número

Quantidade de respostas do cliente medidas no ciclo. É o divisor correto de Sum Customer Response Time.

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êm Is Service Level Ok nulo 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. true = dentro do prazo; false = fora do prazo; null = nível de serviço não aplicável (espera não mensurada ou canal sem nível de serviço). Para calcular o percentual de nível de serviço: contagem de true ÷ contagem de registros onde o campo não é nulo.

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 = false para garantir a integridade dos dados.

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.