Visão geral
Como medir o WhatsApp da loja: mensagens, custos da Meta, funil, anúncios, campanhas, orçamento e catálogo.
O WhatsApp só vale a pena se der para medir. Esta seção reúne as rotas de resultados: quantas mensagens saem e são lidas, quanto a Meta cobra, quantos cliques viram pedidos, qual anúncio compensa, como vão as campanhas, quanto da verba mensal foi usado e se o catálogo está em dia.
Como funciona
- Veja o panoramaVisão geral mostra volume e taxa de leitura; o funil mostra a conversão em pedidos.
- Controle o custoUso e custos separa mensagens de serviço, templates e pontos de entrada gratuitos, e estima o que passa da franquia.
- Defina um tetoEm Orçamento, fixe o limite mensal e, se quiser, pare as campanhas ao atingi-lo.
- Acompanhe as campanhas e o catálogoCampanhas e Catálogo da Meta mostram o que foi enviado e o que está sincronizado.
Conceitos-chave
Categorias de mensagem da Meta
| Categoria | O que é | Cobrança |
|---|---|---|
Serviço (SERVICE) | Resposta a um cliente dentro da janela de 24 horas | Gratuita até a franquia mensal; depois cobrada |
Utilidade (UTILITY) | Template transacional (pedido enviado) | Por mensagem |
Marketing (MARKETING) | Template promocional | Por mensagem |
Autenticação (AUTHENTICATION) | Template de código | Por mensagem |
| Ponto de entrada gratuito | Respostas nas 72 horas após um anúncio que leva ao WhatsApp | Gratuita |
Coexistência e economia
Quando uma pessoa responde pelo aplicativo WhatsApp Business (origem E), a mensagem não passa pela API. Em Custos o campo savings estima quanto isso economiza.
Tempo
Os relatórios mensais usam o fuso America/Sao_Paulo. Datas dos demais campos em RFC 3339 (UTC).
Endpoints
| Método | Caminho | Para que serve |
|---|---|---|
| GET | /api/v1/vendor/whatsapp-confluence/analytics/overview | Indicadores, série diária e origem das mensagens. Visão geral, funil e anúncios |
| GET | /api/v1/vendor/whatsapp-confluence/analytics/funnel | Do clique no link ao pedido, por canal. Visão geral, funil e anúncios |
| GET | /api/v1/vendor/whatsapp-confluence/analytics/roas | Retorno por anúncio que leva ao WhatsApp. Visão geral, funil e anúncios |
| GET | /api/v1/vendor/whatsapp-confluence/analytics/costs | Custo diário, projeção e economia da coexistência. Uso e custos |
| GET | /api/v1/vendor/whatsapp-confluence/analytics/usage | Mensagens enviadas no mês, por categoria e conta. Uso e custos |
| GET | /api/v1/vendor/whatsapp-confluence/campaigns | Lista as campanhas da loja. Campanhas |
| GET | /api/v1/vendor/whatsapp-confluence/analytics/campaigns | As 20 campanhas com mais envios e o custo estimado. Campanhas |
| GET | /api/v1/vendor/whatsapp-confluence/budget | Retorna o orçamento e o gasto do mês. Orçamento mensal |
| PUT | /api/v1/vendor/whatsapp-confluence/budget | Define o orçamento mensal. Orçamento mensal |
| GET | /api/v1/vendor/whatsapp-confluence/catalog/status | Resume a sincronização do catálogo. Catálogo da Meta |
| GET | /api/v1/vendor/whatsapp-confluence/catalog/items | Lista os itens e o estado de sincronização. Catálogo da Meta |
Erros comuns
- Tratar
404 disabledcomo erro de rota. É o recurso de analytics desligado na loja; ligueenable_analyticsnos ajustes. - Passar
month=2026-9. O formato exige dois dígitos (2026-09); caso contrário vem 400. - Somar
cost_centseestimate_microscomo se fossem a mesma unidade. Um é centavos, o outro milionésimos de real. - Esperar que o seller veja só os próprios números. Exceto o uso mensal, o resto cobre a loja.
- Gravar o orçamento sem reenviar o limite. O
PUTsubstitui tudo: o limite omitido é removido. - Achar que o teto rígido bloqueia o atendimento. Ele só pausa campanhas.