Tài liệu

Tham chiếu

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

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

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

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ề

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

Trang này có hữu ích không?

Kiểm lại lần cuối: 24/10/2026 · bản 2.0