Integração Whatsapp (Laudos)
- Renan Mitsuo Oka
- Rafael Carvalho
- Guilherme Augusto Borella
Manual com o objetivo de realizar passo a passo a configuração para Integração via WhatsApp, enviando mensagens após o laudo ficar pronto.
Versão | Proprietário | Nota | Data |
|---|---|---|---|
1.0 | @Renan Mitsuo Oka | Criação de documento | 14/04/2021 |
1.1 | @Renan Mitsuo Oka | Incluído informação de token | 21/06/2021 |
1.2 | @Renan Mitsuo Oka | Incluído link de exemplo da API | 27/07/2022 |
1.3 | @Renan Mitsuo Oka | Incluído texto de exemplo de envio de mensagem | 27/09/2022 |
1.4 | @Guilherme Augusto Borella | Edição do título | 01/11/2022 |
1.5 | @Rafael Carvalho | Atualização do Manual com nova API | 22/12/2022 |
1.6 | @Rafael Carvalho | Atualização URL API e Pré-Requisitos | 24/03/2023 |
1.7 | @Rafael Carvalho | Atualização do Manual com nova API | 05/01/2024 |
Índice
Primeira etapa: Pré-Requisitos.
Aquisição do Produto pelo cliente:
Antes de iniciar o processo o cliente deverá adquirir o produto com o setor comercial.
Após realizar o processo será enviado um e-mail para o cliente contendo as informações necessárias para ativação da conta.
Após ativação da conta entre na url https://jaenvios.com.br/dashboard/authenticate/login com o seu respectivo usuário e senha e click sobre o botão “ENTRAR”.
Dentro da Plataforma, devemos configurar o número e fazer a leitura do QRCode para acessar o WhatsApp, gerar o Token para acessar a API e criar um grupo de usuários.
Esses dados serão usado para disparo de mensagens e configuração dos parâmetros no sialab.
Devemos acessar a aba “WHATSAPP” no menu superior, e em seguida ir na opção “CONTAS” e clicar no botão “ADICIONAR CONTA” para fazermos a leitura do QRCode, Feito isso, será aberto um Modal, onde devemos clicar em “LINK DA CONTA”, conforme imagem abaixo:
Nesse momento, é ideal que esteja com o Celular do número WhatsApp em mãos para conseguir efetuar a leitura do QRCode, indo na opção de “” e posteriormente em “Aparelhos Conectados”, conforme imagem abaixo:
Em seguida, devemos clicar na opção “Conectar um aparelho”, onde será aberto a câmera para fazermos a leitura do QRCode, conforme imagem abaixo de exemplo:
Após clicar no botão de “LINK DA CONTA” na plataforma JAENVIOS, será aberto o QRCode e ficará disponível para leitura por 15 segundos, caso não consiga fazer a leitura deverá refazer o processo.
O QRCode tem validade de 15 segundos, após isso ele entende que não vai haver conexão e encerra o QRCode.
Após realizar a leitura do QRCode, o WhatsApp estará conectado, e devemos copiar o ID de Conexão gerado pelo sistema, conforme imagem abaixo:
Clicaremos no ícone ““ para realizar a cópia do token, será exibido uma mensagem de sucesso.
Após isso, podemos jogar esse código em um notepad por exemplo para mantermos salvo.
Segunda etapa: Geração de Token API
Devemos acessar a aba “FERRAMENTAS” no menu superior, e em seguida ir na opção “CHAVES DE API” e clicar no botão “ADICIONAR CHAVE” para criarmos o Token.
Feito isso, será aberto um Modal, onde devemos digitar o nome (Podemos usar o nome do cliente apenas por padronização) para geração do Token e as Permissões (Aqui selecionaremos todas as permissões), conforme imagem abaixo:
OBS.: Há mais permissões na tela, deve rolar a barra e marcar todas as permissões, após finalizar, clicaremos em “ENVIAR” para salvar as permissões/token.
Será exibido na tela o Token que Criamos:
Clicaremos no ícone ““ para realizar a cópia do token, será exibido uma mensagem de sucesso.
Após isso, podemos jogar esse código em um notepad por exemplo para mantermos salvo.
Terceira etapa: Configuração de Parâmetros Easyvet
Após obter os requisitos acima, siga o manual abaixo:
Ir até o menu Configurações > Parâmetros do sistema > Integrações > WhatsApp.
Irá abrir a tela a seguir:
Iremos colocar uma Data de Ativação (Passará a enviar mensagens para as amostras cujo a data de entrada seja > ou = a Data de Ativação).
Marcar a opção “Utiliza Integração com o WhatsApp.”
Informar a URL da API (https://api-v1-envios.softpower.net.br/webhook/softeasy-connect)
Informar o Token (Antes de informar o token é necessário colocar Bearer e depois colocar o Token que geramos na Segunda Etapa).
Informar o ID de Conexão (Colar o ID de Conexão que geramos na Primeira Etapa).
Informar o Sender ID (Fixo 2211)
Informar o API ID (Fixo 2)
Informar o BD (Aqui, podemos colocar um GRUPO de Contatos da plataforma, caso queiramos gravar os contatos na plataforma utilizando o caractere {} no nome do paciente, ou seja {#cliente#}, isso pode ser usado como estratégia para o cliente realizar algum envio de mensagem direto pela plataforma JaEnvios referente a alguma campanha ou algo do tipo), caso não tenha o grupo não terá problema nenhum, pode colocar o nome do laboratório no campo.
Informar o Conector (Nome do Cliente).
Informar a Marca (Nome do Cliente).
Tipo de Envio: Texto (Apenas essa opção está funcional hoje).
Marcar a opção “Envia notificação de resultados de exame.”
Escrever a mensagem que será utilizada no envio da mensagem quando a amostra estiver completa (Somente se todos os exames da amostra estiver concluído).
O cliente deve escolher a mensagem, recomendamos a mensagem padrão trocando pelos dados do laboratório:
USAR {} em volta da tag #cliente# somente se for usar o grupo de contatos
Olá, {#cliente#}
O seu resultado #posto##amostra# está pronto e disponível.
Para receber basta clicar no link abaixo e tenha o acesso aqui mesmo pelo whatsapp.
#url_resultado#
O link não está abrindo?
Siga o passo a passo.
1° Salve o contato da SOFTEASY BOT em seu celular
2° Verifique se o link ficou em azul
3° Clique no link que irá te direcionar para o seu resultado
Prontinho, caso tenha alguma duvida e/ou sugestões, favor entrar em contato com nossa central de atendimento no WhatsApp (11) 2094-4117 ou ligue (11) 2094-4117.
Vou mostrar também um exemplo criando um Grupo de Contatos e salvando o Contato na plataforma.
Acessar a aba “CONTATOS” no menu superior, e ir na opção “GRUPOS”, em seguida clicar em “ADICIONAR GRUPO”, digitar o nome desejado e clicar em “ENVIAR”.
Após isso, na listagem devemos pegar o ID gerado pela plataforma.
Nesse caso, o ID gerado é 10, devemos colocar isso no campo “BD”.
Exemplo da tela configurada com as orientações acima (Apenas para laudo):
Agora é necessário informar as frases que serão utilizada na Agenda “Envia mensagens de agendamento” - Agendamento, Confirmação, Cancelamento, Retorno (Somente se for Easyclinic) ou Envio de Laudo “Envia notificação de resultado de exame” (Easyclinic ou Easylab).
RECOMENDAMOS APÓS CONFIGURAR O AMBIENTE, UTILIZAR A OPÇÃO “Testar envio de mensagem”.
Agora, devemos incluir a URL do Laudo.
Acessar o menu Configurações > Parâmetros do sistema > Laudos Web.
Na parte final da página, deverá ser inserido a url de acesso ao portal do cliente.
Obs.: Atente-se ao utilizar o “cliente_id”, pois esse é o identificador do id do cliente no portal de exames.
Url portal de teste: http://portal.softeasy.com.br:8090/movpacs/laudo_view?posto=#posto#&amostra=#amostra#&cliente_id=108&net=#senha#
Url portal de produção: https://portal.softeasy.com.br:444/movpacs/laudo_view?posto=#posto#&amostra=#amostra#&cliente_id=108&net=#senha#
Texto de exemplo para usuários do portal softeasy.
Olá, {#cliente#}
O seu resultado #posto##amostra# está pronto e disponível.
Para receber basta clicar no link abaixo e tenha o acesso aqui mesmo pelo whatsapp.
#url_resultado#
O link não está abrindo?
Siga o passo a passo.
1° Salve o contato da SOFTEASY BOT em seu celular
2° Verifique se o link ficou em azul
3° Clique no link que irá te direcionar para o seu resultado
Prontinho, caso tenha alguma duvida e/ou sugestões, favor entrar em contato com nossa central de atendimento no WhatsApp (11) 2094-4117 ou ligue (11) 2094-4117.
Após o processo acima deverá ser configurado o interface.exe
Os Laudos só serão enviados quando os exames estiverem completos (Assinados), Interface irá criar a fila para envio de whatsapp (app_fila) e o interface_whats do item 2 será responsável pelo envio das mensagens consumindo os dados do app_fila.
Após o término da configuração deverá altera o arquivo .Bat que reinicia os robôs de interfaces e incluir uma linha com o robô do wpp para que reinicie junto com os demais.