> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hi-doctor.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Referência de ferramentas
> Todas as ferramentas que o conector Hi-Doctor disponibiliza a um paciente, agrupadas pela permissão de que dependem.
Uma ligação de paciente disponibiliza **50 ferramentas** — tudo o que um
paciente pode fazer em hi-doctor.ai. Cada uma pertence a um grupo de
permissões e, se a permissão não for concedida, a ferramenta não é sequer
oferecida: chamá-la é recusado, e não silenciosamente ignorado.
Iniciar sessão com uma conta de clínico ou de back-office produz um catálogo
diferente e mais reduzido. Os perfis não se acumulam: cada conta tem
exatamente um.
## Perfil
Permissão: **O seu perfil**
| Ferramenta | O que faz |
| ------------------------- | --------------------------------------------------------------------------------------- |
| `hidoctor_profile_get` | Lê o perfil da conta. |
| `hidoctor_profile_update` | Atualiza o nome, a data de nascimento, o país, a língua, o fuso horário e os contactos. |
## Consultas e registos
Permissão: **Consultas e receitas médicas**
| Ferramenta | O que faz |
| --------------------------------------- | --------------------------------------------------------- |
| `hidoctor_consultations_list` | Lista as suas consultas. |
| `hidoctor_consultation_get` | Lê uma consulta. |
| `hidoctor_orders_list` | Lista as suas encomendas. |
| `hidoctor_prescriptions_list` | Lista as suas receitas médicas. |
| `hidoctor_prescription_pdf` | Obtém um link autenticado para o PDF de uma receita. |
| `hidoctor_prescription_request_reissue` | Pede a reemissão de uma receita que expirou ou se perdeu. |
| `hidoctor_adverse_event_report` | Comunica um efeito secundário suspeito à equipa clínica. |
| `hidoctor_adverse_events_list` | Lista os efeitos secundários que comunicou. |
Comunicar um efeito secundário através de um assistente de chat não é
atendimento urgente. Perante uma reação grave, contacte o número de emergência
local.
## Faturação e subscrição
Permissão: **Consultas e receitas médicas**
| Ferramenta | O que faz |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| `hidoctor_subscription_get` | Lê o seu plano atual. |
| `hidoctor_subscription_cancel` | Agenda o cancelamento **para o fim do período já pago**. Devolve a data em que produz efeitos. |
| `hidoctor_subscription_reactivate` | Anula um cancelamento agendado. |
| `hidoctor_subscription_billing_portal` | Obtém um link para o portal de faturação alojado pela Stripe, para alterar cartão, plano ou morada de faturação. |
| `hidoctor_payments_list` | Lista os seus pagamentos. |
| `hidoctor_payment_invoice` | Obtém um link para o PDF de uma fatura. |
A ferramenta `hidoctor_subscription_early_order` — antecipar a próxima
renovação — está listada abaixo, em **Pagamento**, e não aqui. Cria de imediato
a consulta de renovação e consome a única encomenda antecipada do período, pelo
que pertence ao conjunto de ações que podem dar origem a uma cobrança.
O cancelamento **nunca é imediato** — o acesso continua até ao fim do período
que já pagou, e pode reativar antes de essa data passar.
Não existe ferramenta para suspender o plano. Suspender é uma ação reservada ao
pessoal interno no backend, pelo que é deliberadamente não oferecida aqui, em
vez de ser simulada.
## Mensagens
Permissão: **Mensagens com a sua equipa médica**
| Ferramenta | O que faz |
| ---------------------------------- | ------------------------------------------------------------- |
| `hidoctor_messages_unread_summary` | Contagem de mensagens não lidas. |
| `hidoctor_messages_get_thread` | Abre a conversa com a sua equipa médica e lista as mensagens. |
| `hidoctor_message_send` | Envia uma mensagem à sua equipa médica. |
| `hidoctor_messages_mark_read` | Marca a conversa como lida. |
## Questionários
Permissão: **Questionários de saúde**
O ciclo conversacional é `start → answer → review / back → submit`. Consulte
[Criar com IA sobre a Hi-Doctor](/pt/mcp/ai-integration) para o protocolo e os
formatos de resposta.
| Ferramenta | O que faz |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| `hidoctor_questionnaire_categories` | Lista as categorias de questionário. |
| `hidoctor_questionnaire_start` | Inicia ou retoma um questionário; devolve a primeira pergunta por responder. |
| `hidoctor_questionnaire_current` | Devolve a pergunta atual sem alterar nada. |
| `hidoctor_questionnaire_answer` | Regista uma resposta e devolve a pergunta seguinte. |
| `hidoctor_questionnaire_back` | Volta a qualquer pergunta já respondida através de `question_key`, ou recua um passo. Não elimina a resposta. |
| `hidoctor_questionnaire_review` | Lê todas as respostas dadas até ao momento. |
| `hidoctor_questionnaire_submit` | Envia o questionário para revisão por um médico. |
| `hidoctor_questionnaire_schema` | Obtém o esquema em bruto e o progresso guardado. |
| `hidoctor_questionnaire_save_progress` | Guarda respostas em bloco sem submeter. |
## Registo do progresso
Permissão: **Acompanhamento de saúde**. **Apenas no tratamento de perda de
peso** — o diário é construído à volta do peso, das injeções e de um plano de
injeções, pelo que não é oferecido nos tratamentos de crescimento capilar ou de
saúde sexual. Chame primeiro `hidoctor_progress_status`; indica-lhe se o
registo está ativo, se exige um plano de perda de peso ativo, ou se está
indisponível.
| Ferramenta | O que faz |
| ---------------------------------------------------------------- | ----------------------------------------------------------------------- |
| `hidoctor_progress_status` | Se o registo está ativo, exige um plano, ou está indisponível. |
| `hidoctor_progress_day_get` | Tudo o que foi registado num dia, **com o `entry_id` de cada registo**. |
| `hidoctor_progress_weight_list` / `_log` / `_update` / `_delete` | Registos de peso. |
| `hidoctor_progress_injections_list` / `_log` | Registos de injeções. |
| `hidoctor_progress_injection_update` / `_delete` | Editar ou remover uma injeção. |
| `hidoctor_progress_notes_list` / `_add` | Notas diárias. |
| `hidoctor_progress_note_update` / `_delete` | Editar ou remover uma nota. |
| `hidoctor_progress_goal_get` / `_set` | O seu objetivo de peso. |
| `hidoctor_progress_plan_get` / `_set` | O seu plano de injeções. |
Comece por `hidoctor_progress_day_get` quando quiser corrigir alguma coisa.
Devolve o `entry_id` de que precisa para atualizar ou eliminar, para que nunca
tenha de percorrer uma lista à procura dele.
Dois comportamentos que vale a pena conhecer:
* **O peso é substituído por data.** Registar o peso de um dia sobrepõe-se ao
registo desse dia. Omitir a data usa o dia de hoje no fuso horário do *seu*
perfil, e omitir a nota mantém a nota já guardada.
* **As injeções e as notas acumulam-se.** Registar duas vezes cria dois
registos.
## Pagamento
Permissão: **Pagamento**
| Ferramenta | O que faz |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `hidoctor_checkout_create` | Cria uma sessão de checkout da Stripe, ou devolve uma consulta já coberta pelo seu plano. |
| `hidoctor_checkout_status` | Verifica uma sessão de checkout. Uma sessão paga pode ser finalizada e criar a respetiva consulta. |
| `hidoctor_subscription_early_order` | Antecipa a próxima renovação, criando já a consulta de renovação. Uma vez por período pago, e **não pode ser anulada**. |
O pagamento é listado à parte por ser o grupo que pode dar origem a uma
cobrança — é por essa razão que o ecrã de aprovação o destaca separadamente.
Uma encomenda antecipada é irreversível. Cria de imediato a consulta de
renovação e esgota a única encomenda antecipada permitida no período em curso.
Um assistente deve explicar-lhe exatamente o que vai acontecer e obter um sim
explícito antes de a executar.
## Não disponível a ninguém
Aprovar uma consulta, emitir ou alterar uma receita médica e alterar uma dose
estão **totalmente ausentes do conjunto de ferramentas** — não estão apenas
protegidos por uma permissão. São ações de clínico. Consulte
[Segurança clínica](/pt/essentials/safety).