Integração WhatsApp - SOFTPOWER
  • Pronto para análise
  • Integração WhatsApp - SOFTPOWER

    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

    Versão

    Proprietário

    Nota

    Data

    1.0

    @Rafael Carvalho

    Criação de documento

    06/12/2023

    Í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://cliente.softpower.net.br/ 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 “Serviços” no menu superior, e em seguida ir na opção “WhatsApp Qrcode” 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:

     

    image-20240726-185253.png
    Figura 1. Adicionando Conta para WhatsApp

    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:

    Figura 2. Acessando configuração WhatsApp.

    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:

    Figura 3. Conectando Aparelho via QRCode.

    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.

    Figura 4. Geração de QRCode na plataforma.

    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:

    Figura 5. Copiando Código de ID de Conexão.

    Clicaremos no ícone para realizar a cópia do token, será exibido uma mensagem de sucesso.

    Figura 6. Mensagem de Sucesso Cópia.

    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:

    Figura 7. Adicionando Chave (TOKEN) API.
    Figura 8. Incluindo Permissões Token API.

    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:

    Figura 9. Copiando Código (TOKEN) API.

    Clicaremos no ícone para realizar a cópia do token, será exibido uma mensagem de sucesso.

    Figura 10. Mensagem de Sucesso Cópia.

    Após isso, podemos jogar esse código em um notepad por exemplo para mantermos salvo.

    Terceira etapa: Configuração de Parâmetros SiaLab

    Após obter os requisitos acima, siga o manual abaixo:

    Ir até o menu Configurações > Parâmetros do sistema > Dados Integrações.

    Irá abrir a tela a seguir:

    image-20240711-180359.png
    Figura 11. Tela de Parâmetros do WhatsApp.
    • 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”.

    Figura 12. Criando Grupo de Contatos.

    Após isso, na listagem devemos pegar o ID gerado pela plataforma.

    Figura 13. Listagem de Grupo e Copiando ID do Grupo.

    Nesse caso, o ID gerado é 10, devemos colocar isso no campo “BD”.

    Exemplo da tela configurada com as orientações acima:

    Figura 14. Tela de Parâmetros do WhatsApp Preenchida.

    Após preencher as informações corretamente, clicaremos em “GRAVAR”.

    Opção “Legenda da mensagem” mostra as tags possíveis para substituição na mensagem do resultado.

    Figura 15. Legenda de Tags.

    RECOMENDAMOS APÓS CONFIGURAR O AMBIENTE, UTILIZAR A OPÇÃO “Testar envio de mensagem”.

    Figura 16. Teste de Envio de Mensagem Teste.
    Figura 17. Mensagem de Teste.

    Contatos ficaram salvos na plataforma (Pois colocamos o ID do grupo e as {} em volta da tag #cliente#).

    Figura 18. Contato salvo após envio de mensagem.

    Agora, devemos configurar a URL do Laudo, caso ainda não esteja configurada.

    Acessar o menu Configurações > Parâmetros do sistema > Laudos.

    • Caso o Checkbox “Usa visão do paciente para laudos” esteja marcado, a URL não irá trocar nenhuma TAG, ou seja, a URL digitada no campo “Url Comprovante Coleta” será a mesma que exibe na tela, caso esteja desmarcada e tenha alguma tag informada, o sistema realizará as trocas.

    Ex.: https://sia.softeasy.com.br/portal?labcode=#labcode#&tipolog=pacatend&login=#posto##amostra#&password=#password#

    #labcode#= será substituída pelo ID do laboratório (Deve ficar com a TAG na URL, o sistema que fará a troca da tag pelo ID/Código do laboratório).

    tipolog= Utilizaremos pacatend, no caso, esse tipo de login é utilizado para o login por amostra, ou seja, login que irá abrir diretamente no site.

    #posto# será substituída pelo posto do atendimento (Deve ficar com a TAG na URL, o sistema que fará a troca da tag pelo posto).

    #amostra# será substituída pelo posto do atendimento (Deve ficar com a TAG na URL, o sistema que fará a troca da tag pela a amostra).

    #password# será substituída pela senha do atendimento (Deve ficar com a TAG na URL, o sistema que fará a troca da tag pela senha).

    As mensagens só serão enviadas quando os exames estiverem Completos (Assinados), após realizar a liberação do último exame, será criado o registro na (app_fila) e realizado a tentativa de envio da mensagem no momento da liberação, caso de algum erro durante o processo, será exibido a mensagem do erro em tela, criado o registro na app_fila e será possível realizar o reenvio pela tela de Integração WhatsApp.

    Caso dê certo, irá apresentar a mensagem de sucesso conforme imagem abaixo:

    Figura 19. Envio de mensagem para paciente Completo, pós assinatura.
    Figura 20. Mensagem whatsapp enviada.

    Painel de Integração (Reenvio de Mensagens - Consulta de Mensagens Enviadas/Não Enviadas)

    Nessa tela, podemos consultar todas as mensagens que houve tentativa de envio para o whatsapp, as que tiveram falha, é possível reenviar clicando no botão “Reenviar não enviados”, é possível também realizar os filtros para encontrar um determinado posto/amostra, assim como filtrar só por já enviados, não enviados, ou todos.

    Para acessar, devemos ir no Menu Integrações > Integração com WhatsApp, conforme imagem abaixo:

    image-20240711-180142.png
    Figura 21. Menu de Acesso Painel de Integração de Mensagens WhatsApp.
    Figura 22. Painel de Integração de Mensagens WhatsApp.

    O Reenvio só é feito para as que não foram enviadas, ou seja, só é feito 1 envio com SUCESSO por amostra, os reenvios podem ser realizados N vezes, não tem limitação.

    As informações utilizadas para o reenvio, serão sempre as atuais (N° telefone, Nome do Paciente, Parametrização para envio da mensagem, etc.), então se houver alguma falha por telefone incorreto ou não existente por exemplo, deverá ser atualizado no prontuário e posteriormente reenviado no painel, com isso será utilizado o novo número informado e reenviado a mensagem, o mesmo é válido para os demais registros.

    Figura 23. Reenvio de Mensagem via Painel de Integração.

    Conclusão

    O WhatsApp é uma das ferramentas mais utilizada hoje no dia a dia para facilitar a comunicação, e se tornou muito útil para interação com o paciente de forma rápida, podendo ser habilitado/desabilitado a qualquer momento desde que o cliente possua o pacote.

    Podemos considerar que o envio de mensagens de resultado pronto via WhatsApp é um recurso moderno e se torna essencial para laboratórios que estão se modernizando, oferecendo novas soluções aos seus pacientes, além de confiabilidade nos processos.