Régua de Cobrança
Como automatizar lembretes e avisos de cobrança por E-mail e WhatsApp, configurando templates, envio global e regras por vencimento - inclusive o aviso ao vendedor, com a lista dos títulos dos clientes dele que vão vencer, e o passo que cobra todos os vencidos do cliente numa mensagem só.
Quando usar
Use quando precisar executar a rotina de Financeiro: Cobrança no ERP.
Antes de começar
- Módulo Financeiro ativo, com títulos a receber cadastrados
- Contatos do cliente habilitados para E-mail e WhatsApp Boleto
- Servidor de e-mail (SMTP) disponível para os disparos
- Para o aviso ao vendedor: o celular (e, para o canal e-mail, o e-mail) no cadastro de cada vendedor, com o cadastro ativo
Visão geral
A Régua de Cobrança é uma ferramenta automatizada do HAP Tecnologia para gerenciar o ciclo de notificações de pagamento: ela envia lembretes antes, no dia ou após o vencimento, por E-mail e WhatsApp, sem que ninguém precise disparar cada mensagem manualmente.
Quando utilizar:
- Lembrar o cliente antes do vencimento (régua Preventiva), reduzindo esquecimentos e atrasos.
- Avisar sobre títulos vencidos em dias definidos após o vencimento (régua Reativa).
- Enviar o boleto em PDF anexado à mensagem, quando o título tiver boleto.
- Padronizar a comunicação de cobrança entre as empresas do grupo, respeitando feriados e fins de semana.
A tela da Régua de Cobrança tem quatro abas. Uma boa ordem de configuração é seguir a sequência abaixo:
| Etapa | O que fazer | Onde |
|---|---|---|
| 1. Templates | Revisar ou criar os modelos de mensagem de E-mail e WhatsApp | Aba Templates |
| 2. Envio | Definir o SMTP global, as regras de calendário e os avisos de falha | Aba Configuração de envio |
| 3. Régua | Criar a régua: identificação, regras de envio e configuração específica | Aba Regras > Nova régua |
| 4. Acompanhamento | Conferir envios, falhas e taxa de sucesso | Aba Painel |
Painel principal e indicadores
- 1
Acesse o menu Configurações > Finanças > Régua de Cobrança. A tela abre no dashboard principal, com os indicadores no canto superior direito, as abas de navegação logo abaixo e a lista de réguas.
Indicadores do ciclo de cobrança, abas Regras, Painel, Templates e Configuração de envio, e o botão Nova régua - 2
Confira os indicadores do topo.
| Indicador | Significado |
|---|---|
| Regras ativas | Quantidade de fluxos de cobrança (réguas) em operação; a régua pausada não entra na conta |
| Envios (30 dias) | Volume total de notificações disparadas no último mês |
| Falhas recentes | Envios que falharam recentemente; o detalhe fica na aba Painel |
| Taxa de sucesso | Percentual de mensagens entregues corretamente |
| Aba | O que mostra |
|---|---|
| Regras | Lista todas as automações (réguas) criadas, com busca por nome ou tipo e botão Nova régua |
| Painel | Gráficos e indicadores detalhados de envios, falhas e sucessos |
| Templates | Biblioteca de modelos de mensagens de E-mail e WhatsApp |
| Configuração de envio | Ajustes técnicos de servidor de e-mail e de calendário |
Enquanto nenhuma régua existir, a aba Regras exibe a mensagem "Nenhuma régua de cobrança cadastrada. Clique em Nova régua para começar."
Acompanhar os envios
Com as réguas em funcionamento, use a aba Painel para conferir o que foi enviado.
- 1
Escolha o Período (por exemplo, Últimos 30 dias) e o Status, e clique em Atualizar.
Aba Painel com filtros, indicadores do período, lista de envios e top de clientes notificados - 2
Veja a seção Indicadores, com o resumo dos envios do período selecionado.
- 3
Consulte Envios no período, a lista detalhada dos envios disparados pelas réguas.
- 4
Consulte Top clientes notificados, com os clientes que mais receberam mensagens no período.
| Indicador | Significado |
|---|---|
| Total enviado | Quantidade de mensagens disparadas no período filtrado |
| Sucessos | Mensagens entregues corretamente |
| Falhas | Mensagens que não foram entregues |
| Taxa de sucesso | Percentual de sucessos sobre o total enviado |
| Pulado feriado | Disparos não enviados por cair em feriado (estratégia de dia não-útil) |
| Pulado fim semana | Disparos não enviados por cair em sábado ou domingo (estratégia de dia não-útil) |
Biblioteca de templates
Na aba Templates ficam os modelos de mensagem usados pelas réguas, separados em Templates de E-mail e Templates de WhatsApp. Use Novo template para criar um modelo do zero.
Ao lado da busca há o filtro por tipo. Os modelos com o selo Padrão Hap são classificados como Preventiva ou Reativa.
| Canal | Características |
|---|---|
| Mensagem em HTML com design rico, editável no modo Visual ou no modo HTML, com assunto próprio | |
| Texto puro com variáveis; a formatação simples (negrito, itálico) é exibida na pré-visualização |
O sistema já traz modelos prontos, com o selo Padrão Hap, para cada momento da cobrança, por exemplo "Preventiva 3 dias antes" ou "Reativa 5 dias após". Cada modelo mostra o tipo (Preventiva ou Reativa) e o prazo em relação ao vencimento.
Ao abrir um template, o editor mostra a lista da biblioteca com o modelo selecionado ao lado.
Os campos são Nome, Tipo e Dias de referência, mais o Assunto do e-mail. Você pode alternar entre o modo Visual e o modo HTML do editor e usar os botões Fechar e Duplicar. No lado direito da tela de edição, a pré-visualização mostra, com dados de exemplo, como a mensagem aparecerá no dispositivo do cliente antes de você salvá-la.
Para personalizar a mensagem, use variáveis (tags): campos dinâmicos entre chaves duplas. O sistema preenche esses dados automaticamente para cada cliente e título no momento do envio. No editor, o botão Inserir variável (ícone {{ }}) ajuda a escolher a tag desejada.
| Variável | O que preenche |
|---|---|
| {{cliente.primeiro_nome}} | Primeiro nome do cliente |
| {{cliente.documento}} | CNPJ/CPF do cliente |
| {{titulo.numero}} | Número do título/documento |
| {{titulo.valor_formatado}} | Valor do título já formatado (ex.: R$ 1.234,56) |
| {{titulo.data_vencimento}} | Data de vencimento (ex.: 14/05/2026) |
| {{titulo.data_vencimento_extenso}} | Data de vencimento por extenso (ex.: 14 de maio de 2026) |
| {{titulo.data_emissao}} | Data de emissão do título |
| {{saudacao}} | Saudação da mensagem (ex.: "Boa tarde") |
| {{empresa.nome}} | Nome da empresa que está cobrando |
| {{empresa.endereco}}, {{empresa.email}}, {{empresa.telefone}}, {{empresa.site}} | Dados de contato da empresa, usados na assinatura da mensagem |
Configurações globais de envio
Na aba Configuração de envio você define as regras de "etiqueta" e a parte técnica dos disparos. Elas valem para todas as réguas que estiverem usando a configuração global (veja Configuração específica da régua).
- 1
Em SMTP global, informe o servidor de e-mail que fará os disparos: E-mail, Servidor SMTP, Porta e Usuário, e clique em Configurar SMTP. Ele é usado por todas as réguas com "Usar configuração global" ativado. Cada régua ainda pode sobrescrever essa configuração com um SMTP próprio.
- 2
Em Calendário, escolha as opções: - Não enviar em feriados: considera o calendário cadastrado em Configurações > Feriado. - Não enviar em fins de semana: evita cobranças em sábado e domingo, útil para cobranças B2B com expediente comercial.
- 3
Defina a Estratégia em dia não-útil, que decide o que acontece quando o disparo cair em um dia não-útil.
- 4
Em Notificações de falha, escolha como ser avisado: - Notificar falhas no sino do header: quando a régua falhar, aparece um alerta vermelho no sino do ERP; ao clicar, abre o painel já filtrado. - E-mail extra para alertas (opcional): endereço que também receberá o aviso quando uma mensagem não for entregue.
- 5
Clique em Salvar configuração. Use Recarregar para descartar alterações e voltar aos valores salvos.
| Estratégia | O que acontece |
|---|---|
| Adiar para próximo dia útil | A mensagem que cairia no sábado, no domingo ou no feriado sai no primeiro dia útil seguinte, no horário da regra |
| Pular o disparo | Não envia nem reagenda: aquele disparo é descartado |
Como o Adiar trata cada caso:
- Se mais de uma regra da mesma régua caiu nos dias sem envio para o mesmo título (por exemplo, 1, 2 e 3 dias depois do vencimento num fim de semana prolongado), sai só a mais recente: o cliente recebe uma mensagem daquele título, não três.
- Na régua Preventiva, o lembrete adiado só sai se o título ainda não venceu. Um "vence amanhã" que chegaria depois do vencimento não é enviado.
- Com Não enviar em feriados ligado, o sábado e o domingo também ficam sem envio, mesmo com Não enviar em fins de semana desligado.
Criar uma nova régua: identificação
Na aba Regras, clique em Nova régua. A criação segue três etapas, que correspondem às abas do topo da tela:
| Etapa | Aba | O que define |
|---|---|---|
| Passo A | Geral | Identificação: nome, tipo da cobrança e empresas |
| Passo B | Regras de envio | Agendamento: quando e por qual canal a mensagem sai, com qual template |
| Passo C | Configuração de envio | Ajustes exclusivos da régua, se ela não for usar as regras globais |
Passo A: preencha a identificação na aba Geral.
| Campo | Como preencher |
|---|---|
| Descrição (obrigatório) | Dê um nome interno para a régua (ex.: "Cobrança Clientes Varejo") |
| Tipo da Cobrança (obrigatório) | Preventiva: dispara lembretes antes do vencimento. Reativa: dispara alertas após o vencimento |
| Empresas | Selecione quais empresas do grupo utilizarão esta régua; só os recebíveis delas geram disparos |
Depois de preencher, use o botão Salvar régua.
Regras de envio
No Passo B você define o "quando" e o "como". Na aba Regras de envio, clique em Adicionar regra: abre-se o painel lateral Nova regra de envio, com as abas Agendamento, E-mail e WhatsApp. Crie uma regra para cada momento de envio desejado (por exemplo, 3 dias antes e 1 dia antes do vencimento).
Na aba Agendamento, defina quando a mensagem sai.
| Campo | Como usar |
|---|---|
| Quando enviar | Escolha quantos dias antes ou depois do vencimento a mensagem sai (ex.: 1 dia antes, 3 dias antes, 5 dias depois) |
| Horário de envio | Defina o horário do disparo (ex.: 07:55) |
| Reenviar boleto? | Ative para que o sistema anexe automaticamente o PDF do boleto na mensagem. Se a conta bancária imprime em Carnê, vai o boleto só daquela parcela, não o carnê inteiro |
Na mesma aba, "Para quem" decide quem recebe a mensagem daquela regra: Cliente (o padrão, a cobrança de sempre) ou Vendedor (a lista dos títulos dos clientes dele; veja "Aviso ao vendedor", mais abaixo).
Ative as abas E-mail e/ou WhatsApp conforme os canais que a régua deve usar. Em cada canal, a chave Disparo de e-mail ativo (ou Disparo de WhatsApp ativo) liga ou desliga o envio por aquele canal.
Canal E-mail: em Aplicar template, escolha um modelo da biblioteca. Ele preenche o assunto e o corpo da mensagem, que ainda podem ser ajustados para aquela regra.
Preencha o Assunto do e-mail (obrigatório), que também aceita variáveis. Use o modo Visual ou HTML e o botão Inserir variável, e confira a pré-visualização com dados de exemplo.
Canal WhatsApp: em Aplicar template, escolha um modelo de WhatsApp.
A mensagem é em texto puro, com variáveis e emojis, e o botão Inserir variável ajuda a montá-la. A formatação é simples: negrito e itálico são renderizados na pré-visualização.
Ao terminar, clique em Salvar regra (canto superior direito do painel) e, de volta à tela da régua, em Salvar régua.
Aviso ao vendedor: os títulos que vão vencer
Muita loja quer que o vendedor ligue para o cliente antes do vencimento. A regra com "Para quem: Vendedor" faz isso: ela pega os mesmos títulos que pegaria para os clientes (dias, empresa e formas de pagamento da régua), agrupa por vendedor e manda uma mensagem por dia para cada vendedor, com a lista dos títulos dos clientes dele. O cliente não recebe nada por essa regra, e o boleto não vai.
- 1
Crie uma régua só para o aviso, do tipo Preventiva, por exemplo "Aviso ao vendedor", e marque a empresa no quadro Empresas. O tipo vale para a régua inteira: a cobrança do cliente depois do vencimento fica numa régua Reativa, e o aviso ao vendedor antes do vencimento nesta régua Preventiva.
A régua "Aviso ao vendedor", aba Geral, com o tipo Preventiva escolhido. - 2
Em Regras de envio, clique em Adicionar regra. Na aba Agendamento, escolha Para quem: Vendedor, Quando enviar: 2 dias antes do vencimento, e o horário de envio. O quadro "Aviso ao vendedor" explica o que a regra faz.
Nova regra de envio: Para quem Vendedor, 2 dias antes do vencimento, às 08:00, e o quadro Aviso ao vendedor com o botão "Usar texto de exemplo no WhatsApp". - 3
Na aba WhatsApp, ligue o disparo e clique em "Usar texto de exemplo": a mensagem já vem com as variáveis do vendedor. Ajuste o texto e confira a pré-visualização.
A mensagem do aviso ao vendedor com as variáveis {{vendedor.primeiro_nome}}, {{lista}} e {{total_formatado}}, e a pré-visualização com um exemplo de lista de títulos. - 4
Clique em Salvar regra. Na lista, a regra aparece com o selo "Para o vendedor". Depois clique em Salvar régua.
A regra "2 dia(s) antes do vencimento, às 08:00" com os selos Para o vendedor e WhatsApp.
Na lista de réguas, a régua do aviso aparece separada da cobrança do cliente, com o tipo Preventiva, o canal e a primeira regra ("2 dia(s) antes").
| Variável | O que preenche |
|---|---|
| {{vendedor.primeiro_nome}} | Primeiro nome do vendedor |
| {{vendedor.nome}} | Nome completo do vendedor |
| {{lista}} | Uma linha por título: cliente, documento, valor e vencimento (até 30 linhas, depois "e mais N") |
| {{quantidade}} | Quantos títulos estão na lista |
| {{total_formatado}} | A soma dos títulos da lista |
| {{titulo.data_vencimento}} | O vencimento dos títulos da lista |
| {{saudacao}} | Saudação da mensagem (ex.: "Bom dia") |
Quem é o vendedor de cada título: o vendedor gravado no título; sem ele, o vendedor da venda que gerou o título. No título de um Fechamento do cliente, cada venda que está nele vai para o vendedor dela, e cada um vê só a parte dele.
Cobrar todos os vencidos do cliente numa mensagem só
A regra de sempre cobra o título no dia exato: "3 dias após o vencimento" manda a mensagem só para os títulos que completam 3 dias de atraso hoje. Título que venceu antes da régua existir, ou que caiu num dia em que o envio falhou, fica sem cobrança. Para a régua de inadimplência, a regra tem um segundo modo: "Todos vencidos há esses dias ou mais".
- 1
Numa régua Reativa, abra (ou adicione) a regra com "Para quem: Cliente".
- 2
Na aba Agendamento, em "Quais títulos", escolha "Todos vencidos há esses dias ou mais".
- 3
Preencha "Cobrar vencidos a partir de": a data de vencimento mais antiga que a régua deve cobrar (obrigatória).
- 4
Ajuste o ritmo: "Repetir a cada (dias, 0 = uma vez)", "Máximo de cobranças por título (0 = sem limite)" e "Máximo de clientes por dia (0 = sem limite)".
Regra de envio com "Quais títulos: Todos vencidos há esses dias ou mais", a data a partir da qual cobrar, repetir, máximo por título e máximo de clientes por dia - 5
Nas abas E-mail e WhatsApp, use a variável "Lista dos títulos" na mensagem (botão Inserir variável), salve a regra e a régua.
A mensagem de WhatsApp com {{titulos.quantidade}}, {{titulos.total_formatado}} e {{titulos.lista}}, e a pré-visualização com uma linha por título
| O que | Como a régua faz |
|---|---|
| Quais títulos | Todo título vencido há os dias da regra ou mais, com vencimento a partir da data escolhida |
| Uma mensagem por cliente | O cliente que tem algum título para cobrar recebe UMA mensagem com todos os vencidos dele |
| Repetir | Com "Repetir a cada" 0, cada título é cobrado uma vez; com 7, volta a ser cobrado 7 dias depois da última cobrança, até o máximo por título |
| Falha no envio | Não se perde: o título volta a ser cobrado no dia seguinte |
| Máximo de clientes por dia | Quando chega no limite (ou no limite seguro de envios do WhatsApp), os demais ficam para a próxima rodada, primeiro os que nunca foram cobrados |
| Boleto | Com "Reenviar boleto?" ligado, vão até 10 boletos por mensagem; os demais títulos aparecem só na lista |
| Variável | O que preenche |
|---|---|
| {{titulos.lista}} | Uma linha por título: documento, vencimento e valor (até 30 linhas, depois "e mais N título(s)") |
| {{titulos.quantidade}} | Quantos títulos estão na lista |
| {{titulos.total_formatado}} | A soma dos títulos da lista (ex.: R$ 1.234,56) |
Configuração específica da régua
No Passo C: por padrão, a régua usa as regras globais da aba Configuração de envio. Se você quiser que uma régua específica ignore as regras globais, usando, por exemplo, um e-mail de saída diferente, abra a aba Configuração de envio dentro da própria régua, desmarque Usar configuração global e defina ajustes exclusivos para aquele fluxo.
| Opção | Comportamento |
|---|---|
| Usar configuração global | Ligada: a régua usa o SMTP global e os ajustes de calendário da aba Configuração de envio. Desligada: a régua passa a ter SMTP e calendário próprios |
| Não enviar em feriados / fins de semana | Mesmas regras do calendário global, mas valendo apenas para esta régua |
| Estratégia em dia não-útil | Adiar para próximo dia útil ou Pular o disparo |
| SMTP desta régua | Exibe "Nenhum SMTP configurado para esta régua" até que você clique em Configurar SMTP e informe o e-mail de saída exclusivo |
Ao concluir, clique em Salvar régua.
Pausar e retomar uma régua
Cada régua tem o interruptor Ativa / Pausada, no cartão da lista de réguas e no cadastro da régua. Pausada, ela não envia nenhuma mensagem: nem ao cliente, nem ao vendedor, nem de assinatura. O cartão mostra quem pausou e quando ("Pausada em dd/mm/aaaa por ..."), e canais, regras e empresas continuam como estavam.
Ao retomar, a régua não manda tudo de uma vez: no passo "Todos vencidos há esses dias ou mais", os atrasados saem aos poucos, respeitando o máximo de envios por título e o máximo de clientes por dia; nos passos de dia exato, quem completou os dias durante a pausa não recebe aquele envio. O passo a passo está no artigo "Régua de cobrança - pausar e retomar".
Dicas e boas práticas
Checklist antes de ativar uma régua:
| Item | Onde conferir |
|---|---|
| SMTP global configurado e testado | Configuração de envio > SMTP global |
| Calendário e estratégia em dia não-útil definidos | Configuração de envio > Calendário |
| Templates de E-mail e WhatsApp revisados | Aba Templates |
| Empresa vinculada e tipo de cobrança correto | Nova régua > Geral |
| Horário de envio e canais ativos em cada regra | Nova régua > Regras de envio |
| Pré-visualização conferida antes de salvar | Editor de mensagem da regra |
Problemas comuns
- O cliente não recebeu a cobrança: confira no cadastro do cliente se o contato está habilitado para E-mail e WhatsApp Boleto.
- Nenhuma mensagem saiu no dia esperado: o disparo pode ter caído em feriado ou fim de semana; veja a estratégia em dia não-útil na aba Configuração de envio e os indicadores Pulado feriado e Pulado fim semana no Painel.
- As cobranças do fim de semana chegaram na segunda: é a estratégia Adiar para próximo dia útil. Se várias regras do mesmo título caíram no fim de semana, o cliente recebe só a mais recente.
- O feriado cadastrado não foi respeitado: confira se ele está em Configurações > Feriado com a data e o ano certos (ou marcado para todo ano) e se Não enviar em feriados está ligado.
- As falhas de envio aumentaram: na aba Painel, filtre o Status e consulte os envios do período; confira também se o SMTP está configurado corretamente.
- Não consigo editar um template Padrão Hap: esses modelos são somente leitura; abra o modelo e clique em Duplicar para editar a cópia.
- A régua não usa o SMTP global: veja se a opção Usar configuração global está ligada na aba Configuração de envio da própria régua.
- O vendedor não recebeu o aviso: confira o Celular no cadastro dele (Cadastros > Pessoa, aba Identificação) e se o cadastro está ativo. Vendedor inativo não recebe, e o Painel mostra a falha "Vendedor inativo". Título sem vendedor fica fora do aviso.
- O cliente recebeu a cobrança sem o boleto anexado: o título tem recebimento parcial. A mensagem cobra só o saldo e vai sem o boleto, porque o boleto registrado no banco é do valor cheio.
- O cliente não recebeu nada no dia do aviso ao vendedor: é o esperado. A regra com "Para quem: Vendedor" manda a lista só para o vendedor; para avisar o cliente, use outra regra com "Para quem: Cliente".
- Um título vencido antes de eu criar a régua nunca foi cobrado: a regra de sempre cobra só os títulos que completam os dias exatamente hoje. Para alcançar os atrasados, use o passo "Todos vencidos há esses dias ou mais", com a data a partir da qual cobrar.
- Não aparece o campo "Quais títulos" na regra: ele só existe na régua Reativa, na regra "Para quem: Cliente". No aviso ao vendedor e na régua Preventiva a regra continua pelo dia exato.
- Ao salvar apareceu "a régua não pode ter outro passo para o cliente": com o passo "todos os vencidos" a régua fica com uma regra só para o cliente, senão o mesmo título sairia duas vezes no mesmo dia. Crie outra régua para os outros avisos.
- Ao salvar apareceu "informe a partir de qual vencimento cobrar": preencha "Cobrar vencidos a partir de". É ela que impede a régua de mandar, no primeiro dia, títulos de anos atrás.
- No passo "todos os vencidos", alguns clientes ficaram para o dia seguinte: a regra parou no "Máximo de clientes por dia" (ou no limite seguro de envios do WhatsApp). Os que sobraram entram na próxima rodada, primeiro os que nunca foram cobrados.
- No Painel aparece a falha "Cliente sem e-mail nem celular cadastrado para os canais da régua.": o cliente não tem contato para os canais da regra. Cadastre o e-mail ou o celular e habilite o contato para E-mail e WhatsApp Boleto.
- Preciso parar a cobrança por alguns dias sem perder a régua: use o interruptor Ativa / Pausada na lista de réguas ou no cadastro da régua. Pausada, ela não envia nada; canais, regras e empresas ficam como estão.
- A régua não enviou nada e o cartão dela mostra "Pausada em ... por ...": alguém pausou a régua. Confira com quem pausou e, se for o caso, volte o interruptor para Ativa.
