# MCP: quick-replies

Source: <https://telegafirst.com/docs/mcp-quick-replies>
Locale: ru
releaseGitSha: c9a428d902de0b479a981e43774f38b9ec077ed7
sourceContentDigest: 92f58bb2ffb939e0a8b09d54f9ae7079d5b9944fd30a25a2aac5f05b3f89566f
Version: 1

# MCP: quick-replies

Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required\_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load\_domain/describe\_tool и существующий meta-dispatch описаны в [MCP-руководстве](https://telegafirst.com/docs/mcp-guide). [Scopes и права](https://telegafirst.com/docs/scopes-and-permissions) применяются при вызове; 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).

```json
{
  "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).

```json
{
  "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.

```json
{
  "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.

```json
{
  "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"
}
```