Tham chiếu

Tạo bot

Tạo một bot trên mỗi tài khoản được liệt kê qua chính chat @BotFather của tài khoản đó (/newbot). `name` là tên hiển thị, `username` phải kết thúc bằng 'bot'; khi có nhiều tài khoản, `{n}` (hoặc _n tự động) giữ chúng khác nhau. Tính vào 'Tạo bot'; Telegram cho mỗi tài khoản 20 bot. Theo dõi các việc để nhận kết quả.

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

Tạo một bot trên mỗi tài khoản được liệt kê qua chính chat @BotFather của tài khoản đó (/newbot). name là tên hiển thị, username phải kết thúc bằng 'bot'; khi có nhiều tài khoản, {n} (hoặc _n tự động) giữ chúng khác nhau. Tính vào 'Tạo bot'; Telegram cho mỗi tài khoản 20 bot. Theo dõi các việc để nhận kết quả.

Thông tin

Tên	Giá trị
Mã	`bots.create`
Scope cần	`bots.manage`
Mức	Ghi
Có thể cần xác nhận	Có
Kiểu chạy	Trả kết quả ngay
Cần `Idempotency-Key`	Có
Vai trò thành viên được phép	`owner`, `manager`, `agent`
Cần máy chạy từ bản	`1.0.37`
Trong app	Bot → Tạo bot

Trường vào

Trường	Kiểu	Bắt buộc
`accountIds`	`uuid[]`	Có
`name`	`chữ`	Có
`username`	`chữ`	Có

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/bots.create \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"accountIds":[],"name":"…","username":"…"}'

Trường ra (`data`)

Trường	Kiểu	Bắt buộc
`ok`	`true`	Có
`jobs`	`đối tượng[]`	Có
`skipped`	`số`	Có
`errors`	`chữ[]`	Có

Ví dụ trả về

{
  "data": {
    "ok": true,
    "jobs": [
      {
        "accountId": "00000000-0000-4000-8000-000000000000",
        "jobId": "00000000-0000-4000-8000-000000000000",
        "username": "text"
      }
    ],
    "skipped": 1,
    "errors": [
      "text"
    ]
  }
}

Dùng qua MCP

Không có tên sẵn trong profile nào: gọi tools_describe rồi tools_run với code: "bots.create". Tên tool khi được liệt kê: bots_create.

Tạo bot

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)