====== Notificações Automáticas via WhatsApp ======
O Ello ERP pode enviar mensagens automáticas para os clientes em horários definidos, sem que nenhum operador precise fazer isso manualmente. Os envios são realizados pelo servidor do sistema (serviço Gollum), que precisa estar em execução.
===== Tipos de notificação disponíveis =====
- [[#boletos|Avisos de boletos próximos ao vencimento]]
- [[#cobrancas|Avisos de cobranças próximas ao vencimento]]
- [[#sem_compras|Clientes sem compras há muito tempo]]
> **Pré-requisito:** O WhatsApp deve estar configurado e conectado. Veja [[whatsapp:configuracao|Configuração do WhatsApp]].
===== Avisos de boletos =====
==== O que faz ====
O sistema verifica diariamente, no horário configurado, quais boletos estão próximos do vencimento (ou já vencidos) e envia uma mensagem para o celular do cliente. O PDF do boleto é enviado junto com a mensagem.
==== Como configurar ====
Acesse: **Configurações → Parâmetros → Notificações de Conta a Receber**
- Ative a opção **Notificar Boletos a Vencer**
- Informe o **horário** em que os avisos devem ser enviados (ex: 09:00)
- Adicione uma ou mais **regras de aviso**
{{:notificao.png?700|}}
{{:ENVIOAUTO1.jpg?200|}}
==== Regras de aviso ====
Cada regra define **quando** e **como** o aviso é enviado:
^ Campo ^ Descrição ^
| Dias | Quantos dias antes ou depois do vencimento enviar |
| Prazo | "Antes", "No dia" ou "Após" o vencimento |
| Formas de envio | WhatsApp, E-mail ou ambos |
| Tipo | Boleto ou Cobrança |
| Mensagem | Texto personalizado com variáveis (ver abaixo) |
É possível ter várias regras. Por exemplo:
* Avisar 5 dias antes
* Avisar no dia do vencimento
* Avisar 3 dias após o vencimento (para cobranças em atraso)
==== Variáveis disponíveis na mensagem ====
As variáveis abaixo são substituídas automaticamente pelo valor real ao enviar:
^ Variável ^ O que exibe ^
| {nomecliente} | Primeiro nome do cliente |
| {nomeempresa} | Nome fantasia da empresa |
| {vencimento} | Data de vencimento do boleto |
| {dias} | Número de dias para o vencimento (ou em atraso) |
| {valorboleto} | Valor do boleto |
| {linhadigitavel} | Linha digitável para pagamento |
| {quebradelinha} | Pula uma linha na mensagem |
**Exemplo de mensagem:**
Olá, {nomecliente}! Seu boleto de R$ {valorboleto} vence em {dias} dias ({vencimento}).{quebradelinha}Linha digitável: {linhadigitavel}{quebradelinha}Atenciosamente, {nomeempresa}
==== Observações ====
* O boleto só é enviado se o cliente tiver um número de celular cadastrado no sistema
* Cada boleto é enviado apenas uma vez por regra (o sistema registra os envios para não repetir)
* Entre um envio e outro há uma pausa de alguns segundos, para não sobrecarregar o serviço de WhatsApp
{{:boleto1.png?700|}}
{{:BOLETO1.jpg?200|}}
\\
===== Avisos de cobranças =====
Funciona de forma similar aos boletos, mas para parcelas de conta a receber que não possuem boleto bancário.
==== Como configurar ====
Acesse: **Configurações → Parâmetros → Notificações de Conta a Receber**
- Ative a opção **Notificar Cobranças a Vencer**
- Informe o **horário** de envio (ex: 14:00)
- As regras são compartilhadas com as de boleto — basta selecionar o **Tipo = Cobrança**
==== Variáveis disponíveis na mensagem ====
^ Variável ^ O que exibe ^
| {nomecliente} | Primeiro nome do cliente |
| {nomeempresa} | Nome fantasia da empresa |
| {vencimento} | Data de vencimento |
| {dias} | Dias para o vencimento (ou em atraso) |
| {valor} | Valor da parcela |
| {documento} | Identificador do documento |
| {quebradelinha} | Pula uma linha na mensagem |
{{:conta1.jpg?700|}}
{{:RECEBER1.jpg?200|}}
\\
===== Clientes sem compras =====
==== O que faz ====
O sistema identifica clientes que estão há muitos dias sem comprar e envia uma mensagem de reengajamento, convidando-os a voltar.
O sistema registra o dia do último aviso enviado para cada cliente e não reenvia o aviso antes de um período determinado.
==== Como configurar ====
Acesse: **Configurações → Parâmetros → Notificação de Pedidos**
- Ative a opção **Ativar Envio**
- Informe o **horário** em que os avisos devem ser enviados (ex: 08:00)
- Informe quantos **dias sem compra** acionam o aviso (ex: 30)
- Escreva a **mensagem** que será enviada (use as variáveis abaixo)
==== Variáveis disponíveis na mensagem ====
^ Variável ^ O que exibe ^
| {nomecliente} | Primeiro nome do cliente |
| {nomeempresa} | Nome fantasia da empresa |
| {diasausente} | Quantos dias o cliente está sem comprar |
| {quebradelinha} | Pula uma linha na mensagem |
**Mensagem padrão sugerida:**
Olá, {nomecliente}. Tudo bem?{quebradelinha}Notamos que faz {diasausente} dias que não temos o prazer de atendê-lo.{quebradelinha}Ficamos à disposição para o que precisar. Será um prazer recebê-lo novamente.{quebradelinha}Atenciosamente, {nomeempresa}
==== Quais clientes recebem o aviso ====
Recebem o aviso os clientes que:
* Estão **ativos** no cadastro
* Têm **celular** cadastrado
* Realizaram ao menos uma compra registrada no sistema
* Estão **sem comprar** há pelo menos o número de dias configurado
* **Não receberam** o mesmo aviso recentemente (o sistema evita reenvios desnecessários)
==== Observações ====
* O sistema considera apenas compras que movimentam o histórico de vendas (pedidos registrados)
* Entre um envio e outro há uma pausa de alguns segundos, para não sobrecarregar o serviço
* Se o serviço de WhatsApp estiver fora do ar no horário do envio, os avisos não são reenviados automaticamente naquele dia
\\
===== Diagnóstico de problemas =====
^ Problema ^ O que verificar ^
| Mensagens não estão sendo enviadas | Verifique se o serviço Gollum está em execução no servidor |
| Cliente não recebeu a mensagem | Verifique se o celular está cadastrado e no formato correto (com DDD) |
| WhatsApp desconectado | Acesse a configuração e reconecte com QR Code |
| Mensagem sendo enviada com texto errado | Revise o modelo de mensagem nos parâmetros de notificação |
===== Veja também =====
* [[whatsapp:configuracao|Configuração do WhatsApp]]
* [[whatsapp:nfe|Envio de Nota Fiscal por WhatsApp]]
* [[whatsapp|Voltar ao índice]]