渠道部署指南

将AI员工连接到Telegram或飞书的详细指南。

支持的渠道（Channels）

渠道	状态	适合场景
Telegram	已支持	海外用户首选，个人使用便捷
飞书	已支持	国内团队首选，企业协作场景
Lark	已支持	海外团队首选，企业协作场景
企业微信	已支持	国内企业用户首选
钉钉	已支持	国内团队协作，无需公网回调
WhatsApp	即将支持	海外商务用户
Discord	即将支持	开发者/社区场景
Slack	已支持	欧美企业用户

提示： 你可以同时连接多个渠道，AI员工会在所有已连接的渠道中响应你的消息。Pro套餐支持 Telegram + Lark 双渠道同时接入。

部署前准备

项目	说明
COCO账号	已注册并完成付费/试用
渠道账号	你要连接的平台（Telegram/Lark）账号
约10分钟	完成部署所需时间

你不需要准备的：

不需要服务器或技术环境
不需要编写任何代码
不需要API密钥或开发者账号
不需要懂任何技术

选项A：Telegram 部署（推荐海外用户）

预计耗时：5-8分钟

第1步：创建Telegram Bot

打开 Telegram，搜索 @BotFather（Telegram官方机器人管理器）
发送 /newbot 命令
按提示输入你的Bot名称（显示名），例如：My COCO AI
输入Bot用户名（必须以bot结尾），例如：my_coco_ai_bot
BotFather会返回一个 Bot Token（格式类似：110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw）
复制并保存这个Token，下一步需要用到

重要： Bot Token是你机器人的唯一凭证，请勿泄露给他人。

第2步：配置Bot设置（可选但推荐）

继续在 @BotFather 中操作：

发送 /setdescription → 选择你的Bot → 输入描述（用户看到Bot时显示的介绍）
- 建议：COCO AI数字员工 - 你的专属AI助手
发送 /setuserpic → 选择你的Bot → 上传头像
- 建议使用COCO logo或你公司logo

第3步：在COCO Dashboard绑定

登录 COCO Dashboard
进入渠道配置页面，选择 Telegram
粘贴上一步获取的 Bot Token
点击 验证并连接
系统会自动验证Token有效性并完成连接

第4步：开始使用

在Telegram中搜索你创建的Bot用户名（如 @my_coco_ai_bot）
点击 Start 或发送 /start
发送任意消息，AI员工会立即响应
部署完成！

提示： Telegram部署最简单，无需管理员权限，无需额外配置，推荐首次用户优先选择。

Telegram常见问题

问题	解决方案
Bot不回复	检查Token是否正确，在Dashboard查看连接状态
回复很慢	检查网络连接，Telegram需要稳定的网络
想让多人使用	将Bot添加到Telegram群组即可，群内成员都可以与AI对话
想更换Bot	在Dashboard断开旧连接，创建新Bot后重新绑定

选项B：Lark / 飞书部署

预计耗时：8-15分钟

注意： 在 Lark/飞书中添加自建应用（Bot）需要企业管理员审批。如果你暂时不想接入企业的 Bot，可以先开通一个飞书个人版（国内）或 Lark 个人版（海外）账号，在个人工作区中创建和使用 Bot，无需管理员审批。

Lark（海外版）和飞书（国内版）的操作流程略有不同，请根据你的使用场景选择对应的指南：

飞书部署（推荐国内团队）

WebSocket 长连接（推荐）： 最简配置，只需 App ID 和 App Secret，无需配置 Webhook URL 和校验。

Webhook 传统方式： 飞书将事件推送到 Webhook URL，需要填写 Verification Token。

第1步：进入飞书开放平台

访问飞书开放平台
使用你的飞书账号登录
点击右上角 开发者后台 进入管理页面

第2步：创建企业自建应用

在开发者后台，点击 创建企业自建应用

填写应用名称（如 COCO AI员工）和描述，选择应用图标

点击创建完成

提示： 需要企业管理员权限创建应用。如果你不是管理员，请联系你的IT部门协助。或者先使用飞书个人版账号体验。

第3步：添加机器人能力

在应用管理页面，进入左侧 添加应用能力，找到 机器人 卡片，点击「配置」或「+ 添加」。添加完成后，左侧会出现 机器人 菜单项，同时可以在 权限管理 中配置相关权限：

重要： 必须先添加机器人能力，然后才能配置消息相关的权限（如 im:message.group_at_msg:readonly）。否则权限页面会提示「请在开启 bot 能力后，再申请开通此权限」，该权限的勾选框将无法选中：

未添加机器人能力时，im:message.group_at_msg:readonly 权限无法勾选

添加完成后，进入左侧 凭证与基础信息 页面，记录以下信息：

App ID
App Secret

第4步：配置应用权限

添加机器人能力后，进入左侧 权限管理。你可以点击 开通权限 逐个选择需要的权限，也可以点击 批量导入/导出权限 粘贴我们准备好的 JSON 一键导入：

复制以下 JSON，批量导入所有权限：

json

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "im:app_feed_card:write",
      "im:chat",
      "im:chat.announcement:read",
      "im:chat.announcement:write_only",
      "im:chat.chat_pins:read",
      "im:chat.chat_pins:write_only",
      "im:chat.collab_plugins:read",
      "im:chat.collab_plugins:write_only",
      "im:chat.managers:write_only",
      "im:chat.members:bot_access",
      "im:chat.members:read",
      "im:chat.members:write_only",
      "im:chat.menu_tree:read",
      "im:chat.menu_tree:write_only",
      "im:chat.moderation:read",
      "im:chat.tabs:read",
      "im:chat.tabs:write_only",
      "im:chat.top_notice:write_only",
      "im:chat.widgets:read",
      "im:chat.widgets:write_only",
      "im:chat:create",
      "im:chat:delete",
      "im:chat:moderation:write_only",
      "im:chat:operate_as_owner",
      "im:chat:read",
      "im:chat:readonly",
      "im:chat:update",
      "im:datasync.feed_card.time_sensitive:write",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message.urgent",
      "im:message.urgent:phone",
      "im:message.urgent:sms",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_depts",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "im:url_preview.update",
      "im:user_agent:read"
    ],
    "user": []
  }
}

飞书 vs Lark 权限差异： 飞书（国内版）的权限集与 Lark（海外版）略有不同。两个权限 — im:chat.labels 和 im:message.group_msg:readonly — 在飞书国内版平台不受支持，已从上方 JSON 中移除。其余权限完全相同。关键权限 im:message.group_at_msg:readonly 用于接收群组 @消息，缺少此权限会导致机器人在群聊中无法响应。

部分权限开通后会弹出「可访问的数据范围」配置窗口，选择默认配置并点击确认即可：

第5步：获取 Verification Token（仅 Webhook 模式需要）

WebSocket 用户可跳过此步。 如果你在 COCO Dashboard 选择 WebSocket 长连接模式，只需填写 App ID 和 App Secret，无需 Verification Token 和 Encrypt Key。

在应用管理页面，进入左侧 事件与回调
点击 加密策略 标签
在页面底部找到 Verification Token，点击眼睛图标查看并复制

事件与回调 → 加密策略 — 在页面底部找到 Verification Token

提示： 同一页面还有 Encrypt Key（可选），如果你需要加密通信，也请一并记录。

第6步：在 COCO Dashboard 填写凭证并部署

登录 COCO Dashboard
进入渠道配置页面，选择飞书
选择连接方式：WebSocket 长连接（推荐）或 Webhook
在「应用凭证」区域填入以下信息：

WebSocket 长连接（推荐） — 只需填写：

字段	来源
App ID	飞书开放平台 → 凭证与基础信息
App Secret	飞书开放平台 → 凭证与基础信息

COCO Dashboard — 飞书 WebSocket 长连接模式，只需填写 App ID 和 App Secret

Webhook 传统方式 — 需要填写：

字段	来源
App ID	飞书开放平台 → 凭证与基础信息
App Secret	飞书开放平台 → 凭证与基础信息
Verification Token	飞书开放平台 → 事件与回调 → 加密策略
Encrypt Key（可选）	飞书开放平台 → 事件与回调 → 加密策略

COCO Dashboard — 填写应用凭证（App ID、App Secret、Verification Token、Encrypt Key）后点击连接

点击连接，系统将自动部署你的 AI 员工（通常需要 2-3 分钟）
部署完成后，页面会显示你的专属 Webhook URL（Webhook 模式下一步需要用到）

COCO Dashboard 部署完成 — 复制 Webhook URL 用于飞书事件订阅配置

第7步：配置事件订阅

Webhook 和 WebSocket 模式都需要此步。 两种模式都需要订阅事件，区别在于：Webhook 模式需要填写请求地址（Webhook URL），WebSocket 模式无需填写请求地址，事件通过长连接自动接收。

回到飞书开发者后台，进入左侧 事件与回调
在「事件配置」标签下，选择订阅方式：
- Webhook 模式： 选择 将事件发送至开发者服务器，在 请求地址 中粘贴上一步从 COCO Dashboard 获取的 Webhook URL
- WebSocket 模式： 选择 使用长连接接收事件（如已在前面步骤中配置，此处确认即可）

点击下方 添加事件，订阅以下事件：
- im.message.receive_v1 — 接收消息（必需）
- im.chat.member.bot.added_v1 — Bot被加入群组（可选）
点击保存

第8步：创建版本并发布

在飞书开发者后台，进入左侧 版本管理与发布
点击 创建版本
填写版本号（如 1.0.0）和更新说明
确认应用能力和权限信息无误，点击保存
在弹出的确认窗口中，点击 确认发布

管理员审批： 飞书自建应用发布后，需要企业管理员在 飞书管理后台 中审批通过后，应用才能正式使用。如果你是个人版账号，则无需此步骤。

配置完成后，可以在飞书客户端搜索你的应用名称，确认机器人已正确创建：

第9步：启用机器人并添加到群组

首先，在飞书开放平台确认应用状态已从「待上线」变为「已开启」：

在飞书开放平台，进入 机器人 菜单，确认机器人功能已开启
打开飞书客户端
创建或进入一个群组
点击右上角 ... 菜单 → Settings（设置）

在设置中找到 Bots（机器人）选项，点击进入（也可以直接点击群组顶部的小机器人图标快速打开）

点击 Add Bot（添加机器人） → 搜索你的应用名称 → 点击添加

添加成功后，你的机器人会出现在 Bots 列表中

在群中 @你的机器人发送消息
AI员工响应 → 部署完成！

也可以私聊使用： 在飞书中搜索你的应用名，直接发起私聊对话。

Lark 部署（推荐海外团队）

第1步：进入 Lark 开放平台

访问 Lark Open Platform
使用你的 Lark 账号登录
点击 创建应用 进入应用创建流程

提示： Lark 是飞书的海外版本，界面为英文。功能与飞书基本一致，但平台地址和部分操作名称不同。

第2步：创建应用

在开发者后台，点击 创建企业自建应用

填写应用名称（如 COCO AI Employee）和描述，选择应用图标

点击创建完成
创建成功后，可以在工作台看到你的应用

提示： 需要 Lark 企业管理员权限。如果你不是管理员，请联系你的 IT 部门协助。或者先使用 Lark 个人版账号体验。

第3步：添加机器人能力并记录凭证

进入应用，在左侧 添加应用能力 中，找到 机器人 卡片，点击「配置」。添加完成后，左侧会出现 机器人 菜单项。

在左侧 凭证与基础信息 页面，记录以下信息：
- App ID
- App Secret

记录好后，将 App ID 和 App Secret 填入 COCO Dashboard 的对应位置：

COCO Dashboard — App ID 和 App Secret 填写位置

重要： 必须先添加机器人能力，然后才能配置消息相关的权限。

第4步：获取 Verification Token 并在 COCO Dashboard 填写凭证

在应用管理页面，进入左侧 事件与回调
点击 加密策略 标签
找到 Verification Token，点击眼睛图标查看并复制

提示： 同一页面还有 Encrypt Key（可选），如果你需要加密通信，也请一并记录。

登录 COCO Dashboard，进入渠道配置页面，选择 Lark
在「应用凭证」区域填入以下信息：

字段	来源
App ID	Lark Open Platform → Credentials & Basic Info
App Secret	Lark Open Platform → Credentials & Basic Info
Verification Token	Lark Open Platform → Events & Callbacks → Encryption Strategy
Encrypt Key（可选）	Lark Open Platform → Events & Callbacks → Encryption Strategy

COCO Dashboard — 填写应用凭证，Verification Token 填写位置

点击连接，系统将自动部署你的 AI 员工（通常需要 2-3 分钟）
部署完成后，页面会显示你的专属 Webhook URL，复制此 URL（在后面的步骤需要用到）

第5步：配置应用权限

在等待部署的过程中可以配置应用权限。在应用管理页面，进入左侧 权限管理。你可以点击 开通权限 逐个选择需要的权限，也可以点击 批量导入/导出权限 粘贴我们准备好的 JSON 一键导入：

复制以下 JSON，批量导入所有权限：

json

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "im:app_feed_card:write",
      "im:chat",
      "im:chat.announcement:read",
      "im:chat.announcement:write_only",
      "im:chat.chat_pins:read",
      "im:chat.chat_pins:write_only",
      "im:chat.collab_plugins:read",
      "im:chat.collab_plugins:write_only",
      "im:chat.labels",
      "im:chat.managers:write_only",
      "im:chat.members:bot_access",
      "im:chat.members:read",
      "im:chat.members:write_only",
      "im:chat.menu_tree:read",
      "im:chat.menu_tree:write_only",
      "im:chat.moderation:read",
      "im:chat.tabs:read",
      "im:chat.tabs:write_only",
      "im:chat.top_notice:write_only",
      "im:chat.widgets:read",
      "im:chat.widgets:write_only",
      "im:chat:create",
      "im:chat:delete",
      "im:chat:moderation:write_only",
      "im:chat:operate_as_owner",
      "im:chat:read",
      "im:chat:readonly",
      "im:chat:update",
      "im:datasync.feed_card.time_sensitive:write",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.group_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message.urgent",
      "im:message.urgent:phone",
      "im:message.urgent:sms",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_depts",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "im:url_preview.update",
      "im:user_agent:read"
    ],
    "user": []
  }
}

权限说明： 以上权限涵盖通讯录（只读）、群管理（完整）、消息（收发/撤回/pin/reaction）、群组 @消息监听、紧急消息、文件资源和 Feed 卡片。im:message:send_multi_depts 是旧版 im:message:send_multi_users 的新名称。飞书（国内版）使用的权限集略有不同，详见飞书部署。

第6步：配置事件订阅

回到 Lark 开发者后台，进入左侧 事件与回调
在「事件配置」标签下，选择订阅方式为 将事件发送至开发者服务器
在 请求地址 中粘贴上一步从 COCO Dashboard 获取的 Webhook URL

订阅以下事件：
- im.message.receive_v1 — 接收消息（必需）
- im.chat.member.bot.added_v1 — Bot被加入群组（可选）
点击保存

第7步：创建版本并发布

进入左侧 版本管理与发布，点击 创建版本
填写版本号（如 1.0.0）和更新说明
确认应用能力和权限信息无误，点击保存
在弹出的确认窗口中，点击 确认发布

管理员审批： 提交后需要企业管理员审批。个人版账号无需此步骤。

第8步：启用机器人并添加到群组

在 Lark Open Platform，进入 Bot 菜单，确认 Bot 功能已开启
打开 Lark 客户端
创建或进入一个群组
Group Settings → Bots → Add Bot → 搜索你的应用名称
确认添加
在群中 @你的 Bot 发送消息
AI员工响应 → 部署完成！

也可以私聊使用： 在 Lark 中搜索你的应用名，直接发起私聊对话。

选项C：企业微信部署

预计耗时：10-15分钟

注意： 企业微信是腾讯旗下的企业通讯平台，广泛应用于中国企业。创建自建应用需要企业管理员权限登录企业微信管理后台。

需要配置以下 5 项凭证：

配置项	说明
企业ID（CorpID）	企业唯一标识
应用Secret	应用凭证密钥
AgentId	应用ID
Token	回调验证 Token
EncodingAESKey	回调消息加密密钥（43位）

第1步：获取企业ID（CorpID）

访问企业微信管理后台我的企业页面，在页面底部找到 企业ID，复制并保存。

第2步：进入应用管理，创建应用

在左侧菜单进入 应用管理，页面下方「自建」区域点击 创建应用。

第3步：设置应用名称和可见范围

给 Bot 起一个好记的名字（如 COCO AI员工），选择该应用对企业成员的 可见范围（决定哪些成员可以看到并使用这个 Bot）。

第4步：获取 AgentId 和 Secret，设置 API 接收

应用创建成功后，在应用详情页获取：

AgentId — 页面上直接显示
Secret — 点击「查看」获取

然后在页面下方「功能」区域，点击 接收消息 → 设置API接收。

重要： Secret 只显示一次，请立即保存。

第5步：获取 Token 和 EncodingAESKey（暂不保存，保留页面）

在「API接收消息」配置页面：

Token — 点击「随机获取」生成
EncodingAESKey — 点击「随机获取」生成

注意： 此步骤暂不保存，URL 需要在第7步填写。请保留此页面不要关闭。

第6步：在 Dashboard 中填写凭证并连接

在 COCO Dashboard 的企业微信渠道配置页面中，填写前面获取的所有凭证信息，记录页面上显示的 Webhook URL 和 服务器 IP，然后点击连接等待连接成功。

第7步：回填 Webhook URL 到企业微信

连接成功后，将 Dashboard 显示的 Webhook URL 复制并填写到第5步保留的「接收消息服务器配置」页面的 URL 输入框中，点击保存。

第8步：配置企业可信 IP

将 Dashboard 显示的 服务器 IP 配置到企业微信的 企业可信 IP 中，确保服务器可以正常调用企业微信 API。

第9步：开始聊天

配置成功后：

在企业微信中搜索 Bot 名称，开启对话
发送任意消息，AI员工会立即响应
也可以将应用添加到企业微信群组，让整个团队都能使用
部署完成！

群组使用： 在企业微信群聊中，@你的应用即可与AI员工互动，群内所有可见范围内的成员都可以使用。

企业微信常见问题

问题	解决方案
无法保存 API 配置	确保先在 Dashboard 完成连接（第6步），企业微信在保存时会验证 URL 有效性
应用对部分成员不可见	检查应用管理中的可见范围设置，确保所有使用者都已添加
群聊中机器人不响应	确认应用已添加至群组，且群成员在可见范围内
Secret 丢失或忘记	在应用管理中重新点击获取Secret — 原 Secret 立即失效，需重新配置

选项D：钉钉部署

预计耗时：8-12分钟

注意： 钉钉是阿里旗下的企业协作平台，广泛应用于中国企业。钉钉使用 Stream 模式（WebSocket 长连接），无需配置公网回调地址，部署更简单。

需要配置以下 3 项凭证：

配置项	说明
AppKey	应用唯一标识
AppSecret	应用凭证密钥
RobotCode	机器人编码（通常与 AppKey 相同）

第1步：访问钉钉开放平台，创建应用

访问钉钉开放平台应用管理页面，点击 创建应用。

第2步：输入应用名称和描述

输入 应用名称（如 COCO AI员工）和 应用描述，点击保存。

第3步：添加机器人能力

保存后自动跳转到「添加应用能力」页面，点击 添加机器人 能力。

第4步：配置机器人，选择 Stream 模式

打开机器人配置页面，填写必要的信息，消息接收模式 选择 Stream 模式，然后发布。

注意： Stream 模式通过 WebSocket 长连接接收消息，无需配置公网回调地址，部署更简单。

第5步：版本管理与发布

在左侧菜单选择 版本管理与发布，点击 创建新版本。

第6步：设置应用可见范围

填写版本信息，选择合适的 应用可见范围（决定哪些成员可以看到并使用这个 Bot），然后保存发布。

第7步：获取 AppKey、AppSecret、RobotCode

在应用详情页的「凭证与基础信息」中获取：

AppKey — 应用唯一标识
AppSecret — 点击「显示」查看

在机器人配置页面获取 RobotCode（通常与 AppKey 相同）。

第8步：填写凭证到 Dashboard

将获取到的 AppKey、AppSecret、RobotCode 正确填写到 COCO Dashboard 的钉钉渠道配置页面中，点击连接即可。

第9步：开始聊天

在钉钉中搜索对应的 Bot 名称，开始和 AI 机器人聊天。

群组使用： 在钉钉群聊中，@你的 Bot 即可与 AI 员工互动。

钉钉常见问题

问题	解决方案
应用对部分成员不可见	检查版本发布时的可见范围设置，确保所有使用者都已添加
群聊中机器人不响应	确认机器人已添加至群组，且使用 @mention 方式触发
AppSecret 忘记	在应用凭证页面重新查看或重置

选项E：Slack 部署

预计耗时：8-12分钟

说明： Slack 是欧美企业广泛使用的团队协作平台。Slack 使用 Socket Mode（WebSocket 连接），无需配置公网回调地址，部署简便。

对接 Slack 需要 2 个配置项：

配置项	格式	说明
Bot Token	`xoxb-...`	Bot User OAuth Token，用于调用 Slack API
App Token	`xapp-...`	App-Level Token，用于 Socket Mode 连接

第1步：创建 Slack App

访问 Slack App 管理页面并登录
点击页面右上角的 Create New App
在弹出窗口中选择 From scratch（从零创建）
输入 App 名称（如 COCO AI Employee），选择要安装到的 Workspace
点击 Create App 完成创建

第2步：开启 Socket Mode 并生成 App Token

在 App 配置页面左侧导航栏，找到 Socket Mode
点击开启 Enable Socket Mode
开启后系统会提示生成 App-Level Token：
- 为 Token 起一个名称（如 zylos-socket）
- 添加 Scope：搜索并勾选 connections:write
- 点击 Generate 生成 Token
复制并保存该 Token（格式为 xapp-...）

注意： 此 Token 生成后仅显示一次，请立即复制保存。如果丢失需要重新生成。

第3步：配置 Bot Token 权限 (Scopes)

左侧导航栏找到 OAuth & Permissions
下拉至 Scopes 模块
在 Bot Token Scopes 下点击 Add an OAuth Scope，逐一添加以下权限：

权限	说明
`app_mentions:read`	读取 Bot 被 @mention 的消息
`channels:history`	读取公共频道消息
`channels:read`	查看频道基本信息
`chat:write`	以 Bot 身份发送消息
`files:read`	读取分享的文件
`files:write`	上传文件
`groups:history`	读取私有频道消息
`groups:read`	查看私有频道基本信息
`im:history`	读取私聊消息记录
`im:read`	查看私聊基本信息
`im:write`	发起私聊对话
`reactions:read`	读取表情回复
`reactions:write`	添加表情回复
`users:read`	查看用户信息

第4步：安装 App 到 Workspace

回到 OAuth & Permissions 页面顶部
点击 Install to Workspace（或 Reinstall to Workspace）
在弹出的授权窗口中确认权限，点击 Allow 完成安装
安装成功后，复制并保存 Bot User OAuth Token（格式为 xoxb-...）

注意： 每次修改 Scopes 后都需要重新安装 App 到 Workspace，Token 会重新生成。请及时更新配置。

第5步：开启事件订阅 (Event Subscriptions)

左侧导航栏找到 Event Subscriptions
点击开启 Enable Events
展开 Subscribe to bot events，点击 Add Bot User Event，添加以下事件：

事件	说明
`message.im`	接收私聊消息
`message.channels`	接收公共频道消息
`message.groups`	接收私有频道消息
`app_mention`	接收 @mention 消息

添加完成后，点击页面底部 Save Changes 保存

第6步：开启 App Home（允许私信）

左侧导航栏找到 App Home
在 Show Tabs 区域：
- 勾选 Messages Tab
- 勾选下方的 Allow users to send Slash commands and messages from the messages tab
这样用户才能在 Slack 中直接给 Bot 发送私信

第7步：在 COCO Channel 中配置 Token

返回 COCO Dashboard，进入对应 Channel 的配置页面
填入以下两个 Token：
- Bot Token（xoxb-...）：来自 Slack App 的 OAuth & Permissions 页面
- App Token（xapp-...）：第2步中生成的 Token
保存配置

第8步：开始聊天

在 Slack 中搜索 Bot 名称或在 Apps 列表中找到它
点击即可开始私聊对话，AI 员工即时响应
如需在频道中使用，先将 Bot 邀请到目标频道（在频道中输入 /invite @BotName）
通过 @BotName 提及即可触发回复
部署完成！

提示： Slack Bot 支持私聊和频道 @mention 两种方式，可同时在多个频道使用。

Slack 常见问题

问题	解决方案
Bot 不响应	检查 Dashboard 中的 Bot Token 和 App Token 是否正确
Slack 中看不到 Bot	确认 App 已安装到 Workspace（第4步）且 App Home 已配置（第6步）
频道中 Bot 不响应	Bot 需先被邀请到频道，使用 `/invite @BotName`
修改权限后 Token 失效	每次修改 Scopes 后需重新安装 App，然后更新 Dashboard 中的 Token
无法给 Bot 发私信	确认 App Home 中已开启 Messages Tab

渠道部署指南 ​

支持的渠道（Channels） ​

部署前准备 ​

选项A：Telegram 部署（推荐海外用户） ​

第1步：创建Telegram Bot ​

第2步：配置Bot设置（可选但推荐） ​

第3步：在COCO Dashboard绑定 ​

第4步：开始使用 ​

Telegram常见问题 ​

选项B：Lark / 飞书部署 ​

飞书部署（推荐国内团队） ​

第1步：进入飞书开放平台 ​

第2步：创建企业自建应用 ​

第3步：添加机器人能力 ​

第4步：配置应用权限 ​

第5步：获取 Verification Token（仅 Webhook 模式需要） ​

第6步：在 COCO Dashboard 填写凭证并部署 ​

第7步：配置事件订阅 ​

第8步：创建版本并发布 ​

第9步：启用机器人并添加到群组 ​

Lark 部署（推荐海外团队） ​

第1步：进入 Lark 开放平台 ​

第2步：创建应用 ​

第3步：添加机器人能力并记录凭证 ​

第4步：获取 Verification Token 并在 COCO Dashboard 填写凭证 ​

第5步：配置应用权限 ​

第6步：配置事件订阅 ​

第7步：创建版本并发布 ​

第8步：启用机器人并添加到群组 ​

选项C：企业微信部署 ​

第1步：获取企业ID（CorpID） ​

第2步：进入应用管理，创建应用 ​

第3步：设置应用名称和可见范围 ​

第4步：获取 AgentId 和 Secret，设置 API 接收 ​

第5步：获取 Token 和 EncodingAESKey（暂不保存，保留页面） ​

第6步：在 Dashboard 中填写凭证并连接 ​

第7步：回填 Webhook URL 到企业微信 ​

第8步：配置企业可信 IP ​

第9步：开始聊天 ​

企业微信常见问题 ​

选项D：钉钉部署 ​

第1步：访问钉钉开放平台，创建应用 ​

第2步：输入应用名称和描述 ​

第3步：添加机器人能力 ​

第4步：配置机器人，选择 Stream 模式 ​

第5步：版本管理与发布 ​

第6步：设置应用可见范围 ​

第7步：获取 AppKey、AppSecret、RobotCode ​

第8步：填写凭证到 Dashboard ​

第9步：开始聊天 ​

钉钉常见问题 ​

选项E：Slack 部署 ​

第1步：创建 Slack App ​

第2步：开启 Socket Mode 并生成 App Token ​

第3步：配置 Bot Token 权限 (Scopes) ​

第4步：安装 App 到 Workspace ​

第5步：开启事件订阅 (Event Subscriptions) ​

第6步：开启 App Home（允许私信） ​

第7步：在 COCO Channel 中配置 Token ​

第8步：开始聊天 ​

Slack 常见问题 ​

渠道部署指南

支持的渠道（Channels）

部署前准备

选项A：Telegram 部署（推荐海外用户）

第1步：创建Telegram Bot

第2步：配置Bot设置（可选但推荐）

第3步：在COCO Dashboard绑定

第4步：开始使用

Telegram常见问题

选项B：Lark / 飞书部署

飞书部署（推荐国内团队）

第1步：进入飞书开放平台

第2步：创建企业自建应用

第3步：添加机器人能力

第4步：配置应用权限

第5步：获取 Verification Token（仅 Webhook 模式需要）

第6步：在 COCO Dashboard 填写凭证并部署

第7步：配置事件订阅

第8步：创建版本并发布

第9步：启用机器人并添加到群组

Lark 部署（推荐海外团队）

第1步：进入 Lark 开放平台

第2步：创建应用

第3步：添加机器人能力并记录凭证

第4步：获取 Verification Token 并在 COCO Dashboard 填写凭证

第5步：配置应用权限

第6步：配置事件订阅

第7步：创建版本并发布

第8步：启用机器人并添加到群组

选项C：企业微信部署

第1步：获取企业ID（CorpID）

第2步：进入应用管理，创建应用

第3步：设置应用名称和可见范围

第4步：获取 AgentId 和 Secret，设置 API 接收

第5步：获取 Token 和 EncodingAESKey（暂不保存，保留页面）

第6步：在 Dashboard 中填写凭证并连接

第7步：回填 Webhook URL 到企业微信

第8步：配置企业可信 IP

第9步：开始聊天

企业微信常见问题

选项D：钉钉部署

第1步：访问钉钉开放平台，创建应用

第2步：输入应用名称和描述

第3步：添加机器人能力

第4步：配置机器人，选择 Stream 模式

第5步：版本管理与发布

第6步：设置应用可见范围

第7步：获取 AppKey、AppSecret、RobotCode

第8步：填写凭证到 Dashboard

第9步：开始聊天

钉钉常见问题

选项E：Slack 部署

第1步：创建 Slack App

第2步：开启 Socket Mode 并生成 App Token

第3步：配置 Bot Token 权限 (Scopes)

第4步：安装 App 到 Workspace

第5步：开启事件订阅 (Event Subscriptions)

第6步：开启 App Home（允许私信）

第7步：在 COCO Channel 中配置 Token

第8步：开始聊天

Slack 常见问题