Estatísticas e relatórios de SMS pela API: totais por estado, créditos gastos e dias

WhatsApp e APIs·· 17 visualizações· 3 min de leitura

A resposta curta: GET /v1/sms/stats dá, para um período, quantas mensagens e partes saíram, os créditos gastos, os totais por estado e uma linha por cada dia com mensagens. Sem datas, conta os últimos 30 dias; o período máximo é de 366. Chega para um relatório mensal sem ter de somar mensagem a mensagem.

O pedido e a resposta

curl "https://api.mozout.co.mz/v1/sms/stats?from=2026-10-01&to=2026-10-31" \
-H "Authorization: Bearer prod_..."

Campo O que diz
from, to O período contado, de AAAA-MM-DD a AAAA-MM-DD.
messages Quantas mensagens houve no período.
parts Quantas partes somaram.
credits_spent Os créditos gastos. Não conta as mensagens falhadas, canceladas ou simuladas, nem as agendadas ainda por descontar.
by_status Os totais por estado: scheduled, queued, sending, sent, simulated, failed, cancelled.
by_day Uma linha por dia com mensagens: data, mensagens, enviadas, falhadas e créditos.

O que os números lhe dizem

Sinal O que quer dizer O que fazer
Muito mais partes do que mensagens Textos longos ou com acentos que passam a Unicode. Encurtar os textos: veja escrever SMS transaccionais.
Falhadas a subir Números errados na base de dados, ou um envio com problema. Ver os motivos das falhadas e limpar os números: limpar os números.
Um dia com o dobro do normal Um aviso repetido, ou uma campanha. Confirmar que o sistema não está a enviar o mesmo evento duas vezes.
Créditos gastos a subir mês a mês O negócio cresceu, ou há avisos a mais. Rever os escalões de compra: créditos e escalões.

Um relatório mensal automático

1 Crie uma chave só de leitura, com a permissão sms:read e nada mais.
2 No primeiro dia de cada mês, uma tarefa agendada pede GET /v1/sms/stats com o mês anterior em from e to.
3 Junta GET /v1/sms/balance, que dá o saldo em créditos, o limite diário, o que já saiu hoje e os créditos agendados ainda por descontar.
4 Envia o resumo por e-mail a quem decide as compras de créditos.
Prefere ver em vez de programar? O Histórico do SMS Center tem os separadores Mensagens, Campanhas e Saldo, com filtros por estado e por data. Veja histórico e agendamento.

Quer acompanhar o que os seus avisos gastam e entregam? Veja o SMS Transaccional.

Ver o SMS Transaccional

VEJA TAMBÉM

Histórico e agendamento de SMS: estados, filtros e o que acontece quando uma mensagem falha

Acompanhar cada SMS transaccional: o id da mensagem, o número tapado, os estados e o charged

Créditos de SMS e escalões de preço: como funciona a compra e como pagar menos por mensagem

Limpar os números de telefone da sua base de clientes antes de enviar SMS transaccionais

Escrever SMS transaccionais: o essencial primeiro, referências e valores, e numa só parte

Quantos créditos gasta um SMS: 160, 153, 70 e 67 caracteres explicados

PRODUTO RECOMENDADO

Hospedagem de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 396,00 MT/mês (plano de 3 anos, com cupão)

Ver planos
Esta resposta foi útil? A sua resposta ajuda-nos a melhorar este artigo.