Visão Geral: Case Delivery Summary

A entidade Case Delivery Summary (Resumo de Entrega do Caso) registra cada movimentação que um atendimento sofreu ao longo de sua jornada na plataforma — filas pelas quais passou, transferências, atribuições e abandonos.

Qual a diferença para o Case Information? O Case Information mostra a foto final do atendimento: tempos consolidados, status e resultado. O Case Delivery Summary mostra o filme completo: cada passo do roteamento, com início, fim, duração e motivo de cada etapa. São entidades complementares.

Quando usar: Use o Case Delivery Summary para investigar gargalos operacionais. Se o tempo de espera de um caso foi alto, cruze com esta entidade para descobrir em qual fila específica o cliente ficou mais tempo aguardando — e qual regra de roteamento o manteve ali.

O que está consolidado nesta entidade?

Categoria	O que você encontra
Histórico de movimentação	Cada etapa do roteamento: entrada em fila, transferência, atribuição a agente, abandono
Tempo por etapa	Data/hora de início e fim de cada etapa, e a duração calculada em segundos
Motivo da movimentação	O gatilho que causou o evento (entrega automática, transferência, abandono, encerramento, etc.)
Regra de roteamento	Qual regra de distribuição foi ativada para direcionar o caso naquela etapa
SLA por etapa	Se a meta de nível de serviço foi cumprida naquela etapa específica

Como os registros são criados?

Cada registro desta entidade representa uma etapa na jornada de um caso. Um único atendimento pode gerar múltiplos registros — um para cada vez que o caso entrou em uma fila, foi transferido, atribuído a um agente ou sofreu qualquer outra movimentação de roteamento.

Exemplo: Um cliente entra pelo WhatsApp → aguarda na fila de Suporte → é transferido para a fila de N2 → é atribuído a um agente. Esse atendimento gerará ao menos 3 registros no Case Delivery Summary, um para cada etapa.

Exemplos práticos de uso

Pergunta: Em qual fila os clientes esperam mais tempo antes de serem atendidos? → Filtre Type = QUEUE (ou equivalente de entrada em fila), agrupe por Distribution Rule Id e calcule a média de Duration.

Pergunta: Quantos atendimentos foram abandonados na fila de voz nesta semana? → Filtre Cause = ABANDON e o intervalo de Started At, contando os valores distintos de Case Id.

Pergunta: Quais casos passaram por mais de 3 etapas de roteamento hoje? → Agrupe por Case Id, conte os registros e filtre onde a contagem ultrapassa 3.

Pergunta: Qual regra de distribuição mais resulta em transferências de BOT para humano? → Filtre Cause = CASE_TRANSFERRED, agrupe por Distribution Rule Id e ordene por volume decrescente.

Dicionário de Campos

Identificação do Caso e do Cliente

Campo	Tipo	Descrição
Case Id	Texto	Identificador único do atendimento ao qual esta etapa pertence. Campo obrigatório — é a chave de relacionamento com o Case Information e demais entidades de caso. Um mesmo `Case Id` pode aparecer em múltiplos registros, um para cada etapa da jornada.
Person Id	Texto	Identificador único do cliente (solicitante) associado a este atendimento.
User Id	Texto	Identificador do agente que recebeu ou interagiu com o caso nesta etapa específica. Pode estar vazio em etapas de fila onde nenhum agente foi atribuído ainda.

Canal de Comunicação

Campo	Tipo	Descrição
Channel	Texto	Nome do canal de comunicação associado a esta etapa (ex: WhatsApp, Voz, WebChat). Campo obrigatório.
Channel Type	Texto	Categoria tecnológica do canal utilizado: Chat, Voz, E-mail, entre outros. Campo obrigatório.

Tempo e Duração da Etapa

Campo	Tipo	Descrição
Started At	Data/Hora	Data e hora exatas em que esta etapa de entrega teve início. Campo obrigatório — é o principal campo para análises temporais desta entidade.
Finished At	Data/Hora	Data e hora exatas em que esta etapa foi concluída (caso movimentado, atendido ou encerrado).
Duration	Número	Tempo total (em segundos) que o caso permaneceu nesta etapa, calculado entre `Started At` e `Finished At`. Use este campo para identificar filas lentas ou etapas com tempo de espera acima do esperado.

Roteamento e Motivo da Movimentação

Campo	Tipo	Descrição
Type	Texto	O tipo de evento de roteamento que este registro representa — por exemplo, entrada em uma fila, transferência entre filas ou atribuição a um agente específico. Campo obrigatório.
Distribution Rule Id	Texto	Identificador da regra de distribuição (roteamento) que foi ativada para direcionar o caso nesta etapa. Permite identificar qual configuração de roteamento está gerando filas longas ou muitas retransferências.
Cause	Texto	O gatilho ou motivo que gerou esta etapa de entrega. Veja os valores possíveis na tabela abaixo.

Valores possíveis para o campo `Cause`

Valor	Descrição
DELIVERED	O atendimento foi entregue automaticamente pelo sistema de roteamento, seguindo as regras configuradas.
CASE_ASSIGNED	O atendimento foi delegado manualmente por um supervisor ou gestor e atribuído diretamente a um agente.
CASE_TRANSFERRED	O caso saiu do BOT e foi transferido para uma fila humana por meio da Function de transferência no workflow.
ABANDON	O cliente encerrou o contato ou desligou a chamada antes de ser atendido por um agente humano. Ocorre no canal de Voz.
CASE_CLOSED	A entrega foi interrompida porque o caso foi encerrado por uma automação ou por um usuário antes de ser atendido.
NOT_READY_TO_DELIVERY	O caso saiu da fila no momento da tentativa de entrega porque não estava mais em condição de ser atendido. Isso ocorre quando o caso estava: fechado, em andamento (já atribuído a outro agente), expirado, inativo ou deletado.

Nível de Serviço (SLA)

Campo	Tipo	Descrição
Is Service Level Ok	Verdadeiro/Falso	Indica se a meta de Nível de Serviço (SLA) foi cumprida para esta etapa específica do roteamento. `true` = dentro do prazo; `false` = fora do prazo. Diferente do SLA consolidado do Case Information, este campo permite identificar em qual etapa da jornada o SLA foi quebrado.

Campos de Controle e Auditoria

Campo	Tipo	Descrição
Created at	Data/Hora	Data e hora em que o registro desta etapa foi criado no sistema.
Created by	Texto	Sistema ou usuário responsável pela criação do registro.
Updated at	Data/Hora	Data e hora da última atualização feita neste registro.
Updated by	Texto	Usuário ou sistema que realizou a última atualização.
Deleted	Verdadeiro/Falso	Indica se o registro foi excluído do sistema.
Deleted at	Data/Hora	Data e hora exatas em que o registro foi excluído.
active	Verdadeiro/Falso	Indica se este registro de entrega está ativo e válido no banco de dados.