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

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

Central de Notificações

2026-07-06T18:15:47Z

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...'

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

Utilitários

2026-07-06T18:14:10Z

10.20.120.47:

*[[Alteração de senha do Usuario Atual|Alteração de Senha]]
*[[Atualizações de Tabelas|Atualizações de tabelas]]
*[[Verificação de logs|Auditória de Dados]]
*[[Estoque|Contagem de Estoque]]
*[[Central de Notificações]]