---
title: "Thêm người vào nhóm / kênh"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/groups.add_members
verified: 2026-10-24
app_version: "2.0"
generated: true
---

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

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

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

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

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