Pular para o conteĆŗdo

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:

ElementoFunçãoExemplo
MenuApresenta opƧƵes principais ao clienteComercial, Financeiro, OperaƧƵes, TI
SubmenuDetalha 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 regrasSe cliente = ā€œfinanceiroā€, ir para RPA ā€œBoletosā€
FinalizaçãoEncerra ou encaminha o atendimentoMensagem de encerramento ou fila humana
RPA (Robotic Process Automation)Executa aƧƵes automƔticas, como consultas ou cƔlculosConsultar nota fiscal via API
REST (API Connector)Configura a comunicação com sistemas externosIntegraçã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:

CadastroLocalObservaƧƵ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

CampoTipoFunção
AD_USAFORTICSLista (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:

  1. Criar uma nova Aplicação REST no painel do SZ.chat.

  2. Configurar:

    • URL base da API Sankhya (ex: /mge/service.sbr)

    • Headers de autenticação (Authorization, Content-Type)

    • MĆ©todo HTTP: geralmente POST ou GET

  3. 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:

  1. Criar um RPA com base na REST anterior.

  2. Mapear as variÔveis de resposta do Sankhya (ex: número da nota, data, valor, status).

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

EtapaDescriçãoResultado Esperado
1Criar RESTConfiguração da conexão com o Sankhya
2Criar RPA vinculado à RESTInterpretação das variÔveis retornadas
3Criar fluxo no SZ.chatEstrutura do atendimento e respostas
4Adicionar menus e condiçõesNavegação estruturada
5Vincular RPA ao ponto de consultaResposta automƔtica com dados
6Testar o fluxo com número cadastradoGarantia de segurança e retorno correto
7Validar no Sankhya (TGFCAB e VW_NOTAS_FORTICS)Confirmar notas liberadas
Avaliação
0 0

Por enquanto não hÔ comentÔrios.

para ser o primeiro a comentar.