book
Creates a real appointment with the vertebrologist on the user's behalf. Takes date (YYYY-MM-DD) and time (HH:MM), both required; the slot must be one returned by get_availability. Returns ok=true with the booked date and time, or ok=false with a reason: taken (the slot is no longer free; the call fails rather than quietly moving the user to a different time), day_limit (this patient already has an appointment that day — the limit is one per calendar day), locked (the doctor closed that day or slot), past, invalid, error. Authorization required: a one-time Telegram OAuth consent with scope booking:write, which also covers later calls.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"date": "<date>",
"time": "<time>"
},
"name": "book"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Appointment date, YYYY-MM-DD (Europe/Kyiv). Must be a day returned by get_availability. | |
| time | Yes | Slot start, HH:MM in 24-hour form, exactly as get_availability returned it. Slots are 20 minutes. |