Tham chiếu

Thêm người vào nhóm / kênh

Thêm những người tài khoản này đã nhắn cùng (chat riêng của cùng tài khoản, tối đa 20) vào một nhóm hoặc kênh. Mỗi người một việc Telegram, tính vào 'Thêm người vào nhóm' và được kiểm với danh sách không liên hệ.

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

Thông tin

Tên	Giá trị
Mã	`groups.add_members`
Scope cần	`groups.admin`
Mức	Ghi
Có thể cần xác nhận	Không
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.17`
Trong app	Hộp thư → thông tin nhóm → Thêm thành viên

Trường vào

Trường	Kiểu	Bắt buộc	Mô tả
`conversationId`	`uuid`	Có
`memberConversationIds`	`uuid[]`	Có

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.add_members \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"conversationId":"00000000-0000-0000-0000-000000000000","memberConversationIds":[]}'

Trường ra (`data`)

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

Ví dụ trả về

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

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: "groups.add_members". Tên tool khi được liệt kê: groups_add_members.

Thêm người vào nhóm / kênh

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)