# Kênh

## Kênh là gì?

Kênh là các nền tảng nhắn tin mà tác nhân của bạn kết nối. Bằng cách kết nối một kênh, tác nhân của bạn có thể lắng nghe các tin nhắn đến và phản hồi theo thời gian thực trên nền tảng đó.

Neotask hỗ trợ **20+ nền tảng nhắn tin** ngay từ đầu.

## Kênh được hỗ trợ

### Kênh cốt lõi (Tích hợp sẵn)

| Kênh | Mô tả |
|---------|-------------|
| **WhatsApp** | Tài khoản cá nhân và doanh nghiệp qua giao thức WhatsApp Web. Nhóm, phản ứng, phương tiện, chủ đề, chỉnh sửa/thu hồi, chuyển tiếp. |
| **Telegram** | Tích hợp Bot API. Nhóm, kênh, chủ đề, phản ứng, ghim. Nhập webhook tùy chọn. |
| **Discord** | Tích hợp máy chủ đầy đủ. Kênh, vai trò, chủ đề, nhận biết kênh giọng nói, liên kết tác nhân theo máy chủ. |
| **Slack** | Ứng dụng không gian làm việc qua OAuth. Kênh, chủ đề, phản ứng, chia sẻ tệp. |
| **Signal** | DM và nhóm được mã hóa qua giao thức Signal. Ghép nối điện thoại qua mã QR. |
| **Google Chat** | Spaces, chủ đề, phản ứng, phản hồi thẻ qua webhook. |
| **iMessage** | Hỗ trợ SMS/iMessage đầy đủ qua BlueBubbles trên macOS. Chỉnh sửa, thu hồi, hiệu ứng. |
| **IRC** | IRC cổ điển với kênh, DM, xác thực SASL, hỗ trợ đa máy chủ. |

### Kênh plugin

| Kênh | Mô tả |
|---------|-------------|
| **Microsoft Teams** | Tích hợp không gian làm việc qua plugin. |
| **Matrix** | Giao thức nhắn tin phi tập trung. |
| **Nostr** | DM giao thức mạng xã hội phi tập trung. |
| **Zalo** | Nền tảng nhắn tin Việt Nam (Bot API và tài khoản cá nhân). |
| **Feishu/Lark** | Nền tảng nhắn tin doanh nghiệp. |
| **LINE** | Tích hợp LINE Messaging API. |
| **Nextcloud Talk** | Nhắn tin tự lưu trữ qua Nextcloud. |
| **Mattermost** | Nhắn tin nhóm mã nguồn mở. |
| **Tlon** | Nhắn tin dựa trên Urbit. |
| **Twitch** | Chat luồng trực tiếp qua IRC. |

## Tính năng kênh

### Hỗ trợ đa tài khoản
Chạy nhiều tài khoản trên mỗi kênh. Ví dụ: quản lý nhiều số WhatsApp hoặc bot Telegram từ cùng một Gateway.

### Hỗ trợ phương tiện
Gửi và nhận hình ảnh, video, âm thanh, tài liệu, sticker và các loại phương tiện khác. Xử lý phương tiện khác nhau tùy theo nền tảng nhưng hầu hết các kênh hỗ trợ phương tiện phong phú theo cả hai chiều.

### Quản lý nhóm & kênh
Các tác nhân có thể tham gia vào các cuộc trò chuyện nhóm, phản hồi các đề cập, quản lý chủ đề và tương tác với các tính năng dành riêng cho kênh (phản ứng, thăm dò, ghim).

### Phân luồng tin nhắn
Trên các nền tảng hỗ trợ nó (Slack, Discord, Telegram), các tác nhân có thể tạo chủ đề, trả lời trong chủ đề và duy trì ngữ cảnh dành riêng cho chủ đề.

### Chỉnh sửa tin nhắn & Phản ứng
Các tác nhân có thể chỉnh sửa tin nhắn của riêng họ, thu hồi tin nhắn và thêm phản ứng trên các nền tảng hỗ trợ các tính năng này.

### Nhóm phát sóng
Gửi thông báo đến nhiều kênh đồng thời. Cấu hình nhóm phát sóng để giữ nhiều nền tảng đồng bộ.

## Định tuyến kênh

### Hành vi mặc định
Theo mặc định, tác nhân chính nhận tất cả tin nhắn đến từ tất cả các kênh.

### Định tuyến đa tác nhân
Với nhiều tác nhân, tin nhắn được định tuyến dựa trên liên kết:

- **Theo kênh**, Tất cả tin nhắn WhatsApp → tác nhân personal
- **Theo máy chủ**, Máy chủ Discord A → tác nhân support, máy chủ B → tác nhân dev
- **Theo không gian làm việc**, Không gian làm việc Slack → tác nhân team
- **Theo loại chat**, DM riêng tư → trợ lý, tin nhắn nhóm → bot nhóm

### Kiểm soát truy cập DM
Cấu hình liên hệ nào có thể nhắn tin trực tiếp cho tác nhân của bạn. Các tùy chọn bao gồm cho phép tất cả DM, chỉ các liên hệ đã biết hoặc danh sách cho phép cụ thể.

### Kiểm soát đề cập nhóm
Trong các cuộc trò chuyện nhóm, cấu hình xem tác nhân có phản hồi tất cả tin nhắn hay chỉ khi được đề cập.

## Ghép nối & Xác thực

Mỗi kênh có phương thức xác thực riêng:

| Kênh | Phương thức xác thực |
|---------|-------------|
| WhatsApp | Quét mã QR |
| Telegram | Bot token |
| Discord | Bot token |
| Slack | OAuth (ứng dụng không gian làm việc) |
| Signal | Ghép nối điện thoại qua mã QR |
| Google Chat | URL webhook |
| iMessage | API key BlueBubbles |
| IRC | Nick + mật khẩu tùy chọn |