--- title: "Thêm tài khoản Telegram bằng mã QR" locale: vi url: https://tlg.builera.app/docs/guides/accounts-add-qr verified: 2026-10-24 app_version: "2.0" --- # Thêm tài khoản Telegram bằng mã QR Chọn proxy, máy chạy và đăng nhập tài khoản Telegram bằng mã QR trên điện thoại. Bạn thêm tài khoản Telegram cá nhân vào workspace bằng cách quét mã trên điện thoại. Trước khi đăng nhập, bạn chọn proxy riêng và máy giữ kết nối cho tài khoản. ## Ai làm được Chủ hoặc Quản lý workspace có quyền thêm và đăng nhập tài khoản. ## Cần chuẩn bị - Điện thoại đã đăng nhập đúng tài khoản Telegram. - Một proxy tĩnh còn trống, đã kiểm tra và không bị đánh dấu xoay IP. - Một máy đang kết nối, còn sức chứa và đang nhận tài khoản mới. - Mật khẩu xác minh hai lớp nếu tài khoản đã bật tính năng này. Chưa có hạ tầng? Xem [thêm proxy](https://tlg.builera.app/docs/guides/proxies), [máy Hetzner](https://tlg.builera.app/docs/guides/nodes-hetzner) hoặc [máy Windows](https://tlg.builera.app/docs/guides/nodes-windows). > [!IMPORTANT] > Mã QR có thể cho phép đăng nhập tài khoản. Không gửi mã cho người khác hoặc đưa vào ảnh hỗ trợ. Mã QR trong mọi ảnh tài liệu đều phải được che kín bằng khối màu. ## Bắt đầu ở đâu **Tài khoản → Thêm tài khoản**. ## Các bước 1. Bấm **Thêm tài khoản** để mở cửa sổ **Thêm tài khoản Telegram**. 2. Chọn proxy còn trống cho tài khoản. 3. Bấm **Tiếp**. 4. Chọn máy đang chạy và còn chỗ. Danh sách có gợi ý theo vị trí proxy; máy hết chỗ không chọn được. ![Bước chọn máy chạy cho tài khoản Telegram](https://tlg.builera.app/docs-media/vi/account-add-machine.webp "Chọn máy còn sức chứa") 5. Bấm **Tiếp**. 6. Điền **Tên gợi nhớ**, chẳng hạn “Shop An Nhiên”. Bạn cũng có thể đặt nhãn và màu để dễ phân biệt tài khoản. 7. Kiểm tra **Múi giờ**. Gợi ý được lấy từ thông tin proxy, quốc gia hoặc múi giờ workspace. 8. Kiểm tra các thông tin cài đặt còn lại trước khi tạo. 9. Bấm **Tạo & đăng nhập**. Bản ghi tài khoản được tạo trước, sau đó màn đăng nhập mở ra. 10. Giữ lựa chọn **Quét mã QR** và chờ mã xuất hiện. 11. Trên điện thoại, mở Telegram và vào **Cài đặt → Thiết bị → Liên kết thiết bị**. Với giao diện tiếng Anh, đường dẫn tương ứng là **Settings → Devices → Link Desktop Device**. 12. Quét mã đang hiển thị trong ứng dụng. 13. Nếu xuất hiện **Tài khoản có mật khẩu 2 lớp**, nhập **Mật khẩu 2 lớp**. 14. Bấm **Xác nhận** để gửi mật khẩu. 15. Khi thấy **Đăng nhập thành công**, bấm **Xong**. ## Kết quả Máy đã chọn giữ kết nối tài khoản qua proxy riêng. Ứng dụng bắt đầu đồng bộ hội thoại để bạn sử dụng trong Hộp thư. Tài khoản mới mặc định dùng **Tự do**, trừ khi cấu hình áp dụng sau khi tạo làm thay đổi chế độ. Đăng nhập thành công không có nghĩa tài khoản chắc chắn đang làm ấm. Hãy kiểm tra chế độ thực tế trong [Hạn mức & lịch](https://tlg.builera.app/docs/guides/accounts-limits-schedule). ## Kiểm tra - Mở chi tiết tài khoản và kiểm tra trạng thái đăng nhập. - Vào **Mạng & máy** để đối chiếu proxy và máy. - Mở Hộp thư để kiểm tra hội thoại đã đồng bộ. - Kiểm tra **Hạn mức & lịch** trước khi giao việc. ## Khi có lỗi Mã QR tự làm mới khi hết hạn. Nếu cả lần đăng nhập đã hết thời gian, bấm **Thử lại** để tạo lần mới. Nếu màn hình vẫn chờ máy nhận việc, kiểm tra Máy chủ và proxy. Đóng cửa sổ khi chưa hoàn tất sẽ yêu cầu huỷ lần đăng nhập, nhưng không tự xoá bản ghi tài khoản đã tạo. Xem thêm [lỗi đăng nhập Telegram](https://tlg.builera.app/docs/troubleshooting/telegram-login). ## Làm bằng API hoặc MCP Luồng tương ứng gồm [accounts.create](https://tlg.builera.app/docs/reference/rest/accounts.create), [accounts.login_start](https://tlg.builera.app/docs/reference/rest/accounts.login_start), [accounts.login_status](https://tlg.builera.app/docs/reference/rest/accounts.login_status) và [accounts.login_submit](https://tlg.builera.app/docs/reference/rest/accounts.login_submit). Tên MCP tương ứng: `accounts_create`, `accounts_login_start`, `accounts_login_status`, `accounts_login_submit`. Việc quét mã vẫn do bạn thực hiện trên điện thoại; không đưa bí mật đăng nhập vào hội thoại với agent.