Card |
---|
| VISÃO GERALA 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? - Uma conta ativa no RD Conversas By Tallos, e com numero de WhatsApp disponível para uso.
- Um ambiente do RM, de preferência usando o CLOUD da TOTVS.
- 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.
- {Confirmação de consulta} Será preciso um ambiente do RM, 3 camadas.
|
Card |
---|
label | Agendamento de consulta |
---|
| Configurar o agendamento de consulta:Premissas: - Considerando que a conta e número de Whatsapp do RD Conversas by Tallos, esteja OK
![(seleção)](/s/ougqdk/8804/xgjkrn/_/images/icons/emoticons/check.svg) - Considerando que tenha um Ambiente RM em CLOUD e OK
![(seleção)](/s/ougqdk/8804/xgjkrn/_/images/icons/emoticons/check.svg)
Com estes pontos de premissa superados o que mais iremos precisar? - Importar fluxo de agendamento de consulta.
- Apontar para meu ambiente - Trocar URLs + Token de usuário
- 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 |
---|
height | 250 |
---|
|
Obs: Arquivo pode sofrer atualizações.
Onde eu importo o fluxo, dentro do RD conversas by Tallos? - Acesse a página https://app.tallos.com.br/(sujeito a modificação pela plataforma RD Conversas)
- Faça Login, com suas credenciais.
- Encontre o menu de Automação> Fluxos.(Sujeito a modificação pela plataforma RD Conversas)
- Clique em Importar Fluxo.
- 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árioAgora, 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 |
---|
label | Confirmação de consulta |
---|
| Configurar confirmação de consulta:
Premissas: - Considerando que a conta e número de Whatsapp do RD Conversas by Tallos, esteja OK
![(seleção)](/s/ougqdk/8804/xgjkrn/_/images/icons/emoticons/check.svg) - Considerando que tenha um Ambiente RM em CLOUD e OK
![(seleção)](/s/ougqdk/8804/xgjkrn/_/images/icons/emoticons/check.svg) - O ambiente do RM está em 3 camadas
- Caso não esteja pode consultar as documentacões:
- Configuração para simular 3 camadas - JobServer
- https://tdn.totvs.com.br/pages/releaseview.action?pageId=270085915
Com estes pontos de premissa superados o que mais iremos precisar? - Importar fluxo de Confirmação / Cancelar agendamento
- Apontar para meu ambiente - Trocar URLs + Token de usuário
- Inserir parâmetros no RM
- Executar/Programar Envio de confirmação
- Resposta do paciente
- 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 |
---|
height | 250 |
---|
|
Fluxo cancela agenda: (Ultima atualização 04/06/2024) View file |
---|
name | _FLUXO_CANCELAAGENDA (2).json |
---|
height | 250 |
---|
|
Obs: Arquivo pode sofrer atualizações.
Onde eu importo o fluxo, dentro do RD conversas by Tallos? - Acesse a página https://app.tallos.com.br/(sujeito a modificação pela plataforma RD Conversas)
- Faça Login, com suas credenciais.
- Encontre o menu de Automação> Fluxos.(Sujeito a modificação pela plataforma RD Conversas)
- Clique em Importar Fluxo.
- 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árioAgora, 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 e 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 Added Image 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 Added Image 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 - Confirmar sua presença
- Cancelar seu agendamento
- 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. | Card |
---|
label | Exemplo de Utilização |
---|
| EXEMPLO DE UTILIZAÇÃOOs 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 GeraisRm > 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 WhatsappPara 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
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 agendamentoAo 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. 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. 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 PACIENTEInicialmente o paciente entra em contato com o número informado pela clínica:
Image RemovedEm seguida o paciente informa o cpf para que o sistema possa reconhecer o paciente caso o mesmo exista na base de dados do RM:
Image Removed Image Removed Feito isso, o paciente deve preencher as informações de seu atendimento, tais como: plano, especialidade, unidade, prestador.
Image Removed Image Removed Image Removed Image Removed O próximo passo é selecionar uma data e horário disponíveis para o atendimento:
Image Removed Image Removed 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. Image Removed
|
|