Send an inquiry to the operator
send_inquirySend one inquiry from a traveler to the operator of a passport, by email through Ospitario (no booking, no payment, no commission). Two steps, and only with the traveler's consent: first call without code; Ospitario mails a six-digit code and a confirmation link to guest_email. Ask the traveler for the code, then call again with challengeId and code; if the traveler confirmed with the link instead, the inquiry is already sent and that call answers refused with reason used. The operator replies to the traveler's address directly. For an unclaimed passport (L0) this is the only way to write. Limits: 3 per traveler email and day, 10 per operator and day, identical messages once. When sent, the answer carries a reference that the operator's mail names too; give it to the traveler.
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": {
"slug": "<slug>",
"guests": "<guests>",
"message": "<message>",
"guest_email": "<guest_email>"
},
"name": "send_inquiry"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Checkout date YYYY-MM-DD; requires from | |
| code | No | The six-digit code the traveler received by email, for step 2 | |
| from | No | Check-in date YYYY-MM-DD; requires to | |
| lang | No | Language of labels in the result; defaults to en | |
| slug | Yes | Passport slug from a search or lookup result | |
| guests | Yes | Number of guests | |
| message | Yes | The traveler's message to the operator, in the traveler's words | |
| challengeId | No | From step 1; send it with code in step 2 | |
| guest_email | Yes | The traveler's email address; the operator replies there |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Why nothing was sent: limits (3 per traveler and day, 10 per operator and day), the operator opted out, a repeated identical message, a wrong or expired code, used: already sent through the mail's confirmation link, delivery_failed: the mail server refused the mail (step 1: no code went out; step 2: the inquiry is recorded under reference but did not go out, the traveler may send it again), rate_limited: too many calls, try again in a minute | |
| status | Yes | code_sent: the code was handed to the mail server for guest_email; ask the traveler for it, then call again with challengeId and code (the traveler may confirm with the mail's link instead). sent: the inquiry was handed to the mail server for the operator, Reply-To the traveler; it is not a sign the operator read or answered it, and answers go to guest_email, not to Ospitario. Calling step 2 again with the same challengeId and code returns the same reference. refused: see reason | |
| reference | No | With sent, or refused for delivery_failed: the inquiry's reference, also named in the operator's mail; quote it to the traveler and in any follow-up. Opaque, carries no personal data. | |
| challengeId | No |