К содержанию
TelegaFirst

Для AI-агентов: markdown этой страницы — /docs/mcp-quick-replies.mdиндекс документации — /llms.txt

MCP: quick-replies

Обновлено

MCP: quick-replies

Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.

create_quick_reply

Create a quick reply: a button title (≤64 chars) + the ready-to-send text (≤256). Optionally a sort weight and active flag (default active). Returns the created reply with its seqNum. Errors CONFLICT past the per-tenant soft cap (50).

{
  "description": "Create a quick reply: a button `title` (≤64 chars) + the ready-to-send `text` (≤256). Optionally a sort weight and active flag (default active). Returns the created reply with its `seqNum`. Errors CONFLICT past the per-tenant soft cap (50).",
  "domain": "quick-replies",
  "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"
      },
      "is_active": {
        "description": "Value for is active.",
        "type": "boolean"
      },
      "sort": {
        "description": "Value for sort.",
        "maximum": 9007199254740991,
        "minimum": -9007199254740991,
        "type": "integer"
      },
      "text": {
        "description": "Value for text.",
        "maxLength": 256,
        "minLength": 1,
        "type": "string"
      },
      "title": {
        "description": "Value for title.",
        "maxLength": 64,
        "minLength": 1,
        "type": "string"
      }
    },
    "required": [
      "title",
      "text"
    ],
    "type": "object"
  },
  "name": "create_quick_reply",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "quick-replies:write"
  ],
  "risk": "write",
  "scope": "quick-replies:write",
  "title": "Create Quick Reply"
}

delete_quick_reply

Delete a quick reply by seq_num. Idempotent (deleting an absent reply returns deleted:true with the same seqNum).

{
  "description": "Delete a quick reply by `seq_num`. Idempotent (deleting an absent reply returns deleted:true with the same seqNum).",
  "domain": "quick-replies",
  "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"
      },
      "seq_num": {
        "description": "Value for seq num.",
        "maximum": 2147483647,
        "minimum": 1,
        "type": "integer"
      }
    },
    "required": [
      "seq_num"
    ],
    "type": "object"
  },
  "name": "delete_quick_reply",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "quick-replies:write"
  ],
  "risk": "destructive",
  "scope": "quick-replies:write",
  "title": "Delete Quick Reply"
}

list_quick_replies

List the tenant quick replies (canned operator responses shown as a shortcut menu in open lines). Returns each with its seqNum (the id you pass to update/delete as seq_num), title, text, sort, and active flag. 0-cost read.

{
  "description": "List the tenant quick replies (canned operator responses shown as a shortcut menu in open lines). Returns each with its `seqNum` (the id you pass to update/delete as `seq_num`), title, text, sort, and active flag. 0-cost read.",
  "domain": "quick-replies",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {},
    "type": "object"
  },
  "name": "list_quick_replies",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "quick-replies:read"
  ],
  "risk": "read",
  "scope": "quick-replies:read",
  "title": "List Quick Replies"
}

update_quick_reply

Update a quick reply by seq_num (partial patch — send only changed fields). Returns the updated reply with the same seqNum. Errors NOT_FOUND if the number does not exist for your tenant.

{
  "description": "Update a quick reply by `seq_num` (partial patch — send only changed fields). Returns the updated reply with the same `seqNum`. Errors NOT_FOUND if the number does not exist for your tenant.",
  "domain": "quick-replies",
  "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"
      },
      "is_active": {
        "description": "Value for is active.",
        "type": "boolean"
      },
      "seq_num": {
        "description": "Value for seq num.",
        "maximum": 2147483647,
        "minimum": 1,
        "type": "integer"
      },
      "sort": {
        "description": "Value for sort.",
        "maximum": 9007199254740991,
        "minimum": -9007199254740991,
        "type": "integer"
      },
      "text": {
        "description": "Value for text.",
        "maxLength": 256,
        "minLength": 1,
        "type": "string"
      },
      "title": {
        "description": "Value for title.",
        "maxLength": 64,
        "minLength": 1,
        "type": "string"
      }
    },
    "required": [
      "seq_num"
    ],
    "type": "object"
  },
  "name": "update_quick_reply",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "quick-replies:write"
  ],
  "risk": "write",
  "scope": "quick-replies:write",
  "title": "Update Quick Reply"
}