01. VISÃO GERAL
Este documento tem como objetivo demonstrar a utilização do Cadastro de Alertas, rotina desenvolvida em PO UI (Biblioteca de componentes baseado em Angular).
02. ALERTAS DISPONIBILIZADOS
000001 e 000002 - Envio de notificação de mensageria via auditoria e faturamento. - DT Enviar notificações para comunicação da Mensageria
000003 - Envio de token de atendimento para o beneficiario - DT Alerta de Token do Beneficiario
000004 e 000005 - Alerta após bloqueio do beneficiario ou familia - DT Envio de E-mail
000006 - Envio de primeiro acesso do novo portal do beneficiario - DT Envio de E-mail
03. EXEMPLO DE UTILIZAÇÃO
a. Configurações Iniciais
Para iniciar o processo, devemos configurar o INI do Protheus com a funcionalidade REST para habilitar o acesso as API´s.
Clique aqui para detalhes sobre como habilitar o serviço de APIs
Também é necessário ativar a Porta Multiprotocolo para que aconteça a Integração de aplicação PO UI com o Protheus.
Application Server - Porta Multiprotocolo
Para envio de e-mails utilizando o campo 'layout padrão', será necessário criar a pasta 'protheus_data\notificacoes-pls' e dentro dela informar os arquivos 'logo.jpeg'(logo da operadora) e 'style.css'(Copiar o texto abaixo)
.img-logo { width: 250px; height: 100px; object-fit: contain; } .title { margin-top: 2%; } table { text-align: center; background-color: #ffffff; padding-top: 20px; color: #434245; width: 100%; border: 0; border-collapse: collapse; } td { vertical-align:top; } p { font-size: 14px; padding-right: 30px; padding-left:30px; }
Após realizar as configurações no INI do Protheus, vamos acessar a tela do Cadastro de Alertas em PO UI:
Imagem meramente ilustrativa, podendo sofrer alterações.
b. Funcionamento da Rotina
i. Página Inicial
Ao abrir a rotina, todos os alertas cadastrados serão exibidos em uma lista, e cada um terá as opções de Editar e Visualizar.
A rotina possui três opções na laterial superior esquerda, Recarregar, Configurações e Sair.
A opção "Recarregar" dispara novamente busca dos alertas, realizando um refresh na tabela com os dados retornados.
A opção "Configurações", irá abrir uma tela para a configuração do MV_PLTOP. Importante frisar que após a confirmação, o conteúdo informado será criptografado durante a gravação em nossa base de dados, com o objetivo de garantirmos uma maior segurança.
Por fim, a opção "Sair" irá retornar para a página inicial do módulo de plano de saúde.
Além disso, é possível filtrar os alertas através das opções "Buscar na lista abaixo" ou "Busca Avançada". Veja um exemplo a seguir:
ii. Editar um registro
Para editar um alerta siga os passos a seguir:
- Acesse Atualizações/ Portal/ Cadastro de Alertas.
- Será exibida a tela inicial com os alertas disponíveis para customização.
- Clique sobre o ícone de edição no registro desejado.
- Preencha os campos conforme necessidade.
- Confira os dados e confirme.
Importante
- Nos campos de conteúdo do e-mail e conteúdo da notificação via portal, é possível informar texto ou código HTML.
- Imagens e estilização CSS só refletirão no envio de e-mail. Os arquivos devem ser anexados na pasta notificacoes-pls da protheus_data, com isso a referência de arquivos deve ficar algo como: <img src="notificacoes-pls/logo.jpeg" title="logo" class="img-logo"> e <link rel="stylesheet" href="notificacoes-pls/style.css">.
- Para customizar ainda mais os alertas via e-mail e via portais, é possível informar Alias, [%ALIAS->CAMPO%]. Serão substituídos pelo conteúdo dos campos correspondentes nos alertas enviados, sempre entre [%%]. Importante frisar é que os Alias referenciados devem estar abertos no momento do envio do alerta.
- Os processos que enviarão alertas serão pré cadastrados com conteúdo padrão de mensagem, com a possibilidade de customização pelo cliente posteriormente.
- O e-mail de destino será resgatado dos campos BA1_EMAIL ou BAU_EMAIL, dependendo do caso.
CONFIGURAÇÃO ENVIO MENSAGEM POR WHATSAPP
Atualmente o sistema de envio de mensagem por WhatsApp estará disponível apenas para os Clientes que tenha adquirido a RD Conversas. Para a configuração das credenciais do mesmo é necessário o preenchimento de alguns parâmetros localizado na sessão 4. Lembrando que o preenchimento do MV_PLTOP deve ser pela opção "Configurações" na lateral esquerda superior da tela.
iii. Visualizar um registro
Para visualizar um alerta, basta clicar no ícone de visualização sobre o registro desejado:
04. TELA CADASTRO DE ALERTAS
Outras Ações / Ações relacionadas
Ação | Descrição |
---|---|
Não se aplica | Não se aplica |
05. TELA CADASTRO DE ALERTAS
Principais Campos e Parâmetros
Campo | Descrição |
---|---|
BAU_WPP | Número de whatsapp da RDA |
BA1_WPP | Número de whatsapp do beneficiário |
Parâmetros | Descrição |
---|---|
MV_PLTURL | Indica o endpoint do RD Conversas. (Ex: https://kong.tallos.com.br/) |
MV_PLTPTH | indica o path do endpoint da RD Conversas. (EX: megasac-api/api/v3/message/template/send) |
MV_PLTTKN
| indica o token que iremos utilizar para autenticar as requisições da RD Conversas. |
MV_PLTOP | indica o operator id fornecido pela RD Conversas. |
06. PONTO DE ENTRADA
Descrição: | Ponto de Entrada para realizar envios ou gravações após o envio dos alertas. | ||||||
Localização: | Envio de Alertas | ||||||
Nome: | PLNOTIF | ||||||
Programa Fonte: | PLSNOTIFICA | ||||||
Parâmetros: |
| ||||||
Retorno: | Nenhum |
#include "PROTHEUS.CH" User Function PLNOTIF Local cParam := paramixb[1] if BQ7->BQ7_EMAIL == '000003' //Token de atendimento Conout("O token do beneficiario " + alltrim(BA1->BA1_NOMUSR) + " é: " + cParam) endif Return
07. TABELAS UTILIZADAS
- BQ7 - Cadastro de Alertas
Criação da Tabela BQ7:
Tabela | Descrição | Ac. Filial | Ac. Unidade | Ac. Empresa |
---|---|---|---|---|
BQ7 | Cadastro de Alertas | Compartilhado | Exclusivo | Exclusivo |
Inclusão de campos no arquivo SX3:
Tabela | Campo | Tipo | Ordem | Tamanho | Titulo | Descrição | Valid. | Visual? | Contexto | CBOX | Obrigatório |
---|---|---|---|---|---|---|---|---|---|---|---|
Tabela | Campo | Tipo | Ordem | Tamanho | Titulo | Descrição | Valid. | Visual? | Contexto | CBOX | Obrigatório |
BQ7 | BQ7_FILIAL | Caracter | 01 | 8 | Filial | Filial do Sistema | Visualizar | Real | |||
BQ7 | BQ7_CODIGO | Caracter | 02 | 6 | Código | Código do Processo | Visualizar | Real | Sim | ||
BQ7 | BQ7_DESCRI | Caracter | 03 | 200 | Descrição | Descrição do Processo | Visualizar | Real | Sim | ||
BQ7 | BQ7_NOTIF | Caracter | 04 | 1 | Envia Notif? | Envia Notificação Portal? | Pertence("01") | Visualizar | Real | 1=Sim;0=Não | |
BQ7 | BQ7_TITNOT | Caracter | 05 | 40 | Título Notif | Título da Notificação | Visualizar | Real | |||
BQ7 | BQ7_TIPNOT | Caracter | 06 | 1 | Tipo Notif. | Tipo da Notificação | Pertence("12") | Visualizar | Virtual | 1=Portal Autorizador;2=Portal Beneficiario | |
BQ7 | BQ7_TXTNOT | Memo | 07 | 999 | Cont. Notif. | Conteúdo da Notificação | Visualizar | Real | |||
BQ7 | BQ7_WPP | Caracter | 08 | 1 | Envia Whats? | Enviar Whatsapp? | Pertence("01") | Visualizar | Virtual | 1=Sim;0=Não | |
BQ7 | BQ7_TEMPLA | Caracter | 09 | 50 | Cód. Templat | Código do Template | Visualizar | Real | |||
BQ7 | BQ7_EMAIL | Caracter | 11 | 1 | Envia Email? | Enviar E-mail? | Pertence("01") | Visualizar | Real | 1=Sim;0=Não | |
BQ7 | BQ7_TXTEMA | Memo | 12 | 999 | Cont. Email | Conteúdo do E-mail | Visualizar | Real |
Inclusão de índice no Arquivo SIX:
Ordem | Descrição | Campo |
---|---|---|
1 | Codigo do processo referente ao alerta | BQ7_FILIAL+BQ7_CODIGO |