Việc cần làm khi kết nối kênh Telegram cá nhân

Trước khi bắt đầu#

Dành cho admin cấu hình Telegram cá nhân (MTProto). Hoàn thành bài này, bạn sẽ biết khai báo ứng dụng Telegram dùng chung cho hệ thống và đăng nhập từng tài khoản để nhận, trả lời tin nhắn trong ChatHub.

1. 1

   Chuẩn bị tài khoản ChatHub có quyền truy cập Cài đặt → Kênh và trang quản lý Kênh.

2. 2

   Có tài khoản Telegram đang hoạt động, mở được ứng dụng Telegram để nhận mã; chuẩn bị mật khẩu xác thực hai bước nếu đã bật.

3. 3

   Chuẩn bị API ID và API Hash của cùng một ứng dụng Telegram. Nếu chưa có, làm theo bước lấy API bên dưới.

1. Mở Cài đặt → Kênh#

1. 1

   Trong ChatHub, mở menu Quản trị → Cài đặt.

2. 2

   Chọn tab Kênh ở cột bên trái. Bạn cũng có thể mở đường dẫn /settings?tab=channels trên tên miền ChatHub của mình.

3. 3

   Tìm khối Telegram cá nhân (MTProto). Hai ô cần cấu hình là API ID và API Hash; nút Lưu nằm phía dưới.

2. Lấy API ID và API Hash từ Telegram#

Mở my.telegram.org ↗

1. 1

   Nhập số điện thoại Telegram vào Your Phone Number theo định dạng quốc tế (bắt đầu bằng dấu + và mã quốc gia), rồi chọn Next.

2. 2

   Mở ứng dụng Telegram để lấy mã đăng nhập do Telegram gửi; nhập mã trên my.telegram.org để hoàn tất đăng nhập. Mã của trang này gửi qua Telegram, không phải SMS.

Sau khi đăng nhập, trang Your Telegram Core hiện ba lựa chọn. Bấm API development tools để mở thông tin ứng dụng, như ảnh dưới.

Nếu tài khoản đã có ứng dụng, Telegram mở thẳng App configuration. Nếu chưa có, bạn sẽ gặp biểu mẫu tạo ứng dụng: hoàn thành theo yêu cầu của Telegram để nhận API ID và API Hash. Ảnh dưới minh họa tài khoản đã có ứng dụng.

1. 1

   Sao chép giá trị bên phải App api_id (vị trí 1), rồi dán vào ô API ID của ChatHub.

2. 2

   Sao chép giá trị bên phải App api_hash (vị trí 2) trên cùng trang, rồi dán vào ô API Hash của ChatHub.

3. 3

   App title và Short name là tên ứng dụng, không phải khóa kết nối. Không dùng các giá trị này thay cho API ID/API Hash.

4. 4

   Chỉ lấy hai giá trị API ở đầu trang. Không cần sửa FCM credentials, WNS credentials, Available MTProto servers hoặc bấm Save changes trên Telegram khi chỉ lấy khóa của ứng dụng đã có. Tiếp tục bấm Lưu trong ChatHub theo bước 3 bên dưới.

Tham khảo: hướng dẫn tạo ứng dụng chính thức của Telegram ↗

3. Nhập thông tin và lưu cấu hình#

1. 1

   Quay lại ChatHub → Cài đặt → Kênh → Telegram cá nhân (MTProto).

2. 2

   Dán App api_id vào API ID. Đây phải là số nguyên dương; không dán API Hash hoặc bot token vào ô này.

3. 3

   Dán App api_hash vào API Hash. Lần cấu hình đầu tiên phải điền cả hai trường.

4. 4

   Bấm Lưu. Khi thành công, màn hình thông báo: “Đã lưu. Vào trang Kênh và kết nối lại tài khoản Telegram cá nhân.”

API Hash được mã hóa trước khi lưu. Giá trị tại đây được ưu tiên hơn TELEGRAM_API_ID/TELEGRAM_API_HASH trong biến môi trường và có hiệu lực ngay, không cần khởi động lại.

Nhãn Đã cấu hình cho biết đã lưu API Hash; nó chưa chứng minh cặp khóa đăng nhập được hay một tài khoản Telegram đã kết nối. Cần hoàn tất bước đăng nhập tiếp theo.

4. Kết nối tài khoản Telegram cá nhân#

1. 1

   Mở Quản trị → Kênh (đường dẫn /channels). Đây là trang quản lý tài khoản, khác tab Kênh trong Cài đặt.

2. 2

   Nếu chưa có tài khoản kênh: bấm Thêm tài khoản → chọn Telegram cá nhân (Số điện thoại) → Tạo tài khoản.

3. 3

   Nếu tài khoản kênh đã có: bấm Mở cấu hình trên thẻ Telegram cá nhân và tìm phần Đăng nhập Telegram. Không cần tạo tài khoản kênh trùng.

1. 1

   Nhập số điện thoại của tài khoản cần kết nối vào Số điện thoại. Với số nước ngoài, nhập kèm dấu + và mã quốc gia; ChatHub cũng hỗ trợ tự chuẩn hóa số trong nước.

2. 2

   Bấm Gửi mã xác thực, kiểm tra Telegram và nhập mã vào Mã xác thực → Xác nhận mã. Làm theo nơi nhận mã được ChatHub thông báo.

3. 3

   Nếu được yêu cầu, nhập Mật khẩu hai bước → Xác nhận mật khẩu. Đây là mật khẩu Telegram của tài khoản, không phải API Hash.

4. 4

   Chờ thông báo Đã kết nối tài khoản Telegram hoặc trạng thái Đã kết nối. Không chia sẻ mã đăng nhập cho người khác.

5. Kiểm tra và xử lý vướng mắc#

1. 1

   Kiểm tra tài khoản đã đăng nhập thành công và kênh đang bật. Chỉ lưu API chưa đủ để nhận tin nhắn.

2. 2

   Nếu cần nhận tin nhóm, kiểm tra Đồng bộ tin nhắn nhóm trong cấu hình tài khoản. Khi tắt, tin nhắn riêng vẫn được nhận nhưng tin nhóm mới không về hộp thư.

3. 3

   Dùng một tài khoản khác gửi tin thử tới tài khoản vừa kết nối; mở Tin nhắn trong ChatHub để kiểm tra và trả lời thử.

API ID không hợp lệ: nhập số nguyên dương từ App api_id. Thiếu API Hash ở lần đầu: nhập App api_hash rồi lưu lại. Đây là hai lỗi được kiểm tra ngay trong biểu mẫu.

Đã lưu nhưng vẫn chưa đăng nhập được: đối chiếu ID và Hash có cùng ứng dụng, lưu lại rồi vào trang Kênh để kết nối lại. Đọc thông báo lỗi cụ thể trước khi thử tiếp.

Chưa nhận mã: với my.telegram.org, kiểm tra ứng dụng Telegram; với ChatHub, kiểm tra số điện thoại và nơi nhận mã ghi trên màn hình. Dùng Gửi lại mã khi tùy chọn này xuất hiện. Nếu đang chờ mật khẩu hai bước, nhập mật khẩu của Telegram.