Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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 RMe 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
labelExemplo de UtilizaçãoAgendamento de consulta

Configurar o agendamento de consulta:

Premissas:

  1. Considerando que a conta e número de Whatsapp do 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(Cópia) _FLUXO_AGENDAMENTO.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 necessá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
labelConfirmação de consulta

Configurar confirmação de consulta:


Premissas:

  1. Considerando que a conta e número de Whatsapp do RD Conversas by Tallos, esteja OK (seleção)
  2. Considerando que tenha um Ambiente RM em CLOUD e OK (seleção)
  3. O ambiente do RM está em 3 camadas
    1. Caso não esteja pode consultar as documentacões:
      1. Configuração para simular 3 camadas - JobServer
      2. https://tdn.totvs.com.br/pages/releaseview.action?pageId=270085915


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

  1. Importar fluxo de Confirmação / Cancelar agendamento
  2. Apontar para meu ambiente - Trocar URLs + Token de usuário
  3. Inserir parâmetros no RM
  4. Executar/Programar Envio de confirmação
  5. Resposta do paciente
  6. Customização é possível?


Importar fluxo de Confirmação / Cancelar agendamento:


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 confirma agenda: (Ultima atualização 04/06/2024)

View file
name_FLUXO_CONFIRMAAGENDA (1).json
height250

Fluxo cancela agenda: (Ultima atualização 04/06/2024)

View file
name_FLUXO_CANCELAAGENDA (2).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. 


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 necessá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


Inserir parâmetros RM:

Para funcionar a integração entre RM  RD Conversas by Tallos  e preciso inserir informações dentro do sistema para se comunicarem.


Onde insiro os parâmetros?

  • Apenas é inserido no RM, dentro da plataforma do RD Conversas by Tallos, não e necessário.
  • Os parâmetros ficam dentro de Ambiente>Parâmetros>Gestão Hospitalar>Integração WhatsApp
  • Image AddedImage Added
  • Os dados devem ser obtidos junto ao RD conversas by Tallos:
    • Endereço base da integração
    • Endpoint
    • Token
    • ID do template(template_message_id)(Deve ser criado e configurado junto ao time de RD Conversas by Tallos)
  • O dado de "Quantidade de dias anteriores a consulta", deve ser preenchido de acordo com o processo de cada cliente
    • Exemplo: Caso o cliente queira confirmar todas as agendas do dia seguinte, a data atual, então informa o numero "1", significa que vai confirmar todas as agendas 1 dia antes da data da consulta.
    • Exemplo: Caso o cliente queira confirmar todas as agendas 3 dias antes do agendamento, então informa o número "3", significa que vai confirmar todas as agendas 3 dias antes da data da consulta.
  • Após todos os campos preenchidos, então basta concluir a parametrização, para salvar as informações.
  • Image Added
  • Tambem deve se alterar o fluxo dentro do  RD conversas by Tallos, mudando o parâmetro de ScheduleDate, para o mesmo valor que inseriu nos parâmetros do  RM
  • Image Added



Executar/programar envio de confirmação:

Para enviar as mensagens de confirmação por Whatsapp, e preciso agora executar ou programar o disparo do processo.


Onde consigo executar/programar?

  • Basta ir no menu Atendimento>Outros>Integração Whatsapp
  • Image Added
  • Definir a execução, se enviar Agora, ou se programar o JOB para executar sob demanda de acordo com a parametrização escolhida.
  • Image AddedImage Added
  • Ao executar, será enviado as mensagens de confirmação por Whatasapp.
  • Image Added


Quais agendas serão enviadas?

  • Todas as agendas que estão dentro do parâmetro de quantidade de dia informado nos parâmetros gerais.
    • Se no parametro gerais, informado o valor "1", então todas as agendas do dia seguinte serão consideradas.
  • Todas as agendas que tenha numero de celular informado.
    • Caso a agenda não tenha o numero cadastrado, então não será informado.
    • Caso o número tenha algum erro onde o RD Conversas by Tallos não consiga mandar, também irá retornar erro
  • Todas as agendas com a data de nascimento informado.
    • Dado usado para o envio da mensagem de confirmação dos dados do paciente.
    • Caso não tenha, irá dar falha ao enviar.


Resposta do paciente:

o paciente tem 3 caminhos ao receber a mensagem de confirmação

  1. Confirmar sua presença
  2. Cancelar seu agendamento
  3. Conversar com atendente


Como o paciente confirma o agendamento?

  • Ao receber a mensagem, o paciente terá a opção "Sim, confirmar".
  • Ao clicar, iremos exibir quais os horários do dia informado deseja confirma, para caso tenha mais de um horário no mesmo dia.
  • Quando o paciente selecionar, qual a opção de confirmação, então e informado e atualizado na agenda do RM.
  • Image Added
  • Image Added
  • Image Added

Como o paciente cancela o agendamento?

  • Ao receber a mensagem, o paciente terá a opção "Não, cancelar".
  • Ao clicar, iremos exibir quais os horários do dia informado deseja cancelar, para caso tenha mais de um horário no mesmo dia.
  • Quando o paciente selecionar, qual a opção de cancelamento, então e informado ao usuário e retirado na agenda do RM,  liberando o espaço da agenda.

Como o paciente conversa com atendente?

  • Ao receber a mensagem, o paciente terá a opção "Conversar com atendente".
  • Ao clicar, iremos direcionar ao chat para contato com um atendente humano.
  • 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. 

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 > Ramâmetros > Gestão Hospitalar

Image Removed

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

Image Removed

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

Image Removed

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

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 dadas disponíveis para os prestadores na unidade informada;

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) acesse Atendimento > Outros > Integração Whatsapp. 

Image Removed

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

Image Removed

É 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.

Image Removed

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.

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 o paciente cancele o agendamento, o status do Agendamento é alterado para "Cancelado"