Kênh
Kênh là gì?
Kênh là các nền tảng giao tiếp mà các tác nhân Neotask của bạn sử dụng để gửi và nhận tin nhắn. Bằng cách kết nối một kênh, bạn cấp cho tác nhân khả năng lắng nghe tin nhắn đến trên nền tảng đó và phản hồi theo thời gian thực.
Các khái niệm chính:
- Cấu hình theo từng tác nhân -- Mỗi kết nối kênh được cấu hình ở cấp độ tác nhân. Một tác nhân có thể kết nối với Slack trong khi tác nhân khác xử lý Discord, hoặc một tác nhân duy nhất có thể kết nối với nhiều kênh cùng lúc.
- Hai chiều -- Kênh hỗ trợ cả gửi và nhận tin nhắn. Tác nhân có thể phản hồi tin nhắn đến, bắt đầu tin nhắn đi, hoặc cả hai.
- Đa tài khoản -- Bạn có thể kết nối nhiều tài khoản cho cùng một loại kênh (ví dụ: hai không gian làm việc Slack khác nhau hoặc nhiều địa chỉ email).
Kênh được hỗ trợ
| Kênh | Phương thức xác thực | Tính năng |
|---|---|---|
| Slack | OAuth | Nhắn tin đầy đủ, kênh, luồng, phản ứng, tải tệp lên |
| Discord | Token bot | Nhắn tin máy chủ, kênh, DM, nhúng, phản ứng |
| Mã QR | Tin nhắn văn bản, tin nhắn media, trò chuyện nhóm | |
| Telegram | Token bot | Tin nhắn văn bản, nhóm, kênh, bàn phím nội tuyến, chia sẻ tệp |
| Signal | Ứng dụng cục bộ | Nhắn tin mã hóa đầu cuối, trò chuyện nhóm |
| Microsoft Teams | OAuth | Nhóm, kênh, trò chuyện, thẻ thích ứng, chia sẻ tệp |
| Google Chat | OAuth | Không gian, tin nhắn trực tiếp, thẻ, cuộc trò chuyện có luồng |
| SMS | Khóa API | Nhắn tin văn bản đi và đến qua các nhà cung cấp được hỗ trợ |
| Email / Gmail | OAuth | Gửi, nhận, soạn thảo, trả lời, đính kèm, quản lý nhãn |
| Matrix | Token | Nhắn tin liên kết, phòng, mã hóa đầu cuối |
| Line | Token | Tin nhắn văn bản, nhãn dán, trò chuyện nhóm, menu phong phú |
| Zalo | Token | Tin nhắn văn bản, chia sẻ media |
| IRC | Cấu hình | Kết nối máy chủ, kênh, tin nhắn riêng |
| iMessage | Cục bộ | Nhắn tin gốc macOS (yêu cầu máy chủ macOS) |
Kết nối kênh
Quy trình kết nối thay đổi tùy thuộc vào phương thức xác thực của kênh.
Luồng OAuth
Sử dụng bởi: Slack, Microsoft Teams, Google Chat, Email / Gmail
- Mở tab Kênh của tác nhân.
- Nhấp vào Kết nối bên cạnh kênh bạn muốn thêm.
- Bạn sẽ được chuyển hướng đến trang ủy quyền của dịch vụ.
- Đăng nhập bằng tài khoản của bạn và cấp cho Neotask các quyền được yêu cầu.
- Sau khi ủy quyền, bạn được chuyển hướng trở lại bảng điều khiển và kênh xuất hiện là đã kết nối.
Đối với nền tảng di động, có tùy chọn mã QR. Quét mã QR từ điện thoại của bạn để hoàn tất ủy quyền mà không cần đăng nhập trên trình duyệt máy tính để bàn.
Token bot
Sử dụng bởi: Discord, Telegram
- Tạo bot trên nền tảng tương ứng:
- Discord -- Tạo ứng dụng tại Discord Developer Portal và tạo token bot.
- Telegram -- Nhắn tin @BotFather trên Telegram để tạo bot và nhận token.
- Mở tab Kênh của tác nhân và nhấp vào Kết nối bên cạnh kênh.
- Dán token bot vào trường token.
- Nhấp vào Lưu để thiết lập kết nối.
Mã QR
Sử dụng bởi: WhatsApp
- Mở tab Kênh của tác nhân và nhấp vào Kết nối bên cạnh WhatsApp.
- Một mã QR sẽ xuất hiện trên màn hình.
- Mở WhatsApp trên điện thoại, vào Thiết bị liên kết và quét mã QR.
- Kết nối được thiết lập khi điện thoại của bạn xác nhận liên kết.
Khóa API
Sử dụng bởi: SMS
- Lấy khóa API từ nhà cung cấp SMS của bạn (ví dụ: Twilio, Vonage).
- Mở tab Kênh của tác nhân và nhấp vào Kết nối bên cạnh SMS.
- Nhập khóa API và bất kỳ trường bắt buộc bổ sung nào (ví dụ: số điện thoại, account SID).
- Nhấp vào Lưu để kích hoạt kênh.
Token
Sử dụng bởi: Matrix, Line, Zalo
- Tạo token truy cập từ cài đặt nhà phát triển hoặc bảng quản trị của nền tảng tương ứng.
- Mở tab Kênh của tác nhân và nhấp vào Kết nối bên cạnh kênh.
- Dán token vào trường token.
- Nhấp vào Lưu để thiết lập kết nối.
Cấu hình máy chủ
Sử dụng bởi: IRC
- Mở tab Kênh của tác nhân và nhấp vào Kết nối bên cạnh IRC.
- Nhập địa chỉ máy chủ, cổng, biệt danh và (tùy chọn) mật khẩu.
- Chỉ định các kênh để tham gia khi kết nối.
- Nhấp vào Lưu để kết nối.
Ứng dụng cục bộ
Sử dụng bởi: Signal, iMessage
- Đảm bảo ứng dụng cần thiết được cài đặt và chạy trên máy chủ:
- Signal -- Signal Desktop phải được cài đặt và liên kết với tài khoản Signal của bạn.
- iMessage -- Yêu cầu máy chủ macOS với Messages.app được cấu hình.
- Mở tab Kênh của tác nhân và nhấp vào Kết nối bên cạnh kênh.
- Neotask sẽ phát hiện ứng dụng cục bộ và thiết lập kết nối.
- Nếu ứng dụng không được phát hiện, bạn sẽ được nhắc cài đặt hoặc cấu hình nó.
Kiểm tra kết nối
Sau khi kết nối bất kỳ kênh nào, Neotask tự động chạy kiểm tra độ trễ để xác minh kết nối:
- Một tin nhắn thử nghiệm được gửi và nhận qua API của kênh.
- Độ trễ khứ hồi được đo và hiển thị.
- Nếu bài kiểm tra thất bại, thông báo lỗi mô tả vấn đề (ví dụ: token không hợp lệ, ủy quyền OAuth hết hạn, máy chủ không thể truy cập).
Bạn có thể chạy lại bài kiểm tra kết nối bất kỳ lúc nào từ cài đặt kênh.
Thao tác kênh
Sau khi kênh được kết nối, bạn có thể quản lý nó từ tab Kênh của tác nhân.
Bật / Tắt
Bật hoặc tắt kênh mà không ngắt kết nối. Khi bị tắt:
- Tác nhân ngừng lắng nghe tin nhắn trên kênh đó.
- Không có tin nhắn đi nào được gửi qua nó.
- Thông tin xác thực kết nối được giữ lại để bạn có thể bật lại bất kỳ lúc nào mà không cần cấu hình lại.
Kiểm tra kết nối
Chạy bài kiểm tra kết nối theo yêu cầu để xác minh kênh có thể truy cập và phản hồi. Bài kiểm tra:
- Gửi yêu cầu API nhẹ đến dịch vụ của kênh.
- Đo độ trễ khứ hồi tính bằng mili giây.
- Báo cáo kết quả là Đã kết nối (với độ trễ) hoặc Thất bại (với chi tiết lỗi).
Xem độ trễ
Mỗi kênh đã kết nối hiển thị lần đọc độ trễ gần đây nhất trên tab Kênh. Điều này giúp bạn xác định các kết nối chậm hoặc bị suy giảm ngay lập tức. Độ trễ được cập nhật:
- Tự động sau mỗi bài kiểm tra kết nối.
- Định kỳ trong nền khi kênh đang hoạt động.
Ngắt kết nối / Đăng xuất
Để xóa hoàn toàn kết nối kênh:
- Nhấp vào Ngắt kết nối bên cạnh kênh.
- Xác nhận hành động trong hộp thoại.
- Neotask thu hồi hoặc loại bỏ thông tin xác thực đã lưu (token OAuth được thu hồi ở phía nhà cung cấp khi được hỗ trợ).
- Kênh bị xóa khỏi danh sách kênh hoạt động của tác nhân.
Để kết nối lại sau khi ngắt kết nối, hãy thực hiện lại các bước kết nối ban đầu.