assistant.ask
Answer a question directly for an inbound asker (phone and/or email), grounded ONLY on what their trust tier is permitted to see for the current tenant. A contact/staff member gets internal guidelines; a verified guest gets their own booking/keybox; a stranger or a low-trust channel gets only general info and a polite refusal for anything else. Pass channel (whatsapp/hospitable = high trust, email/voice = low) so sensitive data unlocks only on verified channels. Never reveals data outside the asker's tier. Answering costs an LLM call and is billed to the tenant's daily AI spend, so this is not a free lookup — it is not available to read-only keys.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
query | string | yes | |
phone | string | no | |
email | string | no | |
channel | enum | no | One of: whatsapp, email, hospitable, voice |
locale | string | no |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
tier | string | yes | |
answer | string | yes | |
gated | array of object | yes | |
gated.category | string | yes | |
gated.access | string | yes |