max_deeplink
Build and validate MAX deep links. 'share' gives a link, an HTML button and a JS helper that open MAX's chat picker with prefilled text — works on any website or AI agent output without owning a bot. Payload limits are checked, because MAX silently drops payloads that are too long or have bad characters.
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": {
"kind": "<kind>"
},
"name": "max_deeplink"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | start — open bot with payload; startapp — open mini-app; share — 'send to MAX' link for any site, no bot needed; mention — user mention markup | |
| lang | No | Answer language: 'en' English, 'ru' Russian. Pick the user's language; default ru (or XONTA_MAX_LANG) | |
| text | No | share: text to prefill; mention: display name | |
| payload | No | start: ≤128 chars; startapp: ≤512, A-Za-z0-9_- only | |
| user_id | No | mention: MAX user id | |
| bot_name | No | Bot public name as in max.ru/<name> (start, startapp) | |
| button_label | No | share: label for the generated HTML button; default depends on lang |