Ủy quyền Telegram

Luồng mã xác nhận: server yêu cầu Telegram gửi mã, người dùng nhận qua SMS hoặc trong app rồi gửi lại.

1. 1. POST /v1/accounts với provider=telegram, auth_mode=code, provider_data chứa api_id, api_hash và phone.
2. 2. POST /v1/accounts/{account_id}/auth/start để yêu cầu Telegram gửi mã xác nhận.
3. 3. Khi người dùng nhận được mã, POST /v1/accounts/{account_id}/auth/code kèm giá trị mã.
4. 4. Nếu tài khoản bật 2FA, status sẽ thành awaiting_password — POST /v1/accounts/{account_id}/auth/password để gửi mật khẩu.
5. 5. Khi thành công, POST /v1/accounts/{account_id}/runtime/start để đưa tài khoản online.

• provider_data.api_id — Telegram App ID lấy từ my.telegram.org. Bắt buộc cho cả ba luồng Telegram.
• provider_data.api_hash — Telegram App Hash lấy từ my.telegram.org. Bắt buộc cho cả ba luồng Telegram.
• provider_data.phone — Số điện thoại theo định dạng E.164. Chỉ cần cho luồng code.

Luồng QR: lấy QR token để người dùng quét trong app Telegram.

1. 1. POST /v1/accounts với provider=telegram, auth_mode=qrcode và provider_data.api_id / api_hash.
2. 2. POST /v1/accounts/{account_id}/auth/qr/start — phản hồi chứa QR token để hiển thị.
3. 3. Poll POST /v1/accounts/{account_id}/auth/qr/check đến khi status=authorized. QR hết hạn sau ~30 giây, gọi lại qr/start để làm mới.
4. 4. Khi thành công, POST /v1/accounts/{account_id}/runtime/start.

• provider_data.api_id — Telegram App ID lấy từ my.telegram.org. Bắt buộc cho cả ba luồng Telegram.
• provider_data.api_hash — Telegram App Hash lấy từ my.telegram.org. Bắt buộc cho cả ba luồng Telegram.

Luồng nhập session: nhập một session Telegram đã được ủy quyền vào UnifyPort.

1. 1. POST /v1/accounts với provider=telegram, auth_mode=session.
2. 2. POST /v1/accounts/{account_id}/auth/session với params.session_url trỏ tới file .session tải xuống được.
3. 3. Khi import xác nhận session hợp lệ, POST /v1/accounts/{account_id}/runtime/start.

• params.session_url — URL hoặc tham chiếu tới session Telegram đã có.