Central de Notificações

Visão funcional

A Central de Notificações é o módulo responsável pelo envio de mensagens automáticas e manuais aos clientes via WhatsApp e e-mail. O envio pode ocorrer de duas formas: manualmente pelo operador, selecionando destinatários e disparando na hora, ou automaticamente pelo sistema em horário configurado.

As categorias de notificação disponíveis são:

Aniversário – clientes que fazem aniversário no período;
Boleto a Vencer – boletos com vencimento próximo;
Boleto Vencido – boletos em atraso;
Boleto Pago – boletos quitados;
OS Pronta – ordens de serviço com status de pronta;
NF-e – notas fiscais eletrônicas emitidas;
Tipos Personalizados – categorias criadas pelo próprio usuário com SQL customizado (ver seção específica).

Abas da tela

Notificações

Aba principal de consulta e envio manual. O operador filtra por categoria, filial e período, seleciona os destinatários na lista e aciona o envio por WhatsApp, e-mail ou ambos. O sistema exibe progresso em tempo real e permite cancelar o envio em andamento.

Configurações

Aba com quatro sub-abas de configuração:

WhatsApp – tipo de API, credenciais e intervalo entre envios;
E-mail – servidor SMTP, porta, criptografia e credenciais;
Templates – mensagens por categoria e canal;
Automático – ativação, horário e categorias do envio automático.

Histórico

Exibe registros de todos os envios realizados com filtros por período, tipo (WhatsApp/e-mail), categoria e status (Sucesso/Erro/Reenviado). Permite reenvio de falhas diretamente da tela.

Tipos Personalizados

Gerenciamento das categorias customizadas criadas pelo usuário (ver seção específica). A aba só aparece para usuários com permissão de acesso ao módulo correspondente.

Configuração do WhatsApp

Tipo de API

Existem duas opções de integração com WhatsApp:

API Oficial (Meta) – integração direta com a API oficial da Meta. Exige Phone ID, Token de acesso e versão da API (ex.: v18.0). Não apresenta risco de bloqueio do número;
API Não Oficial (EvolutionGO) – emulação web do WhatsApp via EvolutionGO. Exige a criação de uma instância e vinculação do celular por QR Code. Apresenta risco de bloqueio do número em caso de uso inadequado (envio em massa, spam).

Campos da API Oficial

Onde ficam

Central de Notificações > Configurações > WhatsApp > grupo API Oficial Meta

Campos

Phone ID (NC_WA_PHONE_ID)
Token (NC_WA_TOKEN)
Versão (NC_WA_VERSAO)

Campos da API Não Oficial (EvolutionGO)

Onde ficam

Central de Notificações > Configurações > WhatsApp > grupo API Não Oficial - EvolutionGO

Campos

Instância (NC_WA_INSTANCIA) – gerado automaticamente pelo sistema na primeira abertura; não editável pelo usuário;
Intervalo entre envios (seg.) (NC_WA_INTERVALO) – tempo de espera entre cada mensagem enviada.

Ações disponíveis

Criar Instância – registra a instância no servidor EvolutionGO;
Consultar Status – verifica se o WhatsApp está conectado;
Conectar (QR Code) – exibe o QR Code para leitura pelo celular;
Desconectar – encerra a sessão do WhatsApp na instância.

O indicador de status (luz vermelha/verde) é atualizado automaticamente a cada 15 segundos enquanto a tela estiver aberta.

Configuração de E-mail

Onde fica

Central de Notificações > Configurações > E-mail

Campos

Servidor SMTP (NC_EMAIL_SMTP)
Porta (NC_EMAIL_PORTA)
Criptografia (NC_EMAIL_SSL) – opções: TLS, SSL, None
Usuário (NC_EMAIL_USUARIO)
Senha (NC_EMAIL_SENHA)
Nome exibido (NC_EMAIL_NOME)
E-mail de resposta (Reply-To) (NC_EMAIL_REPLY)
Intervalo entre envios (seg.) (NC_EMAIL_INTERVALO)

O botão Testar E-mail envia uma mensagem de teste para o próprio endereço configurado em Usuário.

Templates de mensagem

Onde fica

Central de Notificações > Configurações > Templates

Cada categoria possui um template separado para WhatsApp e um para E-mail. O template de e-mail inclui campo de assunto. Os templates são salvos por filial.

Variáveis disponíveis

Todas as categorias suportam as variáveis base:

{NOME} – nome do cliente;
{TELEFONE} – telefone do destinatário;
{EMAIL} – e-mail do destinatário.

Variáveis adicionais por categoria:

Categoria	Variáveis extras
Aniversário	{DATA_NASC}
Boleto a Vencer / Vencido / Pago	{VENCIMENTO} {VALOR} {DOCUMENTO} {LINK_BOLETO}
OS Pronta	{NUMERO_OS} {DATA_OS} {VALOR_OS} {STATUS_OS}
NF-e	{NUMERO_NOTA} {EMISSAO} {VALOR_NOTA} {CHAVE} {LINK_NOTA} {LINK_NFE} {LINK_BOLETO}
Tipos Personalizados	{DETALHE1} {DETALHE2} {DETALHE3} {DETALHE4} {REFERENCIA} {REFERENCIA_DOC} + campos retornados pelo SQL

Envio Automático

Onde fica

Central de Notificações > Configurações > Automático

O sistema verifica a cada minuto se chegou o horário de envio e, se sim, dispara o processamento em segundo plano sem intervenção do usuário.

Campos de configuração

Ativo (NC_AUTO_ATIVO) – habilita ou desabilita o envio automático da filial;
Hora de envio (NC_AUTO_HORA / NC_AUTO_MINUTO) – horário em que o envio deve ocorrer (formato HH:MM);
Canais (NC_AUTO_CANAIS) – WhatsApp e/ou E-mail;
Categorias (NC_AUTO_CATEGORIAS) – quais categorias devem ser processadas automaticamente.

Regra de execução

O sistema só executa uma vez por dia por filial (controla pela data em NC_AUTO_ULTIMODIA);
O envio automático processa registros do dia anterior, garantindo que a data de corte seja correta mesmo após a marcação de execução;
Categorias não marcadas são ignoradas;
Se nenhum canal estiver habilitado, o envio é abortado.

Tipos Personalizados

Onde fica

Central de Notificações > aba Tipos Personalizados

Permite criar categorias de notificação próprias, com SQL personalizado definido pelo usuário. Cada tipo personalizado aparece automaticamente nas abas de Notificações (envio manual), Templates e nas categorias do Envio Automático.

Campos do cadastro

Descrição (NTP_DESCRICAO) – nome da categoria exibido na interface;
Ativo (NTP_ATIVO) – somente tipos ativos aparecem nas listas;
Limite de envios (NTP_LIMIT) – quantidade máxima de registros processados por execução; 0 = sem limite;
SQL (NTP_SQL) – consulta SQL que retorna os destinatários;
Col 1 a Col 4 (NTP_COL1 a NTP_COL4) – rótulos das colunas extras exibidas na listagem de envio manual.

Colunas obrigatórias no SQL

O SQL deve retornar obrigatoriamente as seguintes colunas:

CLIENTE_ID – código do cliente;
NOME – nome do destinatário;
FONE – número de WhatsApp;
EMAIL – endereço de e-mail;
REFERENCIA – identificador único do registro (usado para controle de reenvio).

Colunas opcionais que alimentam os placeholders do template:

DETALHE1 a DETALHE4 – informações extras usadas via {DETALHE1}…{DETALHE4};
REFERENCIA_DOC – número de documento para exibição no histórico.

Parâmetros disponíveis no SQL

:FILIAL – código da filial atual;
:DATA_DE ou :DE – data de início do período;
:DATA_ATE ou :ATE – data de fim do período;
:REENVIO – S ou N; indica se o modo de reenvio está ativo (uso manual).

Regra de controle de reenvio

O sistema filtra automaticamente registros que já foram enviados com sucesso, comparando REFERENCIA e categoria na tabela NOTIF_HISTORICO. Assim, o mesmo registro não é enviado duas vezes no automático nem no manual (quando a opção de reenvio não está marcada).

Validação de placeholders

Ao salvar o template de um tipo personalizado, o sistema valida se todas as variáveis usadas no texto ({...}) são campos efetivamente retornados pelo SQL cadastrado. Se um placeholder não existir no SQL, a gravação é bloqueada com mensagem indicando os campos disponíveis.

Permissões

Módulo	Descrição
Central de Notificações – Tipos Personalizados (324)	Habilita a aba de Tipos Personalizados na Central de Notificações. Sem esta permissão, a aba fica oculta.

Comportamentos importantes

Botões Gravar/Cancelar nas Configurações ficam desabilitados

É o comportamento correto. Os botões ficam habilitados somente quando há alteração efetiva nos campos de configuração ou no template. Ao abrir a aba sem modificar nada, os botões permanecem desabilitados.

Mensagem não chega por WhatsApp

Conferir, nesta ordem:

1. Se a instância está conectada (botão Consultar Status deve mostrar "Conectado"). 2. Se o número do cliente possui WhatsApp ativo – o sistema valida antes do envio. 3. Se o template de WhatsApp da categoria está preenchido. 4. Se o canal WhatsApp está habilitado nos canais selecionados no momento do envio.

Mensagem não chega por e-mail

Conferir:

1. Configurações de SMTP (servidor, porta, criptografia, usuário e senha) usando o botão Testar E-mail. 2. Se o cliente possui e-mail cadastrado. 3. Se o template de e-mail da categoria está preenchido.

Tipo personalizado não aparece nas categorias

Conferir:

1. Se o campo Ativo do tipo personalizado está marcado. 2. Se o SQL está salvo corretamente (sem erros de sintaxe). 3. Fechar e reabrir a Central de Notificações para recarregar as categorias.

Envio automático não disparou

Conferir, nesta ordem:

1. Se NC_AUTO_ATIVO = 'S' para a filial. 2. Se o horário configurado já passou no dia corrente. 3. Se NC_AUTO_ULTIMODIA já está preenchido com a data de hoje (indica que já executou). 4. Se ao menos um canal (WA ou e-mail) está marcado. 5. Se ao menos uma categoria está marcada.

Registro aparece na consulta mas não é enviado no automático

O envio automático processa registros do dia anterior. Se o registro é do dia atual, ele será enviado no próximo ciclo (no dia seguinte). Isso é intencional para evitar inconsistência no controle de execução diária.

Atualização de banco (estrutura criada pelo módulo)

Tabelas criadas:

NOTIF_CONFIG – configuração de WhatsApp e e-mail por filial;
NOTIF_TEMPLATE – templates de mensagem por categoria, tipo e filial;
NOTIF_HISTORICO – histórico de todos os envios realizados;
NOTIF_TIPO_PERS – cadastro dos tipos de notificação personalizados.

Campos relevantes de NOTIF_CONFIG:

NC_AUTO_ATIVO, NC_AUTO_HORA, NC_AUTO_MINUTO, NC_AUTO_CANAIS, NC_AUTO_CATEGORIAS, NC_AUTO_ULTIMODIA – controle do envio automático.

Central de Notificações

Índice