---
title: "Tạo link mời"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/groups.create_link
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Tạo link mời

Tạo link mời: tên tuỳ chọn, số ngày hết hạn, giới hạn lượt dùng, hoặc 'xin vào nhóm' (quản trị viên duyệt từng người). Theo dõi thao tác để nhận link.

Tạo link mời: tên tuỳ chọn, số ngày hết hạn, giới hạn lượt dùng, hoặc 'xin vào nhóm' (quản trị viên duyệt từng người). Theo dõi thao tác để nhận link.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `groups.create_link` |
| Scope cần | `groups.admin` |
| 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` |
| Cần máy chạy từ bản | `1.0.17` |
| Trong app | Hộp thư → thông tin nhóm → Quản lý |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `conversationId` | `uuid` | Có |   |
| `title` | `chữ` | Không |   |
| `requestNeeded` | `đúng/sai` | Không |   |
| `expireDays` | `số nguyên` | Không |   |
| `usageLimit` | `số nguyên` | Không |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/groups.create_link \
  -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"}'
```

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