Reunião 23/01/2026 - Apresentação Fluxo e teste
šÆ Objetivo da ReuniĆ£o
Apresentar e demonstrar o funcionamento da integração entre o Sankhya e o Fortics SZ.chat (WhatsApp), abrangendo:
Criação e edição de fluxos de atendimento
Estrutura de menus e submenus
Condições lógicas ("Se / Ou")
Etapas de finalização e encaminhamento
Integração com RPA e REST
Funcionamento do fluxo atual vinculado ao WhatsApp corporativo da Qualimpor
š§ 1. Estrutura do Fluxo de Atendimento no SZ.chat
O fluxo de atendimento Ʃ responsƔvel por definir o comportamento das conversas no WhatsApp, determinando:
Como o usuƔrio Ʃ recepcionado
Quais opƧƵes de menu ele visualiza
Quais informaƧƵes ele pode consultar (nota fiscal, boleto etc.)
Quando e como o atendimento humano Ć© acionado
Elementos principais:
| Elemento | Função | Exemplo |
|---|---|---|
| Menu | Apresenta opƧƵes principais ao cliente | Comercial, Financeiro, OperaƧƵes, TI |
| Submenu | Detalha opƧƵes especĆficas dentro de um menu | ā2ĀŖ via de boletoā, āStatus da Notaā |
| CondiƧƵes (SE/OU) | Define rotas lógicas baseadas em regras | Se cliente = āfinanceiroā, ir para RPA āBoletosā |
| Finalização | Encerra ou encaminha o atendimento | Mensagem de encerramento ou fila humana |
| RPA (Robotic Process Automation) | Executa aƧƵes automƔticas, como consultas ou cƔlculos | Consultar nota fiscal via API |
| REST (API Connector) | Configura a comunicação com sistemas externos | Integração com API do Sankhya |
āļø 2. Funcionamento Atual do Fluxo ā Qualimpor
O fluxo ativo do WhatsApp da Qualimpor permite que usuƔrios realizem consultas automatizadas a notas fiscais e boletos.
š Regras de acesso:
Para que o usuƔrio consiga efetuar consultas, ele precisa estar previamente cadastrado:
| Cadastro | Local | ObservaƧƵes |
|---|---|---|
| Parceiro (Cliente) | TGFCTT ā Aba āContatosā | O nĆŗmero de WhatsApp deve estar vinculado e autorizado |
| Vendedor (Representante) | TGFVEN ā Aba āLiberação WhatsAppā | O nĆŗmero deve estar cadastrado e ativo para o vendedor responsĆ”vel |
Esses cadastros determinam quais notas e boletos podem ser acessados pelo usuÔrio no fluxo, garantindo segurança e restrição adequada.
𧱠3. Modificações Técnicas Realizadas
Durante a reunião, foram feitas as seguintes implementações e ajustes:
ā Campo Personalizado ā TGFTOP
| Campo | Tipo | Função |
|---|---|---|
| AD_USAFORTICS | Lista (S/N) | Indica se o tipo de operação (TOP) pode ser consultado pelo WhatsApp |
Esse campo foi incluĆdo no cadastro de TOP (Tipos de Operação) para definir quais notas fiscais estarĆ£o disponĆveis para consulta via SZ.chat.
ā Atualização da View de Notas
Foi ajustada a view padrão para notas, criando ou alterando:
VW_NOTAS_FORTICS
Implementação:
SELECT ... FROM VW_NOTAS_FORTICS C WHERE AD_USAFORTICS = 'S'
š¹ Essa view Ć© consumida pelo fluxo de atendimento do SZ.chat, permitindo que apenas notas autorizadas sejam retornadas via integração.
š 4. Criação de IntegraƧƵes REST e RPA
Para cada processo automatizado no fluxo, Ʃ necessƔrio criar duas camadas complementares:
𧩠A. Aplicação REST
ResponsÔvel pela conexão com a API externa.
Etapas:
Criar uma nova Aplicação REST no painel do SZ.chat.
Configurar:
URL base da API Sankhya (ex: /mge/service.sbr)
Headers de autenticação (Authorization, Content-Type)
MƩtodo HTTP: geralmente POST ou GET
Testar retorno direto no painel antes de usar no fluxo.
Finalidade:
A REST gerencia como o SZ.chat envia requisiƧƵes para o Sankhya.
š¤ B. Aplicação RPA
ResponsƔvel por processar o retorno da REST e disponibilizar variƔveis dentro do fluxo.
Etapas:
Criar um RPA com base na REST anterior.
Mapear as variÔveis de resposta do Sankhya (ex: número da nota, data, valor, status).
Inserir o RPA dentro do fluxo de atendimento para uso condicional.
Finalidade:
O RPA converte o retorno JSON em variƔveis internas, permitindo que o chatbot responda algo como:
"Segue o download da nota fiscalā
āļø 5. Fluxo de Criação ā Passo a Passo
| Etapa | Descrição | Resultado Esperado |
|---|---|---|
| 1 | Criar REST | Configuração da conexão com o Sankhya |
| 2 | Criar RPA vinculado à REST | Interpretação das variÔveis retornadas |
| 3 | Criar fluxo no SZ.chat | Estrutura do atendimento e respostas |
| 4 | Adicionar menus e condições | Navegação estruturada |
| 5 | Vincular RPA ao ponto de consulta | Resposta automƔtica com dados |
| 6 | Testar o fluxo com número cadastrado | Garantia de segurança e retorno correto |
| 7 | Validar no Sankhya (TGFCAB e VW_NOTAS_FORTICS) | Confirmar notas liberadas |
Por enquanto não hÔ comentÔrios.