Desenvolvimento do Monitor de Mensageria WhatsApp - NT Nº 0293/2026

Resumo da Nota Técnica

Foi desenvolvido o Monitor de Mensageria WhatsApp, uma nova solução para envio automatizado de mensagens via WhatsApp de forma desacoplada do ERP. Com essa implementação, o sistema Integrado passa a registrar solicitações de envio em uma fila específica, enquanto o novo aplicativo Monitor é responsável por processar essas solicitações e realizar os envios através da API INPERA integrada ao WhatsChat IA.

Detalhes da Nota Técnica

1. Objetivo do projeto
Implementar mensageria WhatsApp desacoplada do ERP:
• O Integrado apenas grava solicitações na fila MENSAGERIAWHATSAP.
• O Monitor processa a fila, autentica na API INPERA e envia via WhatsChat IA.
• O envio ocorre de forma assíncrona, sem bloquear a operação do usuário no ERP.
Fluxo:
ERP (Pedido) → MENSAGERIAWHATSAP → Monitor → API INPERA → WhatsChat IA → WhatsApp
________________________________________
2. Infraestrutura de dados
Tabela MENSAGERIAWHATSAP

Status:
Código | Significado
P          | Pendente
E          | Em envio
S          | Enviada com sucesso
F          | Falha
C          | Cancelada
________________________________________
3. Funcionalidades do Monitor
• Execução minimizada na bandeja do Windows
• Opção de iniciar com o Windows
• Consulta periódica da fila (intervalo configurável)
• Reserva atômica da mensagem antes do envio
• Recuperação de mensagens interrompidas (E → P ao iniciar)
• Painel com contadores: Pendentes, Em Envio, Enviadas, Falhas, Canceladas
• Logs de ciclo, envio e autenticação
• Leitura do token INPERA em CONFIGINPERA
________________________________________
4. Etapa 2 — Core no ERP (Integrado / Delphi 7)
Procedures implementadas
GerarMensagemWhatsapp
Grava registro na fila MENSAGERIAWHATSAP com status P.
pcdGerarMensagemWhatsappCliente
Helper que:
• Busca CLI_CELULAR e CLI_RAZAO em CLIENTE
• Chama GerarMensagemWhatsapp com os dados do cliente
pcdAbrirConexaoFBMensageria
Abre conexão Firebird independente para gravação isolada na fila.
________________________________________
5. Etapa 3 — Integração no ERP (escopo atual)
Módulo ativo: Pedido de Venda
Evento: PEDIDO_FINALIZADO
Origem: PEDIDO
Momento de disparo:
• Quando o financeiro do pedido é fechado
Mensagem enviada:
Seu pedido no. [numero] foi finalizado com sucesso.
Pré-requisitos operacionais:
• Cliente com celular em CLI_CELULAR
• Monitor WhatsApp em execução
• Token INPERA configurado em CONFIGINPERA
Módulos previstos no plano, não integrados no escopo atual


________________________________________
________________________________________
6. Como operar (visão geral)
ERP
1. Substituir o Integrado
2. Finalizar pedido de venda (financeiro completo)
Monitor
1. Executar MonitorMensageriaWhatsApp.exe
2. Configurar token valido na API
3. Acompanhar envio na aba Status/Logs do monitor
________________________________________
7. Arquivos alterados no Integrado (mensageria)
INTEGRADO. EXE – funções e pedido de Vendas.
________________________________________

8. Interface:
Conta com uma tela onde Mostram Status da Operação de envio:

O acompanhamento de Logs:

E suas configurações:


Para que funcione como esperado, é necessário substituir o Integrado da maquina do cliente e implantar o aplicativo Monitor Mensageria Whatsapp.

Questões:

1. Qual é a principal função do aplicativo Monitor de Mensageria WhatsApp?
a) Emitir pedidos de venda.
b) Processar a fila de mensagens e realizar os envios via WhatsApp.
c) Gerar boletos bancários.
d) Emitir notas fiscais eletrônicas.
________________________________________
2. Em qual momento a mensagem é gerada no escopo atual do projeto?
a) Ao cadastrar um cliente.
b) Ao emitir uma nota fiscal.
c) Quando o pedido de venda é finalizado e o financeiro é concluído.
d) Ao abrir o sistema.
________________________________________
3. Qual é o status utilizado para identificar mensagens que aguardam processamento?
a) E – Em Envio.
b) S – Enviada.
c) F – Falha.
d) P – Pendente.

Parâmetros Envolvidos

Não há parâmetros envolvidos.

» Nota Técnica