Envio ativo de boletos: configurar, testar com a prévia e disparar#
O envio de boletos busca as faturas no ERP e manda a mensagem para os clientes. É o recurso mais útil e o mais perigoso do sistema: ele fala com a sua base inteira, e não há desfazer.
Leia a página toda antes de ligar.
Antes de começar#
- A integração com o ERP precisa estar funcionando — é dela que vêm as faturas.
- O canal de envio precisa estar conectado.
- No WhatsApp oficial, você precisa de modelo aprovado: o disparo acontece fora da janela de 24 horas por definição, porque o cliente não escreveu antes. Veja A janela de 24 horas.
Os dois textos, e por que são dois#
Há um texto para o boleto a vencer e outro para o vencido. Eles são campos separados de propósito: trocar o modo e esquecer de reescrever o texto mandaria "vence em 11/08" no dia 18.
O texto padrão de a vencer:
Olá {{nome}}, seu boleto de R$ {{valor}} vence em {{data_vencimento}}.
Linha digitável: {{linha_digitavel}}
{{url_boleto}}
O de vencido diz outra coisa, e inclui a ressalva que evita a maior parte das reclamações: se o cliente já pagou, é só desconsiderar. Pagamento leva tempo para compensar, e a mensagem de cobrança que chega depois do pagamento é a que mais irrita.
As variáveis disponíveis#
| Variável | O que traz |
|---|---|
{{nome}} | Nome do cliente |
{{valor}} | Valor da fatura |
{{data_vencimento}} | Data de vencimento |
{{linha_digitavel}} | Linha digitável do boleto |
{{url_boleto}} | Link do boleto, quando disponível |
{{codigo_barras}} | Código de barras |
{{dias_em_atraso}} | Dias desde o vencimento — só no texto de vencido |
{{dias_em_atraso}} não faz sentido antes de vencer: não há atraso a contar.
Quantos dias antes#
O envio é configurado por antecedência, entre as opções oferecidas: 1, 2, 3, 5, 7, 10, 15, 20 ou 30 dias.
Escolher bem importa mais do que parece. Muito cedo, o cliente esquece. Muito tarde, não dá tempo de pagar sem juros. Três dias antes é o ponto em que a maioria dos provedores fica, mas confira o seu ciclo de compensação.
Como fazer#
- Vá em Configurações → Envio de boletos.
- Escolha a integração de onde vêm as faturas e o canal de envio.
- Escreva os dois textos.
- Escolha os dias de antecedência.
- Use a prévia. Ela mostra a mensagem montada com dados reais, como o cliente vai receber.
- Faça um teste com o seu próprio número antes de qualquer disparo.
- Só então ligue o envio automático, ou dispare manualmente.
A prévia não é opcional#
O passo 5 existe porque os erros deste recurso são invisíveis no campo de texto e óbvios na mensagem montada:
- Variável escrita errada, que chega literal como
{{valor}}. - Valor com formato estranho.
- Link do boleto vazio, porque aquele ERP não devolve link.
- Texto de vencido usado no envio de a vencer.
Cada um desses erros, disparado para a base inteira, gera uma onda de mensagens no atendimento no mesmo minuto.
O que acontece se você errar#
Este recurso dispara para todos os clientes com fatura na condição configurada. Uma vez enviada, a mensagem está no celular do cliente: não há como recolher.
Os estragos possíveis, em ordem de gravidade:
- Cobrar quem já pagou. Gera reclamação e desgasta a confiança na comunicação da empresa.
- Mandar o valor errado. Gera pagamento errado e trabalho de estorno.
- Mandar duas vezes. Confira se não há outro disparo agendado para o mesmo dia.
- Disparar em horário inadequado. Boleto às 22h não é bem recebido.
Antes de um primeiro disparo em produção, considere restringir a um grupo pequeno e conferir o resultado — veja o registro de tudo que saiu em Log de envio de boletos.
Se algo der errado#
A mensagem chega com {{valor}} escrito. Variável com grafia errada. Confira contra a tabela acima.
O link do boleto vem vazio. Aquele ERP não devolve link. Tire {{url_boleto}} do texto e deixe a linha digitável.
Nada é enviado. Confira a integração, o canal e — no WhatsApp oficial — se existe modelo aprovado para o disparo.
Alguns clientes recebem e outros não. Confira o registro de envio: números inválidos, clientes sem WhatsApp e bloqueios aparecem lá.
O texto de vencido foi para quem não venceu. Os dois campos foram preenchidos com o mesmo texto. Corrija e confira na prévia.