Для AI-агентов: markdown этой страницы — /docs/mcp-dialogs.mdиндекс документации — /llms.txt
MCP: dialogs
Обновлено
MCP: dialogs
Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.
get_conversation
Read a dialog by userSeqNum. Messages include messageSeqNum, author, source, text and createdAt.
{
"description": "Read a dialog by userSeqNum. Messages include messageSeqNum, author, source, text and createdAt.",
"domain": "dialogs",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"userSeqNum": {
"description": "Value for user Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"userSeqNum"
],
"type": "object"
},
"name": "get_conversation",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"dialogs:read"
],
"risk": "read",
"scope": "dialogs:read",
"title": "Get Conversation"
}get_message_stats
Read message attribution totals and bySource counts for your tenant, aggregated across operators.
{
"description": "Read message attribution totals and bySource counts for your tenant, aggregated across operators.",
"domain": "dialogs",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_message_stats",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"dialogs:read"
],
"risk": "read",
"scope": "dialogs:read",
"title": "Get Message Stats"
}list_unanswered
List waiting dialogs with userSeqNum, inquirySeqNum and the last user message. Includes intercepted chats.
{
"description": "List waiting dialogs with userSeqNum, inquirySeqNum and the last user message. Includes intercepted chats.",
"domain": "dialogs",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_unanswered",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"dialogs": {
"items": {
"additionalProperties": false,
"properties": {
"createdAt": {
"type": "string"
},
"inquirySeqNum": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"lastMessageAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lastMessageText": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"userSeqNum": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"userSeqNum",
"inquirySeqNum",
"lastMessageText",
"lastMessageAt",
"createdAt"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"dialogs"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"dialogs:read"
],
"risk": "read",
"scope": "dialogs:read",
"title": "List Unanswered"
}manage_message
Edit text, caption, media or buttons, or delete a sent message by userSeqNum and messageSeqNum. Updates private and Open Lines copies.
{
"description": "Edit text, caption, media or buttons, or delete a sent message by userSeqNum and messageSeqNum. Updates private and Open Lines copies.",
"domain": "dialogs",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"additionalProperties": false,
"description": "Value for input option.",
"properties": {
"action": {
"const": "text",
"description": "Value for action.",
"type": "string"
},
"entities": {
"description": "Value for entities.",
"items": {
"additionalProperties": false,
"description": "Value for entities item.",
"properties": {
"custom_emoji_id": {
"description": "Value for custom emoji id.",
"type": "string"
},
"language": {
"description": "Value for language.",
"type": "string"
},
"length": {
"description": "Value for length.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"offset": {
"description": "Value for offset.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"type": {
"description": "Value for type.",
"enum": [
"mention",
"hashtag",
"cashtag",
"bot_command",
"url",
"email",
"phone_number",
"bold",
"italic",
"underline",
"strikethrough",
"spoiler",
"blockquote",
"expandable_blockquote",
"code",
"pre",
"text_link",
"text_mention",
"custom_emoji"
],
"type": "string"
},
"url": {
"description": "Value for url.",
"type": "string"
},
"user": {
"additionalProperties": false,
"description": "Value for user.",
"properties": {
"firstName": {
"description": "Value for first Name.",
"type": "string"
},
"id": {
"description": "Value for id.",
"pattern": "^[1-9]\\d*$",
"type": "string"
},
"lastName": {
"description": "Value for last Name.",
"type": "string"
},
"username": {
"description": "Value for username.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
},
"required": [
"type",
"offset",
"length"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"messageSeqNum": {
"description": "Value for message Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"text": {
"description": "Value for text.",
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"userSeqNum": {
"description": "Value for user Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"userSeqNum",
"messageSeqNum",
"action",
"text"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for input option.",
"properties": {
"action": {
"const": "caption",
"description": "Value for action.",
"type": "string"
},
"caption": {
"description": "Value for caption.",
"maxLength": 1024,
"type": "string"
},
"entities": {
"description": "Value for entities.",
"items": {
"additionalProperties": false,
"description": "Value for entities item.",
"properties": {
"custom_emoji_id": {
"description": "Value for custom emoji id.",
"type": "string"
},
"language": {
"description": "Value for language.",
"type": "string"
},
"length": {
"description": "Value for length.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"offset": {
"description": "Value for offset.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"type": {
"description": "Value for type.",
"enum": [
"mention",
"hashtag",
"cashtag",
"bot_command",
"url",
"email",
"phone_number",
"bold",
"italic",
"underline",
"strikethrough",
"spoiler",
"blockquote",
"expandable_blockquote",
"code",
"pre",
"text_link",
"text_mention",
"custom_emoji"
],
"type": "string"
},
"url": {
"description": "Value for url.",
"type": "string"
},
"user": {
"additionalProperties": false,
"description": "Value for user.",
"properties": {
"firstName": {
"description": "Value for first Name.",
"type": "string"
},
"id": {
"description": "Value for id.",
"pattern": "^[1-9]\\d*$",
"type": "string"
},
"lastName": {
"description": "Value for last Name.",
"type": "string"
},
"username": {
"description": "Value for username.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
},
"required": [
"type",
"offset",
"length"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"messageSeqNum": {
"description": "Value for message Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"userSeqNum": {
"description": "Value for user Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"userSeqNum",
"messageSeqNum",
"action",
"caption"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for input option.",
"properties": {
"action": {
"const": "media",
"description": "Value for action.",
"type": "string"
},
"caption": {
"description": "Value for caption.",
"maxLength": 1024,
"type": "string"
},
"entities": {
"description": "Value for entities.",
"items": {
"additionalProperties": false,
"description": "Value for entities item.",
"properties": {
"custom_emoji_id": {
"description": "Value for custom emoji id.",
"type": "string"
},
"language": {
"description": "Value for language.",
"type": "string"
},
"length": {
"description": "Value for length.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"offset": {
"description": "Value for offset.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"type": {
"description": "Value for type.",
"enum": [
"mention",
"hashtag",
"cashtag",
"bot_command",
"url",
"email",
"phone_number",
"bold",
"italic",
"underline",
"strikethrough",
"spoiler",
"blockquote",
"expandable_blockquote",
"code",
"pre",
"text_link",
"text_mention",
"custom_emoji"
],
"type": "string"
},
"url": {
"description": "Value for url.",
"type": "string"
},
"user": {
"additionalProperties": false,
"description": "Value for user.",
"properties": {
"firstName": {
"description": "Value for first Name.",
"type": "string"
},
"id": {
"description": "Value for id.",
"pattern": "^[1-9]\\d*$",
"type": "string"
},
"lastName": {
"description": "Value for last Name.",
"type": "string"
},
"username": {
"description": "Value for username.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
},
"required": [
"type",
"offset",
"length"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"media": {
"anyOf": [
{
"additionalProperties": false,
"description": "Value for media option.",
"properties": {
"item": {
"additionalProperties": false,
"description": "Value for item.",
"properties": {
"caption": {
"description": "Value for caption.",
"maxLength": 1024,
"type": "string"
},
"captionEntities": {
"description": "Value for caption Entities.",
"items": {
"additionalProperties": false,
"description": "Value for caption Entities item.",
"properties": {
"custom_emoji_id": {
"description": "Value for custom emoji id.",
"type": "string"
},
"language": {
"description": "Value for language.",
"type": "string"
},
"length": {
"description": "Value for length.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"offset": {
"description": "Value for offset.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"type": {
"description": "Value for type.",
"enum": [
"mention",
"hashtag",
"cashtag",
"bot_command",
"url",
"email",
"phone_number",
"bold",
"italic",
"underline",
"strikethrough",
"spoiler",
"blockquote",
"expandable_blockquote",
"code",
"pre",
"text_link",
"text_mention",
"custom_emoji"
],
"type": "string"
},
"url": {
"description": "Value for url.",
"type": "string"
},
"user": {
"additionalProperties": false,
"description": "Value for user.",
"properties": {
"firstName": {
"description": "Value for first Name.",
"type": "string"
},
"id": {
"description": "Value for id.",
"pattern": "^-?\\d+$",
"type": "string"
},
"lastName": {
"description": "Value for last Name.",
"type": "string"
},
"username": {
"description": "Value for username.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
},
"required": [
"type",
"offset",
"length"
],
"type": "object"
},
"type": "array"
},
"captionHtml": {
"description": "Value for caption Html.",
"maxLength": 16384,
"minLength": 1,
"type": "string"
},
"expectedSizeBytes": {
"description": "Value for expected Size Bytes.",
"exclusiveMinimum": 0,
"maximum": 4294967296,
"type": "integer"
},
"generatedFileName": {
"description": "Value for generated File Name.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"kind": {
"description": "Value for kind.",
"enum": [
"voice",
"audio",
"video_note"
],
"type": "string"
},
"mediaRef": {
"description": "Value for media Ref.",
"maxLength": 512,
"pattern": "^media-ingress\\/v1\\/[a-f0-9]{64}\\/[A-Za-z0-9_-]{16,128}\\/objects\\/[a-z][a-z0-9-]{0,63}\\/[a-f0-9]{64}\\/[a-f0-9]{24}\\.blob$",
"type": "string"
},
"mimeType": {
"description": "Value for mime Type.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"sha256": {
"description": "Value for sha256.",
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"type": {
"description": "Value for type.",
"enum": [
"photo",
"video",
"document"
],
"type": "string"
}
},
"required": [
"type",
"mediaRef",
"expectedSizeBytes",
"sha256",
"mimeType"
],
"type": "object"
},
"uploadId": {
"description": "Value for upload Id.",
"maxLength": 512,
"minLength": 1,
"type": "string"
}
},
"required": [
"uploadId",
"item"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for media option.",
"properties": {
"file_id": {
"description": "Value for file id.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"type": {
"description": "Value for type.",
"enum": [
"photo",
"video",
"document"
],
"type": "string"
}
},
"required": [
"type",
"file_id"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for media option.",
"properties": {
"download_url": {
"description": "Value for download url.",
"format": "uri",
"maxLength": 8192,
"type": "string"
},
"file_name": {
"description": "Value for file name.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"mime_type": {
"description": "Value for mime type.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"type": {
"description": "Value for type.",
"enum": [
"photo",
"video",
"document"
],
"type": "string"
}
},
"required": [
"download_url",
"type"
],
"type": "object"
}
],
"description": "Value for media."
},
"messageSeqNum": {
"description": "Value for message Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"userSeqNum": {
"description": "Value for user Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"userSeqNum",
"messageSeqNum",
"action",
"media"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for input option.",
"properties": {
"action": {
"const": "markup",
"description": "Value for action.",
"type": "string"
},
"buttons": {
"description": "Value for buttons.",
"items": {
"description": "Value for buttons item.",
"items": {
"anyOf": [
{
"additionalProperties": false,
"description": "Value for buttons item item option.",
"properties": {
"text": {
"description": "Value for text.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"url": {
"description": "Value for url.",
"format": "uri",
"type": "string"
}
},
"required": [
"text",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for buttons item item option.",
"properties": {
"callback_data": {
"description": "Value for callback data.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"text": {
"description": "Value for text.",
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"text",
"callback_data"
],
"type": "object"
}
],
"description": "Value for buttons item item."
},
"maxItems": 8,
"minItems": 1,
"type": "array"
},
"maxItems": 10,
"type": "array"
},
"messageSeqNum": {
"description": "Value for message Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"userSeqNum": {
"description": "Value for user Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"userSeqNum",
"messageSeqNum",
"action",
"buttons"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for input option.",
"properties": {
"action": {
"const": "delete",
"description": "Value for action.",
"type": "string"
},
"messageSeqNum": {
"description": "Value for message Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"userSeqNum": {
"description": "Value for user Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"userSeqNum",
"messageSeqNum",
"action"
],
"type": "object"
}
]
},
"name": "manage_message",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"dialogs:write"
],
"risk": "destructive",
"scope": "dialogs:write",
"title": "Manage Message"
}release_chat
Release a dialog by userSeqNum and restore configured AI routing.
{
"description": "Release a dialog by userSeqNum and restore configured AI routing.",
"domain": "dialogs",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"userSeqNum": {
"description": "Value for user Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"userSeqNum"
],
"type": "object"
},
"name": "release_chat",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"dialogs:write"
],
"risk": "write",
"scope": "dialogs:write",
"title": "Release Chat"
}send_card
Send cards in a batch: items carry a private target with userSeqNum, text or media, caption, entities and buttons. Media accepts file_id, an uploaded media descriptor, or download_url. Replies use replyToMessageSeqNum. Mirrored to Open Lines; sending never takes over the chat. Plan batch cap applies; results report each item.
{
"description": "Send cards in a batch: items carry a private target with userSeqNum, text or media, caption, entities and buttons. Media accepts file_id, an uploaded media descriptor, or download_url. Replies use replyToMessageSeqNum. Mirrored to Open Lines; sending never takes over the chat. Plan batch cap applies; results report each item.",
"domain": "dialogs",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"items": {
"description": "Value for items.",
"items": {
"additionalProperties": false,
"description": "Value for items item.",
"properties": {
"buttons": {
"description": "Value for buttons.",
"items": {
"description": "Value for buttons item.",
"items": {
"anyOf": [
{
"additionalProperties": false,
"description": "Value for buttons item item option.",
"properties": {
"text": {
"description": "Value for text.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"url": {
"description": "Value for url.",
"format": "uri",
"type": "string"
}
},
"required": [
"text",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for buttons item item option.",
"properties": {
"callback_data": {
"description": "Value for callback data.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"text": {
"description": "Value for text.",
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"text",
"callback_data"
],
"type": "object"
}
],
"description": "Value for buttons item item."
},
"maxItems": 8,
"minItems": 1,
"type": "array"
},
"maxItems": 10,
"type": "array"
},
"caption": {
"description": "Value for caption.",
"maxLength": 1024,
"type": "string"
},
"dedupeKey": {
"description": "Value for dedupe Key.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"entities": {
"description": "Value for entities.",
"items": {
"additionalProperties": false,
"description": "Value for entities item.",
"properties": {
"custom_emoji_id": {
"description": "Value for custom emoji id.",
"type": "string"
},
"language": {
"description": "Value for language.",
"type": "string"
},
"length": {
"description": "Value for length.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"offset": {
"description": "Value for offset.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"type": {
"description": "Value for type.",
"enum": [
"mention",
"hashtag",
"cashtag",
"bot_command",
"url",
"email",
"phone_number",
"bold",
"italic",
"underline",
"strikethrough",
"spoiler",
"blockquote",
"expandable_blockquote",
"code",
"pre",
"text_link",
"text_mention",
"custom_emoji"
],
"type": "string"
},
"url": {
"description": "Value for url.",
"type": "string"
},
"user": {
"additionalProperties": false,
"description": "Value for user.",
"properties": {
"firstName": {
"description": "Value for first Name.",
"type": "string"
},
"id": {
"description": "Value for id.",
"pattern": "^[1-9]\\d*$",
"type": "string"
},
"lastName": {
"description": "Value for last Name.",
"type": "string"
},
"username": {
"description": "Value for username.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
},
"required": [
"type",
"offset",
"length"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"media": {
"description": "Value for media.",
"items": {
"anyOf": [
{
"additionalProperties": false,
"description": "Value for media item option.",
"properties": {
"item": {
"additionalProperties": false,
"description": "Value for item.",
"properties": {
"caption": {
"description": "Value for caption.",
"maxLength": 1024,
"type": "string"
},
"captionEntities": {
"description": "Value for caption Entities.",
"items": {
"additionalProperties": false,
"description": "Value for caption Entities item.",
"properties": {
"custom_emoji_id": {
"description": "Value for custom emoji id.",
"type": "string"
},
"language": {
"description": "Value for language.",
"type": "string"
},
"length": {
"description": "Value for length.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"offset": {
"description": "Value for offset.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"type": {
"description": "Value for type.",
"enum": [
"mention",
"hashtag",
"cashtag",
"bot_command",
"url",
"email",
"phone_number",
"bold",
"italic",
"underline",
"strikethrough",
"spoiler",
"blockquote",
"expandable_blockquote",
"code",
"pre",
"text_link",
"text_mention",
"custom_emoji"
],
"type": "string"
},
"url": {
"description": "Value for url.",
"type": "string"
},
"user": {
"additionalProperties": false,
"description": "Value for user.",
"properties": {
"firstName": {
"description": "Value for first Name.",
"type": "string"
},
"id": {
"description": "Value for id.",
"pattern": "^-?\\d+$",
"type": "string"
},
"lastName": {
"description": "Value for last Name.",
"type": "string"
},
"username": {
"description": "Value for username.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
},
"required": [
"type",
"offset",
"length"
],
"type": "object"
},
"type": "array"
},
"captionHtml": {
"description": "Value for caption Html.",
"maxLength": 16384,
"minLength": 1,
"type": "string"
},
"expectedSizeBytes": {
"description": "Value for expected Size Bytes.",
"exclusiveMinimum": 0,
"maximum": 4294967296,
"type": "integer"
},
"generatedFileName": {
"description": "Value for generated File Name.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"kind": {
"description": "Value for kind.",
"enum": [
"voice",
"audio",
"video_note"
],
"type": "string"
},
"mediaRef": {
"description": "Value for media Ref.",
"maxLength": 512,
"pattern": "^media-ingress\\/v1\\/[a-f0-9]{64}\\/[A-Za-z0-9_-]{16,128}\\/objects\\/[a-z][a-z0-9-]{0,63}\\/[a-f0-9]{64}\\/[a-f0-9]{24}\\.blob$",
"type": "string"
},
"mimeType": {
"description": "Value for mime Type.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"sha256": {
"description": "Value for sha256.",
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"type": {
"description": "Value for type.",
"enum": [
"photo",
"video",
"document"
],
"type": "string"
}
},
"required": [
"type",
"mediaRef",
"expectedSizeBytes",
"sha256",
"mimeType"
],
"type": "object"
},
"uploadId": {
"description": "Value for upload Id.",
"maxLength": 512,
"minLength": 1,
"type": "string"
}
},
"required": [
"uploadId",
"item"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for media item option.",
"properties": {
"file_id": {
"description": "Value for file id.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"type": {
"description": "Value for type.",
"enum": [
"photo",
"video",
"document"
],
"type": "string"
}
},
"required": [
"type",
"file_id"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for media item option.",
"properties": {
"download_url": {
"description": "Value for download url.",
"format": "uri",
"maxLength": 8192,
"type": "string"
},
"file_name": {
"description": "Value for file name.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"mime_type": {
"description": "Value for mime type.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"type": {
"description": "Value for type.",
"enum": [
"photo",
"video",
"document"
],
"type": "string"
}
},
"required": [
"download_url",
"type"
],
"type": "object"
}
],
"description": "Value for media item."
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"replyToMessageSeqNum": {
"description": "Value for reply To Message Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"target": {
"additionalProperties": false,
"description": "Value for target.",
"properties": {
"kind": {
"description": "Value for kind.",
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"userSeqNum": {
"description": "Value for user Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"kind"
],
"type": "object"
},
"text": {
"description": "Value for text.",
"maxLength": 4096,
"minLength": 1,
"type": "string"
}
},
"required": [
"target"
],
"type": "object"
},
"minItems": 1,
"type": "array"
}
},
"required": [
"items"
],
"type": "object"
},
"name": "send_card",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"dialogs:write"
],
"risk": "write",
"scope": "dialogs:write",
"title": "Send Card"
}send_entity_card
Send an entity card to userSeqNum without recording a user click. Explicit onActive controls chain reentry. Orders and carts use payment tools.
{
"description": "Send an entity card to userSeqNum without recording a user click. Explicit onActive controls chain reentry. Orders and carts use payment tools.",
"domain": "dialogs",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"onActive": {
"description": "Value for on Active.",
"enum": [
"noop",
"deliver",
"restart"
],
"type": "string"
},
"target": {
"description": "Value for target.",
"oneOf": [
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"kind": {
"const": "delivery_message",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"kind": {
"const": "url",
"description": "Value for kind.",
"type": "string"
},
"url": {
"description": "Value for url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"kind": {
"const": "web_app",
"description": "Value for kind.",
"type": "string"
},
"web_app_url": {
"description": "Value for web app url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"kind": {
"const": "section_root",
"description": "Value for kind.",
"type": "string"
},
"section": {
"description": "Value for section.",
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"entity_seq": {
"description": "Value for entity seq.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"entity_type": {
"description": "Value for entity type.",
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"const": "deeplink",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
}
]
},
"userSeqNum": {
"description": "Value for user Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"userSeqNum",
"target",
"onActive"
],
"type": "object"
},
"name": "send_entity_card",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"dialogs:write"
],
"risk": "write",
"scope": "dialogs:write",
"title": "Send Entity Card"
}take_chat
Take over a dialog by userSeqNum and pause AI responses. Sending alone never takes over.
{
"description": "Take over a dialog by userSeqNum and pause AI responses. Sending alone never takes over.",
"domain": "dialogs",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"userSeqNum": {
"description": "Value for user Seq Num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"userSeqNum"
],
"type": "object"
},
"name": "take_chat",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"dialogs:write"
],
"risk": "write",
"scope": "dialogs:write",
"title": "Take Chat"
}