book
Books at a network venue on the user's behalf. Takes provider_id and item, which the venue interprets: doctor — item={date,time}; hostel — item={check_in,check_out,guests,promo_code?} (underscores: check_in/check_out, not 'checkin'/'checkout'; guests is an integer; a dorm bed is the default, there is no room_type). No name or contact is required: identity comes from the one-time Telegram consent. At a hostel the call returns a HOLD together with a payment_url, and the booking is finalized by payment rather than by this call; a doctor visit is free. If the user is not yet authorized at that venue the call returns linked=false with consent_url (and consent_url_native when available) instead of a booking, and the same call succeeds once the user has approved in Telegram. Authorization: one Telegram consent per venue, 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": {
"provider_id": "<provider_id>",
"item": "<item>"
},
"name": "book"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | Yes | Booking details, interpreted by the venue. Doctor: {date:'YYYY-MM-DD', time:'HH:MM'}. Hostel: {check_in:'YYYY-MM-DD', check_out:'YYYY-MM-DD', guests:<int>, promo_code?}. No name or contact — identity comes from the one-time Telegram consent. | |
| provider_id | Yes | Venue id as returned by find_providers (e.g. rudko-vertebrolog). |