频道
什么是频道？
频道是您的 Neotask 代理用于发送和接收消息的通信平台。通过连接频道，您赋予代理在该平台上监听传入消息并实时响应的能力。
关键概念：
- 按代理配置 -- 每个频道连接在代理级别配置。一个代理可以连接到 Slack，而另一个处理 Discord，或者单个代理可以同时连接到多个频道。
- 双向通信 -- 频道支持发送和接收消息。代理可以响应传入消息、发起出站消息，或两者兼有。
- 多账户 -- 您可以为同一频道类型连接多个账户（例如两个不同的 Slack 工作区或多个邮箱地址）。
支持的频道
| 频道 | 认证方式 | 功能 |
|---|---|---|
| Slack | OAuth | 完整消息、频道、线程、表情反应、文件上传 |
| Discord | Bot token | 服务器消息、频道、私信、嵌入、表情反应 |
| 二维码 | 文本消息、媒体消息、群聊 | |
| Telegram | Bot token | 文本消息、群组、频道、内联键盘、文件分享 |
| Signal | 本地应用 | 端到端加密消息、群聊 |
| Microsoft Teams | OAuth | Teams、频道、聊天、自适应卡片、文件分享 |
| Google Chat | OAuth | Spaces、直接消息、卡片、线程对话 |
| SMS | API key | 通过支持的提供商发送和接收短信 |
| Email / Gmail | OAuth | 发送、接收、草稿、回复、附件、标签管理 |
| Matrix | Token | 联邦消息、房间、端到端加密 |
| Line | Token | 文本消息、贴纸、群聊、富菜单 |
| Zalo | Token | 文本消息、媒体分享 |
| IRC | 配置 | 服务器连接、频道、私信 |
| iMessage | 本地 | macOS 原生消息（需要 macOS 主机） |
连接频道
连接过程因频道的认证方式而异。
OAuth 流程
使用：Slack、Microsoft Teams、Google Chat、Email / Gmail
- 打开代理的频道选项卡。
- 点击要添加的频道旁边的连接。
- 您将被重定向到服务的授权页面。
- 使用您的账户登录并授予 Neotask 请求的权限。
- 授权后，您被重定向回控制面板，频道显示为已连接。
对于移动平台，提供二维码选项。从手机扫描二维码即可完成授权，无需在桌面浏览器上登录。
Bot Token
使用：Discord、Telegram
- 在相应平台上创建 bot：
- Discord -- 在 Discord Developer Portal 创建应用并生成 bot token。
- Telegram -- 在 Telegram 上向 @BotFather 发消息以创建 bot 并获取 token。
- 打开代理的频道选项卡，点击频道旁边的连接。
- 将 bot token 粘贴到 token 字段中。
- 点击保存以建立连接。
二维码
使用：WhatsApp
- 打开代理的频道选项卡，点击 WhatsApp 旁边的连接。
- 屏幕上会显示一个二维码。
- 在手机上打开 WhatsApp，前往已链接设备，扫描二维码。
- 手机确认链接后连接即建立。
API Key
使用：SMS
- 从您的 SMS 提供商（例如 Twilio、Vonage）获取 API key。
- 打开代理的频道选项卡，点击 SMS 旁边的连接。
- 输入您的 API key 和其他必填字段（例如电话号码、账户 SID）。
- 点击保存以激活频道。
Token
使用：Matrix、Line、Zalo
- 从相应平台的开发者设置或管理面板生成访问令牌。
- 打开代理的频道选项卡，点击频道旁边的连接。
- 将令牌粘贴到 token 字段中。
- 点击保存以建立连接。
服务器配置
使用：IRC
- 打开代理的频道选项卡，点击 IRC 旁边的连接。
- 输入服务器地址、端口、昵称和（可选）密码。
- 指定连接时要加入的频道。
- 点击保存以连接。
本地应用
使用：Signal、iMessage
- 确保所需应用已安装并在主机上运行：
- Signal -- Signal Desktop 必须已安装并链接到您的 Signal 账户。
- iMessage -- 需要配置了 Messages.app 的 macOS 主机。
- 打开代理的频道选项卡，点击频道旁边的连接。
- Neotask 将检测本地应用并建立连接。
- 如果未检测到应用，系统会提示您安装或配置它。
连接测试
连接任何频道后，Neotask 自动运行延迟探测来验证连接：
- 通过频道的 API 发送和接收测试消息。
- 测量并显示往返延迟。
- 如果测试失败，错误消息描述问题（例如无效 token、过期的 OAuth 授权、无法访问的服务器）。
您可以随时从频道设置中重新运行连接测试。
频道操作
频道连接后，您可以从代理的频道选项卡进行管理。
启用/禁用
在不断开连接的情况下开关频道。禁用后：
- 代理停止在该频道上监听消息。
- 不通过它发送出站消息。
- 连接凭据保持不变，您可以随时重新启用而无需重新配置。
测试连通性
运行按需连通性测试以验证频道是否可达和响应。测试：
- 向频道服务发送轻量级 API 请求。
- 测量以毫秒为单位的往返延迟。
- 将结果报告为已连接（带延迟）或失败（带错误详情）。
查看延迟
每个已连接的频道在频道选项卡上显示其最近的延迟读数。这有助于您一目了然地识别慢速或降级的连接。延迟更新：
- 每次连接测试后自动更新。
- 频道活跃时在后台定期更新。
断开/注销
要完全移除频道连接：
- 点击频道旁边的断开。
- 在对话框中确认操作。
- Neotask 撤销或丢弃存储的凭据（如果提供商支持，OAuth 令牌在提供商端撤销）。
- 频道从代理的活跃频道列表中移除。
断开后要重新连接，请重新按照原始连接步骤操作。