频道
什么是频道？
频道是 Neotask 代理用于发送和接收消息的通信平台。通过连接一个频道，您赋予代理在该平台上监听传入消息并实时响应的能力。
关键概念：
- 按代理配置 -- 每个频道连接都在代理级别配置。一个代理可以连接到 Slack，另一个处理 Discord，或者单个代理可以同时连接多个频道。
- 双向 -- 频道支持发送和接收消息。代理可以响应传入消息、发起出站消息，或两者兼顾。
- 多账户 -- 您可以为同一频道类型连接多个账户（例如，两个不同的 Slack 工作区或多个邮箱地址）。
支持的频道
| 频道 | 认证方式 | 功能 |
|---|---|---|
| Slack | OAuth | 完整消息、频道、线程、反应、文件上传 |
| Discord | Bot token | 服务器消息、频道、私信、嵌入、反应 |
| 二维码 | 文本消息、媒体消息、群聊 | |
| Telegram | Bot token | 文本消息、群组、频道、内联键盘、文件共享 |
| Signal | 本地应用 | 端到端加密消息、群聊 |
| Microsoft Teams | OAuth | 团队、频道、聊天、自适应卡片、文件共享 |
| Google Chat | OAuth | 空间、私信、卡片、线程对话 |
| 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
- 在相应平台上创建机器人：
- Discord -- 在 Discord Developer Portal 创建应用程序并生成 bot token。
- Telegram -- 在 Telegram 上给 @BotFather 发消息以创建机器人并接收 token。
- 打开代理的频道标签并点击频道旁边的连接。
- 将 bot token 粘贴到 token 字段中。
- 点击保存以建立连接。
二维码
适用于：WhatsApp
- 打开代理的频道标签并点击 WhatsApp 旁边的连接。
- 屏幕上将显示二维码。
- 在手机上打开 WhatsApp，前往关联设备，扫描二维码。
- 手机确认链接后连接即建立。
API Key
适用于：SMS
- 从您的 SMS 提供商（如 Twilio、Vonage）获取 API key。
- 打开代理的频道标签并点击 SMS 旁边的连接。
- 输入您的 API key 和任何其他必填字段（如电话号码、账户 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 在提供商侧被撤销）。
- 频道从代理的活跃频道列表中移除。
断开后要重新连接，请再次按照原始连接步骤操作。