---
title: "Khả năng của app"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/capabilities.list
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# 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.

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

```bash
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ề

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