Log de envio de boletos#
Você disparou os boletos e o telefone não tocou como esperado. Ou tocou demais. Este registro é onde se descobre o que realmente saiu, para quem, e o que falhou.
O que ele registra#
Cada envio, com o cliente, o resultado e o motivo quando falhou.
É o único lugar onde as três perguntas do dia seguinte têm resposta:
- Quantos receberam de fato?
- Quem não recebeu?
- Por quê?
Como fazer#
- Vá em Configurações → Log de envio de boletos.
- Filtre pelo período do disparo.
- Separe os que falharam.
- Agrupe as falhas por motivo — elas quase sempre se concentram em dois ou três.
Os motivos de falha mais comuns#
| Motivo | O que significa | O que fazer |
|---|---|---|
Janela de 24 horas (131047) | O disparo saiu como texto livre em vez de modelo | Configurar modelo aprovado |
Número sem WhatsApp (131026) | O cadastro tem um número que não tem WhatsApp | Corrigir o cadastro no ERP |
Limite de marketing (131049) | O modelo está classificado como MARKETING | Reclassificar como UTILITY |
Optou por não receber marketing (131050) | O cliente recusou marketing | Só UTILITY chega a ele |
Modelo não aprovado (132001) | O modelo não existe naquele idioma ou não foi aprovado | Conferir o cadastro do modelo |
A lista completa está em Erros comuns da Cloud API.
O que fazer com as falhas#
Falha de cadastro — número errado, sem WhatsApp — é trabalho de correção no ERP, e é recorrente: os mesmos clientes vão falhar no mês que vem. Vale levar a lista para quem mantém o cadastro.
Falha de configuração — categoria errada, modelo faltando — é conserto único que evita a falha em todos os disparos seguintes.
Falha de conta — limite, pagamento, bloqueio — é assunto da conta na Meta, não do disparo.
Confira o log depois de todo disparo#
Um disparo que "correu bem" com 30% de falha silenciosa é um disparo em que 30% dos seus clientes não foram avisados do vencimento — e você vai descobrir isso pelo telefone tocando na semana seguinte.
Cinco minutos de leitura no dia seguinte evitam isso.
Se algo der errado#
O log está vazio depois do disparo. O disparo pode não ter rodado. Confira se o agendamento está ativo e se houve fatura na condição configurada.
Todos falharam com o mesmo código. É configuração, não cadastro. Conserte antes de tentar de novo.
O log mostra sucesso e o cliente diz que não recebeu. Sucesso significa aceito pelo canal. Confira o status daquela mensagem específica — veja Status de mensagem.
Clientes receberam duas vezes. Confira se não houve dois disparos no mesmo dia — o agendado e um manual.