Árvore de páginas


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)

style.css
.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 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:

  1. Acesse Atualizações/ Portal/ Cadastro de Alertas.
  2. Será exibida a tela inicial com os alertas disponíveis para customização.
  3. Clique sobre o ícone de edição no registro desejado.
  4. Preencha os campos conforme necessidade.
  5. 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çãoDescrição
Não se aplicaNão se aplica

05. TELA CADASTRO DE ALERTAS

Principais Campos e Parâmetros

CampoDescrição
BAU_WPPNúmero de whatsapp da RDA
BA1_WPPNúmero de whatsapp do beneficiário
ParâmetrosDescriçã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:

Nome

Tipo

Descrição

cParam

C

Parametro com mensagem especifica da notificação.

Retorno:Nenhum



Ponto de Entrada
#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 AlertasCompartilhadoExclusivoExclusivo


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_FILIALCaracter018FilialFilial do Sistema
VisualizarReal

BQ7 BQ7_CODIGOCaracter026CódigoCódigo do Processo    
VisualizarReal
Sim
BQ7 BQ7_DESCRICaracter03200DescriçãoDescrição do Processo    
VisualizarReal
Sim
BQ7 BQ7_NOTIF Caracter041Envia Notif?Envia Notificação Portal?Pertence("01")VisualizarReal1=Sim;0=Não                                                                                                             
BQ7 BQ7_TITNOTCaracter0540Título NotifTítulo da Notificação  
VisualizarReal

BQ7 BQ7_TIPNOTCaracter061Tipo Notif. Tipo da Notificação      Pertence("12")VisualizarVirtual1=Portal Autorizador;2=Portal Beneficiario                                                                               
BQ7 BQ7_TXTNOTMemo07999Cont. Notif.Conteúdo da Notificação  
VisualizarReal

BQ7 BQ7_WPP   Caracter081Envia Whats?Enviar Whatsapp?         Pertence("01")VisualizarVirtual1=Sim;0=Não                                                                                                                     
BQ7 BQ7_TEMPLACaracter0950Cód. TemplatCódigo do Template     
VisualizarReal

BQ7 BQ7_EMAIL Caracter111Envia Email?Enviar E-mail?           Pertence("01")VisualizarReal1=Sim;0=Não                                                                                                                     
BQ7 BQ7_TXTEMAMemo12999Cont. Email Conteúdo do E-mail    
VisualizarReal


Inclusão de índice no Arquivo SIX:

Ordem

Descrição

Campo

1Codigo do processo referente ao alerta                 BQ7_FILIAL+BQ7_CODIGO            
  • Sem rótulos