Hướng dẫn thêm kênh vào ChatHub

Thêm kênh để nhận tin nhắn tập trung#

Trang Kênh là nơi kết nối tài khoản nhắn tin và khung chat website với ChatHub. Bài này hướng dẫn thêm cả bốn loại hiện có: Zalo cá nhân, Telegram cá nhân, Telegram Bot và Chat Plugin; sau đó kiểm tra kết nối và tin nhắn về hộp thư.

Mở trang Kênh trong hệ thống minh họa ↗

1. Chuẩn bị trước khi thêm kênh#

1. 1

   Đăng nhập tài khoản ChatHub có quyền quản lý Kênh. Nếu không mở được trang hoặc thiếu nút thao tác, nhờ quản trị viên kiểm tra quyền.

2. 2

   Zalo cá nhân: chuẩn bị điện thoại đang đăng nhập đúng tài khoản Zalo để quét và xác nhận QR.

3. 3

   Telegram cá nhân: chuẩn bị số điện thoại, ứng dụng Telegram nhận mã và mật khẩu hai bước nếu đã bật. Quản trị viên cần cấu hình API ID/API Hash dùng chung trước.

4. 4

   Telegram Bot: chuẩn bị bot do bạn quản lý và token từ BotFather. Máy chủ ChatHub phải có địa chỉ HTTPS mà Telegram truy cập được để nhận webhook; tên miền DDEV chỉ truy cập trong máy không đủ cho bước này.

5. 5

   Chat Plugin: chuẩn bị website bạn được phép chỉnh sửa, danh sách tên miền nhúng và nội dung hỗ trợ hiển thị cho khách.

Hướng dẫn cấu hình API và Telegram cá nhân ↗

2. Mở cửa sổ Thêm tài khoản#

1. 1

   Mở /channels trên tên miền ChatHub của bạn, chọn Thêm tài khoản ở góc trên bên phải.

2. 2

   Chọn một trong bốn loại ở cột trái. Đọc Thiết lập và Bước tiếp theo ở bên phải để chuẩn bị đúng thông tin.

3. 3

   Với Telegram Bot, điền thêm Bot token. Ba loại còn lại không yêu cầu thông tin đăng nhập ngay trong cửa sổ này. Giao diện hiện tại tự đặt tên theo loại kênh, không có ô nhập tên riêng.

4. 4

   Khi đã sẵn sàng, bấm Tạo tài khoản; ChatHub mở cấu hình của tài khoản vừa tạo. Dùng Huỷ hoặc dấu × nếu chưa muốn tạo.

3. Thêm Zalo cá nhân bằng QR#

1. 1

   Chọn Zalo cá nhân → Tạo tài khoản. Trong cấu hình vừa mở, tìm Đăng nhập Zalo và tab Quét mã QR.

2. 2

   Bấm Tạo mã QR. Dùng chức năng quét QR của ứng dụng Zalo trên điện thoại đang đăng nhập tài khoản cần kết nối.

3. 3

   Khi trạng thái chuyển sang Đã quét, tiếp tục xác nhận đăng nhập trên điện thoại. Chờ Đã kết nối rồi kiểm tra trạng thái kênh.

4. 4

   Nếu mã Hết hạn, bấm Tạo mã mới và quét lại. Nếu Bị từ chối, kiểm tra thao tác xác nhận trên điện thoại; nếu Thất bại, đọc lỗi rồi chọn Thử lại.

4. Thêm Telegram cá nhân#

1. 1

   Hoàn thành cấu hình API ID/API Hash theo bài Telegram cá nhân, rồi quay lại Kênh → Thêm tài khoản → Telegram cá nhân → Tạo tài khoản.

2. 2

   Tại Đăng nhập Telegram, nhập Số điện thoại của bạn. Với số quốc tế, dùng dấu + và mã quốc gia; kiểm tra dòng Sẽ gửi mã tới trước khi bấm Gửi mã xác thực.

3. 3

   Đọc thông báo để biết mã gửi trong ứng dụng Telegram hay bằng tin nhắn. Nhập vào Mã xác thực rồi bấm Xác nhận mã. Chỉ dùng Gửi lại mã khi cần và tuân theo thời gian chờ Telegram báo.

4. 4

   Nếu được yêu cầu, điền Mật khẩu hai bước và bấm Xác nhận mật khẩu. Khi hiện Đã kết nối, kiểm tra lại danh sách Kênh và thử nhận tin bằng tài khoản kiểm thử.

5. Tạo và kết nối Telegram Bot#

Mở BotFather chính thức ↗

1. 1

   Mở đúng @BotFather có dấu xác minh trong Telegram. Nếu chưa có bot, gửi /newbot và làm theo các câu hỏi của BotFather để đặt tên, username và nhận token. Nếu đã có bot, dùng token của bot bạn muốn nối.

2. 2

   Trong ChatHub, chọn Thêm tài khoản → Telegram Bot. Dán token thật vào Bot token rồi bấm Tạo tài khoản.

3. 3

   Trong cấu hình tài khoản vừa tạo, bấm Kết nối. ChatHub dùng token đã lưu để đăng ký webhook với Telegram; tạo tài khoản xong chưa thay thế bước kết nối này.

4. 4

   Chờ trạng thái Đang hoạt động. Từ tài khoản Telegram kiểm thử, mở bot, bấm Start và gửi tin thử; kiểm tra tin về Tin nhắn trong ChatHub rồi trả lời để kiểm tra hai chiều.

Telegram: hướng dẫn lấy bot token ↗

6. Tạo Chat Plugin cho website#

1. 1

   Chọn Thêm tài khoản → Chat Plugin → Tạo tài khoản. Loại này không yêu cầu số điện thoại, QR hay bot token.

2. 2

   Trong cấu hình, bấm Kết nối để bật kết nối của khung chat. Kiểm tra trạng thái trước khi nhúng website.

3. 3

   Tìm KHUNG CHAT TRÊN WEBSITE với ba tab Hiển thị, Biểu mẫu và Mã nhúng. Thực hiện các bước tùy chỉnh bên dưới, sau đó bấm Lưu cấu hình.

7. Chỉnh giao diện và lời chào#

1. 1

   Trong Hiển thị, chọn kiểu Nút tròn, Viên thuốc hoặc Thẻ dọc; chọn Bên phải/Bên trái và kích thước nút.

2. 2

   Chỉnh căn lề ngang, lề dưới website/mobile, màu chủ đạo và biểu tượng. Với kiểu có chữ, chỉnh Chữ trên nút. Chọn ảnh riêng nếu muốn dùng ảnh từ thư viện tệp công việc.

3. 3

   Điền Tiêu đề khung chat, Dòng mô tả và Câu chào. Ví dụ tiêu đề “Hỗ trợ cửa hàng mẫu”, lời chào “Chào bạn! Bạn cần hỗ trợ sản phẩm nào?”. Các trường có hướng dẫn mặc định có thể để trống để dùng nội dung theo ngôn ngữ hệ thống.

4. 4

   Quan sát XEM TRƯỚC để kiểm tra chữ và vị trí nút. Đây là bản mô phỏng; vẫn cần thử khung chat trên website thật. Câu chào chỉ hiển thị trên giao diện, tự nó không tạo hội thoại trong hộp thư.

8. Chọn cách khách trò chuyện và gửi tệp#

1. 1

   Bật Cho khách mở nhiều cuộc trò chuyện nếu muốn khách mở cuộc mới cho việc khác: mỗi cuộc là một hội thoại trong hộp thư nhưng dùng chung liên hệ. Tắt để tin của một khách tập trung vào một hội thoại.

2. 2

   Chọn Cho khách gửi ảnh và tệp nếu muốn khách dùng nút đính kèm hoặc kéo thả; giao diện hiện ghi giới hạn tối đa 10 MB mỗi tệp.

3. 3

   Bấm Lưu cấu hình sau khi hoàn tất các tùy chỉnh Chat Plugin. Nếu chỉ đang xem thử, đóng cửa sổ mà không lưu.

9. Hỏi thông tin trước khi chat#

1. 1

   Mở Biểu mẫu và bật Hỏi thông tin trước khi chat nếu cần thu thập thông tin trước khi khách nhắn. Biểu mẫu chỉ hỏi một lần; khách quay lại vào thẳng khung chat.

2. 2

   Viết Câu dẫn và Chữ trên nút gửi hoặc giữ mặc định. Ví dụ câu dẫn: “Cho shop biết tên để hỗ trợ bạn thuận tiện hơn.”

3. 3

   Ở Các ô cần hỏi, bật Hỏi để hiện Họ và tên, Số điện thoại hoặc Email. Bật Bắt buộc cho ô khách phải điền; một ô không được hỏi thì không thể đặt bắt buộc.

4. 4

   Kiểm tra bản xem trước rồi Lưu cấu hình. Thông tin được đưa vào hồ sơ liên hệ; giá trị đã có trong hồ sơ không bị ghi đè.

10. Nhúng Chat Plugin vào website#

1. 1

   Mở tab Mã nhúng, chọn Chép mã để lấy đoạn script của chính kênh. Dán vào cuối các trang cần hiện chat, ngay trước thẻ đóng body; nếu website có mẫu dùng chung, đặt ở mẫu đó.

2. 2

   Trong Tên miền được phép nhúng, khai từng tên miền trên một dòng. Ảnh dùng https://example.com để minh họa; thay bằng tên miền website của bạn, bao gồm các tên miền phụ cần dùng.

3. 3

   Bấm Lưu cấu hình. Mở website đã nhúng, kiểm tra nút chat trên máy tính và điện thoại, biểu mẫu nếu bật, rồi gửi/nhận tin bằng phiên kiểm thử.

4. 4

   Nếu widget không hiện, kiểm tra kênh đã Kết nối, đoạn script được đặt đúng, trang đang mở khớp tên miền cho phép và trình duyệt tải được máy chủ ChatHub.

11. Kiểm tra sau khi thêm kênh#

1. 1

   Quay lại Kênh, bấm biểu tượng làm mới. Xoá bộ lọc hoặc tìm theo tên/loại nếu chưa thấy tài khoản mới.

2. 2

   Đối chiếu công tắc bật/tắt với nhãn trạng thái: Hoạt động là kênh bật và đã kết nối; Đã ngắt là chưa có kết nối; Đã tắt là công tắc tắt. Cần chú ý gom các trạng thái còn lại cần kiểm tra.

3. 3

   Mở cấu hình để xem trạng thái đăng nhập, lỗi nếu có, Tín hiệu cuối và Khả năng hỗ trợ. Với kênh chưa kết nối có nút Kết nối; với trạng thái khác, giao diện có thể hiện Kết nối lại, Kiểm tra và Ngắt kết nối.

4. 4

   Sau khi xác thực và kết nối thành công, dùng tài khoản hoặc phiên khách kiểm thử gửi một tin đến kênh, mở Tin nhắn để kiểm tra, rồi trả lời để xác nhận chiều gửi. Không coi một nhãn xanh trên kênh demo là bằng chứng kết nối dịch vụ thật.

Hướng dẫn sử dụng Tin nhắn sau khi kết nối ↗

12. Chọn tin nhắn nhóm cần đồng bộ#

1. 1

   Với kênh có phần Đồng bộ tin nhắn, kiểm tra Đồng bộ tin nhắn nhóm. Tắt sẽ chặn tin mới trong nhóm về hộp thư, nhưng vẫn nhận tin nhắn riêng.

2. 2

   Nhóm cụ thể chỉ xuất hiện sau khi ChatHub đã nhận tin đầu tiên từ nhóm; danh sách trống chưa chắc là lỗi kết nối.

3. 3

   Khi nhóm đã hiện, chọn bỏ qua hoặc nhận lại từng nhóm theo nhu cầu. Bỏ qua chỉ chặn tin mới, không xóa hội thoại và lịch sử đã nhận. Các công tắc đồng bộ lưu ngay khi gạt.

13. Xử lý lỗi thường gặp và quản lý kết nối#

1. 1

   Không thấy kênh: bấm làm mới, xoá từ khóa và bộ lọc; kiểm tra thông báo sau Tạo tài khoản trước khi tạo lại để tránh trùng.

2. 2

   Telegram cá nhân chưa nhận mã: kiểm tra số ở Sẽ gửi mã tới, nơi gửi mã theo thông báo và cấu hình API dùng chung. Mã sai/hết hạn cần mã mới; Mật khẩu hai bước là mật khẩu bạn đã đặt, không phải OTP.

3. 3

   Zalo đã quét nhưng chưa kết nối: kiểm tra xác nhận trên điện thoại; mã hết hạn cần tạo QR mới.

4. 4

   Telegram Bot lỗi token/webhook: kiểm tra đúng token của bot, trạng thái kết nối và HTTPS công khai. Nhờ quản trị viên xử lý lỗi máy chủ thay vì nhập token vào các trường không liên quan.

5. 5

   Chat Plugin có nút nhưng chưa có tin: lời chào và bản xem trước không tự tạo hội thoại. Hoàn thành biểu mẫu nếu có và gửi tin kiểm thử trên website đã nhúng.

6. 6

   Công tắc bật/tắt kênh lưu ngay; bật kênh sẽ thử kết nối nhưng có thể thất bại nếu thiếu phiên hợp lệ. Kết nối lại/Ngắt kết nối thay đổi kết nối thật. Xoá tài khoản không phải cách xử lý lỗi đăng nhập thông thường; đọc kỹ xác nhận trước khi dùng.