Tài liệu

Tham chiếu

Bắt đầu đăng nhập (QR hoặc số điện thoại)

Bắt đầu đăng nhập Telegram. Trả về attemptId; hỏi accounts_login_status để lấy link QR hoặc yêu cầu nhập mã. Chỉ cho chủ tài khoản xem QR.

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

Bắt đầu đăng nhập Telegram. Trả về attemptId; hỏi accounts_login_status để lấy link QR hoặc yêu cầu nhập mã. Chỉ cho chủ tài khoản xem QR.

Thông tin

Tên Giá trị
Mã accounts.login_start
Scope cần accounts.manage
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ài khoản → Đăng nhập

Trường vào

Trường Kiểu Bắt buộc Mô tả
accountId uuid Có
method "qr" | "phone" Có
phone chữ Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/accounts.login_start \
  -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","method":"qr"}'

Trường ra (data)

Trường Kiểu Bắt buộc
ok true Có
attemptId chữ Có

Ví dụ trả về

{
  "data": {
    "ok": true,
    "attemptId": "00000000-0000-4000-8000-000000000000"
  }
}

Dùng qua MCP

Tool accounts_login_start có tên sẵn trong profile: Quản trị (admin). Ở profile khác, tìm bằng tools_search rồi chạy bằng tools_run.

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

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