Integração de chatbot com Doctoralia e Medicone: guia técnico

Em resumo

• Doctoralia e Medicone concentram grande parte da procura online por consultas em Portugal, com clínicas urbanas a receber tipicamente entre 30% e 60% das marcações através destes portais.
• Sem integração bidirecional entre chatbot e portais, observamos em clínicas portuguesas entre 4 e 12 marcações duplicadas por mês, cada uma a custar em média 8 a 15 minutos de tempo administrativo.
• Uma integração bem desenhada com sincronização em tempo quase real (janela de 30 a 120 segundos) reduz o risco de conflito de agendas para menos de 1%.
• O custo típico de uma integração inicial ronda 800€ a 2 500€ consoante a complexidade das especialidades e o número de profissionais, com manutenção mensal entre 40€ e 120€.

Muitas clínicas em Portugal vivem hoje com três agendas paralelas: a agenda interna (software de gestão clínica), a agenda pública em Doctoralia e a agenda no Medicone. Basta um paciente marcar às 15h00 num portal enquanto o telefone toca com outra marcação para a mesma hora, e temos um problema. Este guia descreve, em detalhe técnico, como um chatbot de IA pode falar com estes portais, sincronizar horários e prevenir sobreposições, sem quebrar as regras de publicidade em saúde definidas pela ERS.

Panorama dos portais de saúde em Portugal

Doctoralia (grupo Docplanner) e Medicone são, no momento em que este artigo é publicado, os dois portais de referência para marcação online de consultas em Portugal. Doctoralia domina em medicina dentária, dermatologia, psicologia e nutrição, com forte presença em Lisboa, Porto e Braga. Medicone tem maior expressão em unidades hospitalares privadas e em clínicas multidisciplinares que já usavam software administrativo do mesmo grupo.

Do ponto de vista técnico, os dois portais operam de forma distinta. Doctoralia disponibiliza um ecossistema mais aberto, com integrações via parceiros certificados e ligações a softwares de gestão clínica populares em Portugal. Medicone tende a integrar-se sobretudo através de módulos proprietários e trocas de ficheiros ou APIs privadas, dependendo do contrato do cliente. Para uma clínica que use ambos, a única forma de manter uma única agenda coerente é ter uma camada intermédia: o chatbot, com o seu próprio motor de agendamento, funciona bem como esse ponto de convergência.

Quando o chatbot passa a ser o interlocutor único da agenda, a clínica ganha ainda um ativo colateral: um histórico completo de conversas e intenções de marcação que os portais externos não fornecem em detalhe. Esse histórico é essencial para melhorar tempos de resposta, ajustar horários de maior procura e detetar padrões de desistência.

Arquitetura de integração: como o chatbot fala com os portais

A arquitetura típica assenta em quatro componentes: o widget de chatbot no site da clínica, um serviço orquestrador (que aloja a lógica de negócio e a sessão de conversa), um adaptador por portal e o software de gestão clínica. O orquestrador é o único componente com escrita direta na agenda mestra, o que evita que dois canais confirmem a mesma slot em simultâneo.

O chatbot conversa com o utilizador em linguagem natural, extrai a intenção (marcar, remarcar, cancelar, esclarecer), a especialidade, o profissional preferido e as janelas horárias possíveis. De seguida consulta o orquestrador, que executa três verificações antes de propor horários: disponibilidade real do profissional na agenda mestra, ausência de conflitos com marcações vindas de Doctoralia ou Medicone ainda por sincronizar, e regras de negócio da clínica (buffer entre consultas, duração por tipo de acto, limites por sala).

Só depois destas verificações é que o chatbot devolve horários ao paciente. Ao confirmar, o orquestrador cria a marcação na agenda mestra e propaga-a para os portais através dos respetivos adaptadores. Este fluxo unidirecional de escrita elimina a maioria dos conflitos e mantém a agenda mestra como fonte da verdade, que é a única postura sustentável em ambientes com múltiplos canais.

Doctoralia: capacidades típicas de integração

A integração com Doctoralia é geralmente feita por uma de três vias: ligação direta via parceiro certificado, sincronização através do software de gestão clínica (quando este é parceiro oficial) ou, em casos limitados, iCal em modo leitura. Cada via tem implicações diferentes para o chatbot.

Via parceiro certificado, o adaptador consegue tipicamente ler disponibilidades, escrever novas marcações, cancelar e reagendar, e receber notificações quando um paciente marca diretamente no portal. Esta é a configuração ideal para um chatbot que quer garantir que uma slot proposta é realmente livre. Via sincronização por software de gestão clínica, o chatbot fala com o software e este trata da comunicação com Doctoralia, o que simplifica o adaptador mas introduz latência adicional (frequentemente entre 2 e 10 minutos). Via iCal em modo leitura, o chatbot só sabe que uma slot está ocupada depois de a subscrição ao calendário ser puxada, o que introduz janelas de risco que devem ser mitigadas com dupla confirmação por email antes de dar a marcação como definitiva.

Medicone: particularidades técnicas

Medicone integra-se sobretudo através de módulos disponibilizados pelo grupo às clínicas que já usam o seu software administrativo, o que significa que a integração começa dentro do próprio software e não numa API pública genérica. Em clínicas que operam com Medicone, a estratégia mais comum é fazer com que o chatbot escreva sempre na agenda mestra do software administrativo e deixe que esse software se encarregue da propagação para o portal público.

Esta abordagem tem uma vantagem operacional: a receção continua a ver todas as marcações no mesmo sítio, sem separadores adicionais. Tem, contudo, uma desvantagem técnica: a latência de sincronização depende do módulo do fornecedor e nem sempre é configurável. Recomendamos, por isso, que o chatbot use um mecanismo de reserva provisória (soft hold) de 60 a 180 segundos na agenda mestra enquanto conversa com o paciente, libertando a slot se o utilizador abandonar o fluxo sem confirmar.

Sincronização de agendas e prevenção de marcações duplicadas

A prevenção de duplicados assenta em três mecanismos complementares. O primeiro é a reserva provisória (soft hold), que bloqueia a slot durante a conversa e é libertada por timeout se o paciente não confirmar. Este mecanismo elimina a janela de vulnerabilidade típica de 2 a 5 minutos entre a proposta de horário e a confirmação.

O segundo é o webhook (ou pooling curto) desde os portais para o orquestrador, notificando novas marcações em tempo quase real. Sempre que uma nova marcação chega, o orquestrador escreve-a na agenda mestra e desmarca automaticamente qualquer soft hold conflituoso, informando o paciente que ainda esteja em conversa que a slot deixou de estar disponível.

O terceiro é a reconciliação periódica: uma tarefa agendada que, a cada 5 a 15 minutos, compara a agenda mestra com o que está publicado nos portais e alerta a receção sobre inconsistências. Esta camada é o cinto de segurança para os casos raros em que um webhook falha ou chega fora de ordem.

Comparativo funcional das duas integrações

A tabela seguinte resume, de forma indicativa, as capacidades típicas observadas em projetos recentes em Portugal. Cada clínica deve validar com o seu fornecedor de software as opções contratadas.

Fluxo de dados, autenticação e webhooks

Do ponto de vista de segurança, todas as trocas ocorrem sobre HTTPS com autenticação por chaves API específicas por integração, guardadas fora do código-fonte (em variáveis de ambiente ou cofres de segredos). Os webhooks devem ser assinados criptograficamente e o orquestrador deve validar a assinatura antes de aceitar o payload, para evitar que terceiros injetem marcações fraudulentas.

A idempotência é outra propriedade essencial. Cada marcação recebida deve carregar um identificador único do portal de origem, e o orquestrador deve manter uma tabela de correspondência entre identificadores externos e identificadores internos. Se o mesmo webhook for entregue duas vezes (o que acontece em situações de retry), o sistema deve reconhecê-lo e não criar duplicados.

Recomenda-se ainda registar em log estruturado todas as trocas, com retenção mínima de 90 dias, para efeitos de auditoria e de reconciliação em caso de disputa com um paciente sobre uma marcação. Os dados pessoais nos logs devem ser minimizados: identificadores em vez de nomes completos, e nunca dados clínicos.

Conformidade ERS e regulatória

A integração técnica entre chatbot e portais de saúde não altera as obrigações da clínica perante a Entidade Reguladora da Saúde (ERS) e as ordens profissionais. Recomenda-se atenção especial aos seguintes pontos:

• O chatbot não deve prometer resultados clínicos nem sugerir que uma marcação garante um determinado desfecho terapêutico.
• Não deve criar urgência artificial (frases como "última vaga hoje" ou "só até ao fim do dia") para pressionar a marcação.
• Não deve comparar a clínica com concorrentes nomeados, nem afirmar superioridade sem sustentação verificável.
• Não deve prestar aconselhamento clínico ou sugerir diagnósticos; deve encaminhar sempre para a consulta.
• O consentimento RGPD para tratamento de dados deve ser recolhido de forma explícita antes de qualquer marcação, com base legal clara e informação sobre prazos de retenção.
• Preços apresentados devem coincidir com os praticados na clínica e ser consistentes com a informação publicada em Doctoralia e Medicone.
• Em áreas reguladas por ordens específicas (OMD, OM, OPP, Ordem dos Nutricionistas), o conteúdo do chatbot deve respeitar os códigos deontológicos aplicáveis, evitando expressões que configurem publicidade enganosa.

Custos, prazos e manutenção

Uma integração inicial ronda tipicamente 800€ a 2 500€, dependendo do número de profissionais, especialidades e da via de integração escolhida em Doctoralia (parceiro certificado versus software intermédio). Projetos com uma única especialidade e um a três profissionais ficam no limite inferior da faixa. Clínicas multidisciplinares com salas partilhadas e regras complexas de duração de consulta ficam no limite superior.

Os prazos de implementação, contados desde a assinatura até à entrada em produção, variam entre 3 e 8 semanas. A maior parte deste tempo é consumida por: recolha de regras de negócio, ativação das credenciais nos portais, testes de webhook, validação com a receção e período de sombra em que o chatbot corre em paralelo com o processo antigo. A manutenção mensal, que cobre monitorização, ajustes de regras e adaptações a alterações nos portais, situa-se entre 40€ e 120€, dependendo do volume de conversas e do número de integrações ativas.

Perguntas frequentes

É possível ter chatbot só num dos portais e não no outro?

Sim. Muitas clínicas começam pela integração com o portal que gera mais marcações e adicionam o segundo numa fase posterior. O importante é que a agenda mestra seja única e que o chatbot escreva sempre nela primeiro, propagando depois para o portal ativo.

O chatbot substitui o portal Doctoralia ou Medicone?

Não. O chatbot complementa os portais, capturando pacientes que chegam ao site da clínica e reduzindo a fricção de marcação. Os portais continuam a ser fontes relevantes de tráfego novo, sobretudo para pacientes que ainda não conhecem a clínica.

Quanto tempo demora a implementar a integração?

Um projeto padrão para uma clínica com uma ou duas especialidades demora tipicamente entre 3 e 6 semanas, incluindo período de sombra. Clínicas multidisciplinares podem chegar às 8 semanas por causa da complexidade das regras de agenda e de sala.

Como evitar que duas pessoas marquem a mesma hora?

Combinando reserva provisória durante a conversa com o paciente, webhooks em tempo quase real desde os portais e uma tarefa de reconciliação periódica. Esta arquitetura reduz o risco de conflito para menos de 1% das marcações em cenários bem calibrados.

O que acontece se a API de um portal ficar indisponível?

O chatbot continua a operar na agenda mestra e regista as marcações localmente. A propagação para o portal indisponível é feita em modo diferido assim que a API volta. O paciente recebe confirmação imediata; a receção é avisada se a sincronização demorar mais do que o esperado.

Os dados dos pacientes ficam em conformidade com o RGPD?

Sim, desde que o consentimento seja recolhido de forma explícita antes da marcação, os dados sejam guardados em servidores na União Europeia (ou com garantias equivalentes) e existam políticas claras de retenção. A clínica é responsável pelo tratamento e o fornecedor tecnológico atua como subcontratante.

Posso usar o chatbot em várias línguas para turistas?

Sim. Chatbots modernos suportam sem esforço português, inglês, espanhol e francês. Para clínicas em zonas turísticas como Cascais ou Algarve, esta capacidade multilingue costuma aumentar a taxa de conversão de visitantes internacionais entre 15% e 30%.

Qual é o retorno típico deste tipo de integração?

Em clínicas com volume médio, tipicamente observamos redução de 60% a 80% no tempo administrativo dedicado a marcações telefónicas, aumento entre 20% e 40% nas marcações fora do horário de expediente e diminuição significativa das marcações duplicadas.

Próximos passos

Se a sua clínica já usa Doctoralia, Medicone ou ambos, e está a perder tempo com marcações duplicadas, cancelamentos por engano ou pacientes que desistem por não conseguir marcar rapidamente, uma integração com chatbot pode resolver a maior parte destes atritos em poucas semanas. O primeiro passo é sempre um levantamento do fluxo atual: quantas marcações vêm de cada canal, que software administrativo usa, quantos profissionais partilham salas e que regras específicas existem para cada especialidade.

A partir desse levantamento é possível dimensionar o âmbito, o prazo e o investimento com precisão. Solicite um diagnóstico gratuito para o seu caso concreto: analisamos a sua situação atual, propomos a arquitetura de integração mais adequada e apresentamos um plano com prazos e custos realistas para a sua clínica.