Skip to main content
GET
Analytics de tickets do Talk (componentes aditivos)
Retorna linhas no grão dia / semana / mês × dimensão com componentes aditivos dos tickets do Talk. Contagens: tickets_created_count, tickets_closed, tickets_in_service, redistributed_timeout, total_messages.
Toda métrica de SLA vem como par soma+contagem — nunca a média pronta: time_to_assignment_sum_seconds/_count, first_response_sum_seconds/_count, handle_time_sum_seconds/_count. As somas estão em segundos: divida pela contagem para a média (e por 60 para minutos).
Os dados têm até ~6h de defasagem — veja as_of / stale e o header X-Data-As-Of. tickets_in_service é um retrato pontual (um ticket muda de estado numa execução posterior). CSAT e produto entram numa versão futura.

Authorizations

Authorization
string
header
required

Workspace API key no formato mk_..., gerada na plataforma em Integrações → Configurar API.

Path Parameters

granularity
enum<string>
required

Tamanho do balde. Um de: day, week (segunda-feira ISO), month.

Available options:
day,
week,
month

Query Parameters

from
string<date>

Data ISO (limite inferior, inclusivo). Padrão: 30 dias atrás.

to
string<date>

Data ISO (limite superior, exclusivo). Padrão: agora.

tz
string
default:America/Sao_Paulo

Timezone IANA para o agrupamento por dia. Padrão: America/Sao_Paulo.

group_by
string

Lista separada por vírgulas das dimensões permitidas: queue, queue_name, agent, agent_name, status, source.

queue
string

Filtro: lista separada por vírgulas de ids de fila (queue_id).

agent
string

Filtro: lista separada por vírgulas de ids de usuário do atendente (agent_user_id).

status
string

Filtro: lista separada por vírgulas de status (waiting, in_service, redistributed, closed).

source
string

Filtro: lista separada por vírgulas de origens do ticket.

Response

Linhas agregadas de componentes aditivos (contagens e pares soma+contagem).

granularity
string
required

Granularidade aplicada (day, week ou month).

tz
string
required

Timezone IANA usado no agrupamento.

from
string
required

Limite inferior efetivo da janela.

to
string
required

Limite superior efetivo da janela.

as_of
string | null
required

Momento (ISO 8601) da última execução de ETL bem-sucedida deste metricset; null quando desconhecido.

stale
boolean
required

true quando os dados estão defasados (mais que ~2× a cadência de 6h) ou o frescor é desconhecido.

group_by
string[]
required

Dimensões aplicadas no agrupamento.

data
object[]
required

Uma linha por balde × combinação de dimensões. Cada dimensão de group_by aparece como uma chave adicional na linha. Para cada média/SLA, divida _sum por _count (e, para os gráficos em minutos, divida ainda por 60 usando as versões _sec_).

count
integer
required

Número de linhas em data.