Central de Notificações

De Office System
Ir para navegação Ir para pesquisar

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;

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

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.
Disponível em “https://wiki.officesystem.com.br/index.php?title=Central_de_Notificações&oldid=2375”