Central de Notificações - Histórico de revisão

Vitor: /* Cobrança a Vencer, Vencida e Paga */

2026-08-11T17:25:31Z

Cobrança a Vencer, Vencida e Paga

Vitor em 17h21min de 11 de agosto de 2026

2026-08-11T17:21:27Z

Mostrar alterações

10.20.120.47 em 18h24min de 6 de julho de 2026

2026-07-06T18:24:58Z

10.20.120.47: /* Botões Gravar/Cancelar nas Configurações ficam desabilitados */

2026-07-06T18:22:16Z

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

10.20.120.47: /* Parâmetros disponíveis no SQL */

2026-07-06T18:20:02Z

Parâmetros disponíveis no SQL

10.20.120.47: Criou página com '==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 Whats...'

2026-07-06T18:15:47Z

Criou página com '==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 Whats...'

Página nova

==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:

{| class="wikitable"
|-
! 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==

{| class="wikitable"
|-
! 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.

@@ Linha 15: / Linha 15: @@
 <small>'''Categorias de OS que existem mas não aparecem na tela:''' o sistema também tem as categorias '''OS Aberta''', '''OS em Andamento''' e '''OS Faturada''' (códigos <code>OS_ABERTA</code>, <code>OS_ANDAMENTO</code>, <code>OS_FATURADA</code>). Só "OS Pronta" fica visível nos combos de categoria, nos templates e no envio automático da tela; as outras três não aparecem em nenhum desses lugares, mas têm rótulo próprio no filtro de '''Histórico''' — ou seja, elas existem para uso via API/integração de outro módulo, e podem aparecer no Histórico sem que o operador tenha configurado nada na Central de Notificações para elas.</small>
 ==Abas da tela==
@@ Linha 141: / Linha 139: @@
 ==Cobrança a Vencer, Vencida e Paga==
 Essas três categorias trabalham em cima do contas a receber (CTARECEB) como um todo. Um título entra na lista independentemente de ter ou não boleto bancário gerado; o que muda é o que é enviado.
@@ Linha 150: / Linha 146: @@
 *'''E-mail''': enviado sem anexo, só com o texto do template;
 *'''WhatsApp''' (uazapi ou Meta): enviado só com o texto, sem link e sem documento anexado.
 ===Boleto acumulado (opção "Acumulativo" na impressão de boletos)===
@@ Linha 161: / Linha 155: @@
 *O envio — e-mail ou WhatsApp — leva um '''único PDF''', com o valor total e o mesmo nosso número do boleto que seria impresso pela tela de Boletos e Duplicatas;
 *O histórico e o controle de reenvio consideram o boleto acumulado como um todo, então a baixa de uma das contas do grupo não faz a notificação ser enviada de novo por engano.
 ==Envio Automático==
@@ Linha 277: / Linha 266: @@
 . Se o canal WhatsApp está habilitado nos canais selecionados no momento do envio.
 ===Mensagem não chega por e-mail===
@@ Linha 330: / Linha 316: @@
 *NC_AUTO_ATIVO, NC_AUTO_HORA, NC_AUTO_MINUTO, NC_AUTO_CANAIS, NC_AUTO_CATEGORIAS, NC_AUTO_ULTIMODIA – controle do envio automático.

@@ Linha 154: / Linha 154: @@
 ===Campos do cadastro===
-*'''Descrição''' (NTP_DESCRICAO) – nome da categoria exibido na interface;
+*'''Descrição''' (NP_DESCRICAO) – nome da categoria exibido na interface;
-*'''Ativo''' (NTP_ATIVO) – somente tipos ativos aparecem nas listas;
+*'''Ativo''' (NP_ATIVO) – somente tipos ativos aparecem nas listas;
-*'''Limite de envios''' (NTP_LIMIT) – quantidade máxima de registros processados por execução; 0 = sem limite;
+*'''Limite de envios''' (NP_LIMIT) – quantidade máxima de registros processados por execução; 0 = sem limite;
-*'''SQL''' (NTP_SQL) – consulta SQL que retorna os destinatários;
+*'''SQL''' (NP_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.
+*'''Col 1 a Col 4''' (NP_COL1 a NP_COL4) – rótulos das colunas extras exibidas na listagem de envio manual.
 ===Colunas obrigatórias no SQL===

@@ Linha 199: / Linha 199: @@
 ==Comportamentos importantes==
 ===Mensagem não chega por WhatsApp===
@@ Linha 207: / Linha 204: @@
 . Se a instância está conectada (botão '''Consultar Status''' deve mostrar "Conectado").
 . Se o número do cliente possui WhatsApp ativo – o sistema valida antes do envio.
 . Se o template de WhatsApp da categoria está preenchido.
 . Se o canal WhatsApp está habilitado nos canais selecionados no momento do envio.
@@ Linha 215: / Linha 215: @@
 . Configurações de SMTP (servidor, porta, criptografia, usuário e senha) usando o botão '''Testar E-mail'''.
 . Se o cliente possui e-mail cadastrado.
 . Se o template de e-mail da categoria está preenchido.
@@ Linha 222: / Linha 224: @@
 . Se o campo '''Ativo''' do tipo personalizado está marcado.
 . Se o SQL está salvo corretamente (sem erros de sintaxe).
 . Fechar e reabrir a Central de Notificações para recarregar as categorias.
@@ Linha 229: / Linha 233: @@
 . Se NC_AUTO_ATIVO = 'S' para a filial.
 . Se o horário configurado já passou no dia corrente.
 . Se NC_AUTO_ULTIMODIA já está preenchido com a data de hoje (indica que já executou).
 . Se ao menos um canal (WA ou e-mail) está marcado.
 . Se ao menos uma categoria está marcada.

@@ Linha 109: / Linha 109: @@
 {| class="wikitable"
 |-
-! Categoria !! Variáveis extras
+!Categoria!!Variáveis extras
 |-
-| Aniversário || {DATA_NASC}
+|Aniversário||{DATA_NASC}
 |-
-| Boleto a Vencer / Vencido / Pago || {VENCIMENTO} {VALOR} {DOCUMENTO} {LINK_BOLETO}
+|Boleto a Vencer / Vencido / Pago||{VENCIMENTO} {VALOR} {DOCUMENTO} {LINK_BOLETO}
 |-
-| OS Pronta || {NUMERO_OS} {DATA_OS} {VALOR_OS} {STATUS_OS}
+|OS Pronta||{NUMERO_OS} {DATA_OS} {VALOR_OS} {STATUS_OS}
 |-
-| NF-e || {NUMERO_NOTA} {EMISSAO} {VALOR_NOTA} {CHAVE} {LINK_NOTA} {LINK_NFE} {LINK_BOLETO}
+|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
+|Tipos Personalizados||{DETALHE1} {DETALHE2} {DETALHE3} {DETALHE4} {REFERENCIA} {REFERENCIA_DOC} + campos retornados pelo SQL
 |}
@@ Linha 180: / Linha 180: @@
 *''':DATA_DE''' ou ''':DE''' – data de início do período;
 *''':DATA_ATE''' ou ''':ATE''' – data de fim do período;
 ===Regra de controle de reenvio===
@@ Linha 194: / Linha 193: @@
 {| class="wikitable"
 |-
-! Módulo !! Descrição
+!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.
+|'''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.
 |}