Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Complementado documentação (Não finalizado)

...

Deck of Cards
idPainel
Card
labelVisão Geral

VISÃO GERAL

A integração com WhatsApp permite que o paciente possa fazer os agendamentos Agendamentos de consultas e exames 100% via WhatsApp , sem mesmo ter que acessar um website ou aplicativo.

Para que esse processo seja feito, é necessária a configuração dos parâmetros gerais de Integração com WhatsApp/RD Conversas no RM.

e automatizada..

Alem disso é possível configurar e agendar Confirmações de consulta periódicas, onde será enviado uma mensagem de confirmação ao paciente , para que ela possa confirmar ou cancelar o agendamento.


O que é preciso para funcionar?

  1. Uma conta ativa no RD Conversas By Tallos, e com numero de WhatsApp disponível para uso.
  2. Um ambiente do  RM,  de preferência usando o CLOUD da TOTVS.
    1. Para os clientes não estão em ambiente CLOUD, e preciso alinhar com o time de RD Conversas By Tallos, para mais orientações de como se comunicar com as APIs do RM.
  3. {Confirmação de consulta} Será preciso um ambiente do RM, 3 camadas.
Card
labelAgendamento de consulta

Configurar o agendamento de consulta:

Premissas:

  1. Considerando que a conta na RD Conversas by Tallos, esteja OK (seleção)
  2. Considerando que tenha um Ambiente RM em CLOUD e OK (seleção)


Com estes pontos de premissa superados o que mais iremos precisar?

  1. Importar fluxo de agendamento de consulta.
  2. Apontar para meu ambiente - Trocar URLs + Token de usuário
  3. Customização é possível?


Importar fluxo de agendamento de consulta:

Para facilitar a implantação, já deixamos um arquivo para importação de um fluxo pré definido, desta forma otimizando o tempo de construção de todo o fluxo.

Qual o arquivo preciso baixar?

E preciso baixar os arquivos abaixo:

Fluxo de agendamento de consulta: (Ultima atualização 04/06/2024)

View file
name_FLUXO_AGENDAMENTO (1).json
height250

Obs: Arquivo pode sofrer atualizações.


Onde eu importo o fluxo, dentro do RD conversas by Tallos?

  1. Acesse a página https://app.tallos.com.br/(sujeito a modificação pela plataforma RD Conversas)
  2. Faça Login, com suas credenciais.
  3. Encontre o menu de Automação> Fluxos.(Sujeito a modificação pela plataforma RD Conversas)
  4. Clique em Importar Fluxo.
  5. Selecione o arquivo baixado.

Image Added


Assim que importar o arquivo o fluxo irá aparecer na lista de fluxos disponíveis na lista. 

  • Para que o seu fluxo já seja visível, a partir do momento que o cliente mandar um "Oi", no número disponível, basta clicar no icone Image Added, do fluxo pretendido, e informar que deseja "Aplicar no inicio", de todos canais disponíveis.

Apontar para meu ambiente - Trocar URLs + Token de usuário

Agora, para que o fluxo seja direcionado e se conecte ao seu RM, precisamos informar as URLs de comunicação das APIs. Isso fará com que o  RD Conversas by Tallos, se comunique e busque as informações nevessárias.

Obs: Caso não saiba qual é sua URL de comunicação, peça apoio ao time da TOTVS.


Como trocar as URLs?

  • Clique no ícone Image Added, do fluxo pretendido.
  • Irá abrir o fluxo para modificação, você pode navegar usando os comandos do mouse e botões no topo da página(sujeito a modificação pela plataforma RD Conversas)
  • Image Added
  • Encontre todos os Card(conforme exemplo), e troque onde está {Insira a informação aqui}, pela URL disponível.
  • Image Added
  • Faça isso para todos os Cards, será necessário navegar no fluxo para olhar 1 por 1.

Como trocar o usuário?

  • Em todos os Cards, igual no exemplo anterior, onde trocamos as URLs, deve se trocar o token , no campo "Authorization"
  • Image Added
  • Para conseguir este Token, poderá pedir apoio ao time de RD Conversas by Tallos, ou do time da TOTVS.


Mas caso queira obter manualmente, precisamos de:

  • Acessar a plataforma https://postman.com.br/.
  • Criar uma Workspace para testes de APIs.
  • Informar uma URL+ Rota, igual está configurado no RD Conversas by Tallos.
  • Inserir usuario e senha na aba "Authorization", dentro do postman.
  • E usar o recurso de Enviar do postman.
  • Ao fazer isso, conferimos na Aba "Console", qual e o token de authorization, que devemos usar na plataforma  RD Conversar by Tallos.
  • Image Added



Customização é possível?

Sim, o  RD conversas by Tallos, aceita todo o tipo de modificação no fluxo, como duplicar e criação de novos fluxos.

Apenas se certifique de testar o fluxo e inserir as informações de comunicação com o as APIs do RM corretamente.


Para saber como cada API funciona e o que configurar no  RM  para que ela retorne corretamente, acesse a Aba de API's RM.

Card
labelExemplo de Utilização
EXEMPLO DE UTILIZAÇÃO




Os campos a serem configurados são: Endereço base da integração, Endpoint, Token, ID do Operador, ID do Template e Quantidade de dias anteriores a data do agendamento.

Essa configuração é feita em:

Configuração de parâmetros Gerais

Rm > Ambiente > Parâmetros > Gestão Hospitalar



Escolha a opção Integração com Whatsapp



Configure os parâmetros de Integração do WhatsApp conforme os requisitos do RD Conversas



Essas configurações são gravadas na tabela SZPARAM conforme previsto na migração dos parâmetros gerais vindos do Delphi.

Rotas chamadas para integração com Whatsapp

Para a integração com WhatsApp no RD Conversas, foi necessária a criação/edição de rotas na API da Solução do Saúde que fossem compatíveis com as etapas do processo de cadastro de agendamento de consulta, tele consulta e exames via WhatsApp.

Foi necessária a criação/edição das seguintes rotas:

  • GET - api/hcg/v2/patients-integration

Detalhes: Verificar se o paciente existe na base de dados;

Image Removed

  • POST - pi/hcg/v2/patients

Detalhes: Cadastrar o paciente caso o mesmo não exista;

Image Removed

  • GET - api/hcg/v2/specialty

Detalhes: Obter dados de Especialidades ativas;

Image Removed

  • GET – api/hcg/v2/unity

Detalhes: Obter dados de Unidades de atendimentos da especialidade informada;

Image Removed

  • GET - api/hcg/v2/practitioner

Detalhes: Obter dados de Prestadores de Serviços ativos da unidade e especialidade informadas;

Image Removed

  • GET - api/hcg/v2/appointment-availables

Detalhes: Obter datas disponíveis para os prestadores na unidade informada;

Image Removed

  • POST - api/hcg/v1/sau-portal/insuranceCompanies/validate-contractual-conditions

Detalhes: Verificar se condições contratuais estão configuradas corretamente para verificar a elegibilidade do Convênio/carteirinha;

Image Removed
  • POST - api/hcg/v1/sau-portal/insuranceCompanies/validate-elegibility

Detalhes: Verificar se Convênio/carteirinha está elegível;
Image Removed

  • POST - api/hcg/v2/appointment

Detalhes: Cadastrar o agendamento;

Image Removed

  • POST - api/hcg/v1/appointments-exams/appointment

Detalhes: Cadastrar o agendamento de exames;

Image Removed

Configuração de Job de confirmação de agendamento


Ao concluir o processo de agendamento via WhatsApp, o registro de agendamento é criado na Base de Dados, e dias antes da consulta/exame o paciente recebe uma notificação de agendamento no WhatsApp, onde o mesmo pode confirmar ou não o agendamento.

Para configurar e executar o Job de integração com o whatsapp (RD Conversas) faça login no RM no ambiente de 3 camadas e acesse > Atendimento > Outros > Integração Whatsapp. 

Finalize o processo e o serviço do Job estará configurado.  

É recomendado que configure o Job para ser executado todos os dias da semana em um horário específico conforme mostrado na imagem a seguir.

Com o Job configurado para execução diária, esse processo verifica os usuários com agendamentos marcados e notifica ao serviço do Rd Conversas que por sua vez notifica ao paciente via Whatsapp informando que o mesmo possui um agendamento ainda não confirmado. As informações dos processos executados são armazenadas no diretório raiz do RM>Processos>Logs.

Os pacientes são notificados dias antes a consulta conforme essa quantidade de dias for configurada em parâmetros gerais.

Caso o usuário confirme a consulta/exame, o Status do Agendamento é alterado de Agendado para "Confirmado", caso contrário o status do Agendamento é alterado para "Cancelado".

EXEMPLO DE UTILIZAÇÃO DO PACIENTE

Inicialmente o paciente entra em contato com o número informado pela clínica:

Em seguida o paciente informa o cpf para que o sistema possa reconhecer o paciente caso o mesmo exista na base de dados do RM: 


Feito isso, o paciente deve preencher as informações de seu atendimento, tais como: plano, especialidade, unidade, prestador.

O próximo passo é selecionar uma data e horário disponíveis para o atendimento: 


Concluindo o passo de seleção de data/horário do agendamento, o sistema conclui o agendamento.

Conforme configurado nos parâmetros gerais da integração com o RD Conversas e no Job de envio de confirmação, o paciente irá receber a mensagem de confirmação do agendamento dias antes do atendimento (conforme configurado) com as opções de Confirmar Atendimento, Cancelar Atendimento ou Conversar com atendente.

 
 

Card
labelConfirmação de consulta

Card
labelAPI's RM