Kết nối một kênh (Email, Slack, Telegram, Zalo)
Mỗi kênh được kết nối một lần trong Cài đặt; sau đó tin nhắn của nó xuất hiện trong Hộp thư chung. Email là hai chiều hoàn toàn — trả lời đi qua SMTP và thư đến được lấy qua IMAP.
Khi nào dùng
Hãy kết nối kênh khi bạn muốn tin nhắn của khách từ kênh đó về thẳng Hộp thư chung thay vì nằm trong hộp thư cá nhân hay một ứng dụng riêng. Thông thường quản trị viên IT làm một lần khi triển khai, sau đó thêm kênh mới khi doanh nghiệp mở thêm cách để khách liên hệ. Zalo Official Account dành cho thị trường Việt Nam.
Trước khi bắt đầu
- Bạn cần quyền
communications:manageđể kết nối kênh (tab Tích hợp trong Cài đặt). Công tắc tính năng và vai trò trong Cài đặt cầncommunications:admin. - Chuẩn bị sẵn thông tin: chi tiết hộp thư cho Email, quản trị workspace Slack cho bước OAuth, một bot Telegram, hoặc một Zalo Official Account.
- Công tắc
communications.email_ingestion: bật bộ nhập định kỳ kéo email từ các hộp thư đã kết nối vào Hộp thư. Mặc định tắt, và bật cho công ty mới tạo. Nếu tắt ở công ty bạn, các hộp thư đã kết nối sẽ bị bỏ qua.
Các bước
Mở cài đặt kênh
Vào Giao tiếp → Cài đặt (/communications/settings) và mở tab Tích hợp. Chọn kênh muốn thêm (Email, Slack, Telegram hoặc Zalo).
Nhập thông tin đăng nhập
Với Email, cung cấp host/port/user/mật khẩu SMTP để gửi và host/port IMAP để nhận. Với Slack/Telegram/Zalo, dán bot token / access token — thông tin được mã hóa khi lưu.
Kiểm tra và kích hoạt
Lưu kết nối; XBuddy xác thực và bắt đầu lấy tin. Tin nhắn mới bắt đầu về Hộp thư hợp nhất trong vài phút.
Xác nhận tin nhắn về được
Mở kênh ở thanh bên (ví dụ /communications?channel=zalo) và gửi thử một tin từ bên ngoài. Kiểm tra tin xuất hiện trong danh sách luồng.
Lưu ý theo kênh
| Kênh | Cách kết nối | Cần biết |
|---|---|---|
| Kết nối hộp thư (OAuth), đồng bộ và kiểm tra kết nối | Nhập IMAP cần bật công tắc communications.email_ingestion | |
| Slack | OAuth | Tin đến xuất hiện trong Hộp thư; trả lời đăng ngược lên Slack |
| Telegram | Bot thiết lập qua webhook | Nhắn tin hai chiều với khách |
| Zalo | Official Account thiết lập qua webhook | Xác thực chữ ký chỉ áp dụng khi đã cấu hình khoá |
| Microsoft Teams | Chỉ trạng thái, OAuth, ngắt kết nối | Chưa nhận được tin nhắn Teams |
Microsoft Teams hiện mới có phần kết nối; chưa có webhook nhận tin như Slack, Telegram và Zalo.
Mẹo & lỗi thường gặp
- Email không về: kiểm tra công tắc
communications.email_ingestionđã bật cho công ty và phép kiểm tra kết nối hộp thư đạt. - Kết nối bằng tài khoản có
communications:manage; người chỉ có quyền đọc không thể thêm hay gỡ kênh. - Ngắt kết nối kênh sẽ dừng nhận tin mới; hãy cân nhắc trước khi gỡ kênh khách vẫn đang dùng.
- Dùng một hộp thư hỗ trợ riêng thay vì hộp thư cá nhân để luồng thuộc về cả đội.
- Chạy lại kiểm tra kết nối sau mỗi lần đổi mật khẩu hoặc token ở phía nhà cung cấp.