> ## 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.
# Riferimento degli strumenti
> Tutti gli strumenti che il connettore Hi-Doctor espone a un paziente, raggruppati per l'autorizzazione che richiedono.
Il collegamento di un paziente espone **50 strumenti**: tutto ciò che un
paziente può fare su hi-doctor.ai. Ciascuno appartiene a un gruppo di
autorizzazioni e, se un'autorizzazione non è concessa, lo strumento non viene
nemmeno offerto: chiamarlo produce un rifiuto, non un'esecuzione ignorata in
silenzio.
L'accesso con un account clinico o di back-office produce un catalogo diverso e
più ristretto. I ruoli non si sommano: a un account ne corrisponde esattamente
uno.
## Profilo
Autorizzazione: **Il Suo profilo**
| Strumento | Che cosa fa |
| ------------------------- | ---------------------------------------------------------------------- |
| `hidoctor_profile_get` | Legge il profilo dell'account. |
| `hidoctor_profile_update` | Aggiorna nome, data di nascita, Paese, lingua, fuso orario e recapiti. |
## Consulti e documentazione
Autorizzazione: **Consulti e ricette**
| Strumento | Che cosa fa |
| --------------------------------------- | ----------------------------------------------------------------------- |
| `hidoctor_consultations_list` | Elenca i Suoi consulti. |
| `hidoctor_consultation_get` | Legge un singolo consulto. |
| `hidoctor_orders_list` | Elenca i Suoi ordini. |
| `hidoctor_prescriptions_list` | Elenca le Sue ricette. |
| `hidoctor_prescription_pdf` | Ottiene un link autenticato al PDF di una ricetta. |
| `hidoctor_prescription_request_reissue` | Richiede una riemissione perché una ricetta è scaduta o è andata persa. |
| `hidoctor_adverse_event_report` | Segnala un sospetto effetto collaterale al team clinico. |
| `hidoctor_adverse_events_list` | Elenca gli effetti collaterali che ha segnalato. |
Segnalare un effetto collaterale tramite un assistente in chat non è assistenza
urgente. In caso di reazione grave, contatti il numero di emergenza locale.
## Fatturazione e abbonamento
Autorizzazione: **Consulti e ricette**
| Strumento | Che cosa fa |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `hidoctor_subscription_get` | Legge il Suo piano attuale. |
| `hidoctor_subscription_cancel` | Programma la disdetta **per la fine del periodo già pagato**. Restituisce la data di fine effettiva. |
| `hidoctor_subscription_reactivate` | Annulla una disdetta programmata. |
| `hidoctor_subscription_billing_portal` | Ottiene un link al portale di fatturazione ospitato da Stripe per cambiare carta, piano o indirizzo di fatturazione. |
| `hidoctor_payments_list` | Elenca i Suoi pagamenti. |
| `hidoctor_payment_invoice` | Ottiene un link al PDF di una fattura. |
`hidoctor_subscription_early_order` — anticipare il rinnovo successivo — è
elencato più sotto, sotto **Pagamento**, e non qui. Crea subito il consulto di
rinnovo e consuma l'unico ordine anticipato del periodo, quindi appartiene alle
azioni che possono portare a un addebito.
La disdetta **non è mai immediata**: l'accesso prosegue fino alla fine del
periodo che ha già pagato e può riattivare prima che quella data sia trascorsa.
Non esiste uno strumento di sospensione. La sospensione è un'azione riservata al
personale sul backend, quindi qui non viene deliberatamente offerta anziché
essere simulata.
## Messaggi
Autorizzazione: **Messaggi con il Suo team medico**
| Strumento | Che cosa fa |
| ---------------------------------- | ------------------------------------------------------------------ |
| `hidoctor_messages_unread_summary` | Conteggio dei messaggi non letti. |
| `hidoctor_messages_get_thread` | Apre la conversazione con il Suo team medico ed elenca i messaggi. |
| `hidoctor_message_send` | Invia un messaggio al Suo team medico. |
| `hidoctor_messages_mark_read` | Segna la conversazione come letta. |
## Questionari
Autorizzazione: **Questionari sanitari**
Il ciclo conversazionale è `start → answer → review / back → submit`. Per il
protocollo e i formati delle risposte veda
[Sviluppare su Hi-Doctor con l'IA](/it/mcp/ai-integration).
| Strumento | Che cosa fa |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `hidoctor_questionnaire_categories` | Elenca le categorie di questionario. |
| `hidoctor_questionnaire_start` | Avvia o riprende un questionario; restituisce la prima domanda senza risposta. |
| `hidoctor_questionnaire_current` | Restituisce la domanda corrente senza modificare nulla. |
| `hidoctor_questionnaire_answer` | Registra una risposta e restituisce la domanda successiva. |
| `hidoctor_questionnaire_back` | Torna a una qualsiasi domanda già risposta tramite `question_key`, oppure indietreggia di un passo. Non elimina la risposta. |
| `hidoctor_questionnaire_review` | Rilegge tutte le risposte date finora. |
| `hidoctor_questionnaire_submit` | Invia il questionario alla revisione di un medico. |
| `hidoctor_questionnaire_schema` | Recupera lo schema grezzo e i progressi salvati. |
| `hidoctor_questionnaire_save_progress` | Salva le risposte in blocco senza inviarle. |
## Monitoraggio dei progressi
Autorizzazione: **Monitoraggio della salute**. **Solo per il trattamento della
perdita di peso**: il diario è costruito attorno a peso, iniezioni e piano di
iniezioni, quindi non è offerto sui trattamenti di crescita dei capelli o di
salute sessuale. Chiami prima `hidoctor_progress_status`: indica se il
monitoraggio è attivo, se richiede un piano attivo per la perdita di peso o se
non è disponibile.
| Strumento | Che cosa fa |
| ---------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `hidoctor_progress_status` | Indica se il monitoraggio è attivo, se richiede un piano o se non è disponibile. |
| `hidoctor_progress_day_get` | Tutto ciò che è stato registrato in un giorno, **con l'`entry_id` di ogni voce**. |
| `hidoctor_progress_weight_list` / `_log` / `_update` / `_delete` | Voci di peso. |
| `hidoctor_progress_injections_list` / `_log` | Voci di iniezione. |
| `hidoctor_progress_injection_update` / `_delete` | Modifica o elimina un'iniezione. |
| `hidoctor_progress_notes_list` / `_add` | Note quotidiane. |
| `hidoctor_progress_note_update` / `_delete` | Modifica o elimina una nota. |
| `hidoctor_progress_goal_get` / `_set` | Il Suo obiettivo di peso. |
| `hidoctor_progress_plan_get` / `_set` | Il Suo piano di iniezioni. |
Quando deve correggere qualcosa, parta da `hidoctor_progress_day_get`.
Restituisce l'`entry_id` che serve per aggiornare o eliminare, così non deve mai
scorrere un elenco per trovarlo.
Due comportamenti da conoscere:
* **Il peso sostituisce per data.** Registrare il peso di un giorno sovrascrive
la voce di quel giorno. Se omette la data viene usato oggi nel fuso orario del
*Suo* profilo, e se omette la nota resta quella già salvata.
* **Iniezioni e note si aggiungono.** Registrandole due volte si creano due
voci.
## Pagamento
Autorizzazione: **Pagamento**
| Strumento | Che cosa fa |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `hidoctor_checkout_create` | Crea una sessione di checkout Stripe, oppure restituisce un consulto già coperto dal Suo piano. |
| `hidoctor_checkout_status` | Verifica una sessione di checkout. Una sessione pagata può concludersi e creare il relativo consulto. |
| `hidoctor_subscription_early_order` | Anticipa il rinnovo successivo, creando subito il consulto di rinnovo. Una volta per periodo pagato e **non annullabile**. |
Il pagamento è elencato a parte perché è il gruppo che può portare a un
addebito: per questo la schermata di approvazione lo evidenzia da solo.
Un ordine anticipato è irreversibile. Crea subito il consulto di rinnovo e
consuma l'unico ordine anticipato consentito nel periodo in corso. Un assistente
dovrebbe dirLe esattamente che cosa accadrà e ottenere un sì esplicito prima di
chiamarlo.
## Non esposto a nessuno
Approvare un consulto, emettere o modificare una ricetta e cambiare un dosaggio
sono azioni **del tutto assenti dagli strumenti disponibili**, non protette da
un'autorizzazione. Sono azioni del medico. Veda
[Sicurezza del paziente](/it/essentials/safety).