/analytics
Os números do atendimento, para você colocar no painel que a sua empresa já usa.
Escopo necessário: analytics:read. Limite: 60 requisições por minuto.
| Método | Rota | Devolve |
|---|---|---|
| GET | /analytics/overview |
Visão geral da organização |
| GET | /analytics/agents/{id} |
O mesmo recorte, para um agente |
Ambos aceitam from e to em ISO 8601. Sem eles, o período é os últimos 30 dias.
curl "https://api.wevi.chat/functions/v1/analytics/overview?from=2026-08-01&to=2026-08-31" \
-H "Authorization: Bearer wevi_SUA_CHAVE"
const url = new URL("https://api.wevi.chat/functions/v1/analytics/overview");
url.searchParams.set("from", inicioDoMes);
const res = await fetch(url, { headers: { Authorization: "Bearer wevi_SUA_CHAVE" } });
const m = await res.json();
console.log(`Transbordo em ${(m.handoff.rate * 100).toFixed(1)}% das conversas`);
Resposta
{
"period": { "from": "2026-08-09T00:00:00Z", "to": "2026-09-08T00:00:00Z" },
"conversations": {
"total": 263,
"resolved": 41,
"open": 222,
"by_channel": { "whatsapp": 190, "web": 72, "api": 1 },
"from_ads": 53
},
"messages": { "inbound": 411, "outbound": 491, "total": 902 },
"handoff": { "requested": 26, "taken_over": 19, "rate": 0.099 },
"ratings": { "count": 132, "average": 4.84 },
"sentiment": { "positive": 171, "neutral": 64, "negative": 14 },
"conversion_events": { "agendou": 37, "pediu_orcamento": 12 }
}
O número que mais diz sobre o agente é handoff.rate: a fatia das conversas que precisou de gente. Caindo mês a mês, o agente está resolvendo mais sozinho.
from_ads conta as conversas que nasceram de um anúncio com clique para o WhatsApp, útil para cruzar com o investimento em mídia.