頻道
什麼是頻道？
頻道是您的 Neotask 代理程式用來發送和接收訊息的通訊平台。通過連接頻道，您賦予代理程式在該平台上監聽傳入訊息並即時回應的能力。
主要概念：
- 每個代理程式配置 -- 每個頻道連接都在代理程式層級配置。一個代理程式可以連接 Slack，而另一個處理 Discord，或單個代理程式可以同時連接多個頻道。
- 雙向 -- 頻道支援發送和接收訊息。代理程式可以回應傳入訊息、發起外發訊息，或兩者兼具。
- 多帳戶 -- 您可以為同一頻道類型連接多個帳戶（例如兩個不同的 Slack 工作區或多個電子郵件地址）。
支援的頻道
| 頻道 | 認證方式 | 功能 |
|---|---|---|
| Slack | OAuth | 完整訊息、頻道、對話串、反應、檔案上傳 |
| Discord | Bot token | 伺服器訊息、頻道、私訊、嵌入、反應 |
| QR 碼 | 文字訊息、媒體訊息、群組聊天 | |
| Telegram | Bot token | 文字訊息、群組、頻道、內聯鍵盤、檔案分享 |
| Signal | 本機應用 | 端對端加密訊息、群組聊天 |
| Microsoft Teams | OAuth | 團隊、頻道、聊天、自適應卡片、檔案分享 |
| Google Chat | OAuth | Spaces、私訊、卡片、對話串 |
| SMS | API 金鑰 | 通過支援的提供者進行外發和來電簡訊 |
| Email / Gmail | OAuth | 發送、接收、草稿、回覆、附件、標籤管理 |
| Matrix | Token | 聯邦訊息、聊天室、端對端加密 |
| Line | Token | 文字訊息、貼圖、群組聊天、豐富選單 |
| Zalo | Token | 文字訊息、媒體分享 |
| IRC | 配置 | 伺服器連接、頻道、私訊 |
| iMessage | 本機 | macOS 原生訊息（需要 macOS 主機） |
連接頻道
連接過程因頻道的認證方式而異。
OAuth 流程
使用於：Slack、Microsoft Teams、Google Chat、Email / Gmail
- 開啟代理程式的頻道標籤。
- 點擊要添加的頻道旁邊的連接。
- 您將被重新導向到服務的授權頁面。
- 使用您的帳戶登入並授予 Neotask 請求的權限。
- 授權後，您將被重新導向回儀表板，頻道顯示為已連接。
對於行動平台，提供 QR 碼選項。從手機掃描 QR 碼即可完成授權，無需在桌面瀏覽器上登入。
Bot Token
使用於：Discord、Telegram
- 在相應平台上建立 Bot：
- Discord -- 在 Discord Developer Portal 建立應用程式並生成 Bot Token。
- Telegram -- 在 Telegram 上向 @BotFather 發送訊息以建立 Bot 並接收 Token。
- 開啟代理程式的頻道標籤，點擊頻道旁邊的連接。
- 將 Bot Token 貼到 Token 欄位中。
- 點擊儲存以建立連接。
QR 碼
使用於：WhatsApp
- 開啟代理程式的頻道標籤，點擊 WhatsApp 旁邊的連接。
- 螢幕上會顯示 QR 碼。
- 在手機上開啟 WhatsApp，前往已連結的裝置，掃描 QR 碼。
- 手機確認連結後連接即建立。
API 金鑰
使用於：SMS
- 從您的 SMS 提供者（例如 Twilio、Vonage）獲取 API 金鑰。
- 開啟代理程式的頻道標籤，點擊 SMS 旁邊的連接。
- 輸入您的 API 金鑰和任何其他必要欄位（例如電話號碼、帳戶 SID）。
- 點擊儲存以啟用頻道。
Token
使用於：Matrix、Line、Zalo
- 從相應平台的開發者設定或管理面板生成存取 Token。
- 開啟代理程式的頻道標籤，點擊頻道旁邊的連接。
- 將 Token 貼到 Token 欄位中。
- 點擊儲存以建立連接。
伺服器配置
使用於：IRC
- 開啟代理程式的頻道標籤，點擊 IRC 旁邊的連接。
- 輸入伺服器地址、連接埠、暱稱和（可選）密碼。
- 指定連接時要加入的頻道。
- 點擊儲存以連接。
本機應用程式
使用於：Signal、iMessage
- 確保主機上已安裝並運行所需的應用程式：
- Signal -- 必須安裝 Signal Desktop 並連結到您的 Signal 帳戶。
- iMessage -- 需要配置了 Messages.app 的 macOS 主機。
- 開啟代理程式的頻道標籤，點擊頻道旁邊的連接。
- Neotask 將偵測本機應用程式並建立連接。
- 如果未偵測到應用程式，系統會提示您安裝或配置它。
連接測試
連接任何頻道後，Neotask 自動運行延遲探測以驗證連接：
- 通過頻道的 API 發送和接收測試訊息。
- 測量並顯示往返延遲。
- 如果測試失敗，會顯示描述問題的錯誤訊息（例如無效 Token、過期的 OAuth 授權、無法到達的伺服器）。
您可以隨時從頻道設定中重新運行連接測試。
頻道操作
頻道連接後，您可以從代理程式的頻道標籤進行管理。
啟用/停用
在不中斷連接的情況下切換頻道的開關。停用時：
- 代理程式停止在該頻道上監聽訊息。
- 不通過該頻道發送外發訊息。
- 連接憑證被保留，您可以隨時重新啟用而無需重新配置。
測試連接性
運行按需連接性測試以驗證頻道是否可到達和回應。測試：
- 向頻道的服務發送輕量級 API 請求。
- 以毫秒為單位測量往返延遲。
- 將結果報告為已連接（含延遲）或失敗（含錯誤詳情）。
查看延遲
每個已連接的頻道在頻道標籤上顯示其最近的延遲讀數。這有助於您一目了然地識別緩慢或降級的連接。延遲更新：
- 每次連接測試後自動更新。
- 頻道活動時在背景定期更新。
中斷連接/登出
要完全移除頻道連接：
- 點擊頻道旁邊的中斷連接。
- 在對話框中確認操作。
- Neotask 撤銷或丟棄儲存的憑證（在支援的提供者端撤銷 OAuth Token）。
- 頻道從代理程式的活動頻道列表中移除。
中斷連接後要重新連接，請再次按照原始連接步驟操作。