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

# Vào nhóm

Vào một nhóm đã lưu bằng một tài khoản (tính vào hạn mức vào nhóm).

Vào một nhóm đã lưu bằng một tài khoản (tính vào hạn mức vào nhóm).

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `groups.join` |
| Scope cần | `groups.join` |
| 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` |
| Trong app | Tìm khách → Nhóm → Vào |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `groupId` | `uuid` | Có |   |
| `accountId` | `uuid` | Có |   |

## Ví dụ gọi

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

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

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

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "membershipId": "00000000-0000-4000-8000-000000000000",
    "status": "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: "groups.join"`. Tên tool khi được liệt kê: `groups_join`.