Tài liệu

Tham chiếu

Khả năng của app

Bắt đầu từ đây: app này làm được gì trên Telegram (các khả năng kèm hành động và phiên bản worker cần cho từng khả năng), thông tin sản phẩm (miễn phí, không có AI bên trong), hạn mức, cách contacts.check_exists trả lời, và các tài khoản của bạn kèm phiên bản worker trên máy của chúng. Không gọi Telegram.

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

Bắt đầu từ đây: app này làm được gì trên Telegram (các khả năng kèm hành động và phiên bản worker cần cho từng khả năng), thông tin sản phẩm (miễn phí, không có AI bên trong), hạn mức, cách contacts.check_exists trả lời, và các tài khoản của bạn kèm phiên bản worker trên máy của chúng. Không gọi Telegram.

Thông tin

Tên Giá trị
Mã capabilities.list
Scope cần accounts.read
Mức Chỉ đọc
Có thể cần xác nhận Không
Kiểu chạy Trả kết quả ngay
Cần Idempotency-Key Không
Vai trò thành viên được phép owner, manager, agent, viewer
Trong app Cài đặt → API & MCP → Khả năng

Trường vào

Thao tác không cần trường nào.

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/capabilities.list \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Trường ra (data)

Trường Kiểu Bắt buộc
platform "telegram" Có
driver "tg.user" Có
product đối tượng Có
limits đối tượng Có
contact_exists đối tượng Có
verbs đối tượng[] Có
accounts đối tượng[] Có

Ví dụ trả về

{
  "data": {
    "platform": "telegram",
    "driver": "tg.user",
    "product": {
      "free": true,
      "internal_ai": false,
      "operations": 1
    },
    "limits": {
      "max_text_chars": 4096,
      "album_size": [
        1,
        1
      ],
      "native_scheduling": true
    },
    "contact_exists": {
      "values": [
        "true",
        "false",
        "unknown"
      ],
      "note": "contacts.check_exists asks Telegram through the account's safety gate. A phone number that is hidden by privacy and one that is not on Telegram look the same, so phone checks answer unknown instead of false."
    },
    "verbs": [
      {
        "capability": "text",
        "actions": [
          {
            "action": "text",
            "since": "text"
          }
        ]
      }
    ],
    "accounts": [
      {
        "id": "00000000-0000-4000-8000-000000000000",
        "label": "text",
        "session_state": "active",
        "worker_version": "text"
      }
    ]
  }
}

Dùng qua MCP

Tool capabilities_list có tên sẵn trong profile: Vận hành realtime (realtime), Thiết lập tự chạy (setup), Tìm khách (prospecting), Báo cáo (reports), Quản trị (admin), Đầy đủ (full). Ở profile khác, tìm bằng tools_search rồi chạy bằng tools_run.

Trang này có hữu ích không?

Kiểm lại lần cuối: 24/10/2026 · bản 2.0