Ủ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. Gọi POST /v1/accounts với provider=telegram, auth_mode=code và provider_data.phone. Các trường api_id và api_hash trong provider_data là tùy chọn; nếu bỏ qua, nền tảng sẽ dùng thông tin xác thực ứng dụng mặc định.
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. Sau khi ủy quyền thành công, kiểm tra runtime_status trước. Chỉ gọi POST /v1/accounts/{account_id}/runtime/start khi vẫn cần khởi động.

• provider_data.api_id — Telegram App ID từ my.telegram.org, không bắt buộc. Nếu bỏ qua, nền tảng sẽ dùng thông tin xác thực ứng dụng mặc định. Để dùng ứng dụng riêng, hãy cung cấp cả api_id và api_hash của cùng một ứng dụng dưới dạng chuỗi.
• provider_data.api_hash — Telegram App Hash từ my.telegram.org, không bắt buộc. Nếu bỏ qua, nền tảng sẽ dùng thông tin xác thực ứng dụng mặc định. Để dùng ứng dụng riêng, hãy cung cấp cả api_id và api_hash của cùng một ứng dụng dưới dạng chuỗi.
• 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. Gọi POST /v1/accounts với provider=telegram và auth_mode=qrcode. Các trường api_id và api_hash trong provider_data là tùy chọn; nếu bỏ qua, nền tảng sẽ dùng thông tin xác thực ứng dụng mặc định.
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. Sau khi ủy quyền thành công, kiểm tra runtime_status trước. Chỉ gọi POST /v1/accounts/{account_id}/runtime/start khi vẫn cần khởi động.

• provider_data.api_id — Telegram App ID từ my.telegram.org, không bắt buộc. Nếu bỏ qua, nền tảng sẽ dùng thông tin xác thực ứng dụng mặc định. Để dùng ứng dụng riêng, hãy cung cấp cả api_id và api_hash của cùng một ứng dụng dưới dạng chuỗi.
• provider_data.api_hash — Telegram App Hash từ my.telegram.org, không bắt buộc. Nếu bỏ qua, nền tảng sẽ dùng thông tin xác thực ứng dụng mặc định. Để dùng ứng dụng riêng, hãy cung cấp cả api_id và api_hash của cùng một ứng dụng dưới dạng chuỗi.

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. Sau khi ủy quyền thành công, kiểm tra runtime_status trước. Chỉ gọi POST /v1/accounts/{account_id}/runtime/start khi vẫn cần khởi động.

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