---
title: "Tạo nhóm chat"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/groups.create_chat
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Tạo nhóm chat

Tạo nhóm Telegram từ một tài khoản với những người tài khoản đã nhắn cùng (tối đa 20).

Tạo nhóm Telegram từ một tài khoản với những người tài khoản đã nhắn cùng (tối đa 20).

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `groups.create_chat` |
| Scope cần | `contacts.write` |
| Mức | Ghi |
| Có thể cần xác nhận | Không |
| Kiểu chạy | Xếp việc cho máy chạy |
| Cần `Idempotency-Key` | Có |
| Vai trò thành viên được phép | `owner`, `manager`, `agent` |
| Trong app | Hộp thư → Nhóm mới |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `accountId` | `uuid` | Có |   |
| `title` | `chữ` | Có |   |
| `memberConversationIds` | `uuid[]` | Có |   |

## Ví dụ gọi

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

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `ok` | `true` | Có |
| `jobId` | `chữ` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "jobId": "00000000-0000-4000-8000-000000000000"
  }
}
```

## 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.create_chat"`. Tên tool khi được liệt kê: `groups_create_chat`.