接入指南
把 AI 智能体接到企业微信、钉钉和飞书
你的团队在哪个软件里工作,智能体就应该出现在哪里——而不是让人为了用它再开一个窗口。三个国内主流协作平台在 Olano 里都是内置渠道,区别在于各自的接入机制、需要的凭据,和群聊里该不该说话。
先说结论:企业微信、钉钉、飞书都是 Olano 的内置渠道,在控制台里通过带引导的表单添加,每个字段旁边有说明。三者的接入方式不同:企业微信通过智能机器人的回调接入,需要机器人 ID 和 Secret;钉钉用 Stream 模式,需要应用的 Client ID 和 Client Secret,不需要公网回调地址;飞书需要应用的 App ID、App Secret 和验证 Token,可以选长连接或 Webhook 两种模式。同一个智能体可以同时接三个渠道,每个人的对话历史彼此隔离。
本页涉及第三方平台的信息,均于 2026 年 9 月 26 日对照各厂商的公开文档核对。厂商的接口、模型名和条款变化很快,落地前请以其当前文档为准。本页描述的 Olano 功能以当前版本为准。
三个渠道,三种机制
| 企业微信 | 钉钉 | 飞书 | |
|---|---|---|---|
| 接入方式 | 智能机器人回调(加密) | Stream 模式,实时接收 | 长连接(WebSocket)或 Webhook |
| 需要的凭据 | Bot ID、Secret | Client ID、Client Secret | App ID、App Secret、验证 Token |
| 需要公网地址 | 需要(回调) | 不需要 | Webhook 模式需要,长连接不需要 |
| 私聊策略 | 开放 / 白名单 / 禁用 | 发送者白名单为硬门槛 | 按应用可见范围 |
| 群聊回应 | 开放 / 白名单 / 禁用 | 全部 / 仅被@ / 不回应 | 支持@触发与卡片交互 |
企业微信:智能机器人回调
Olano 走的是企业微信的智能机器人接入方式:在企业微信后台创建机器人,拿到 Bot ID 和 Secret,填进 Olano 的渠道表单。回调是加密的,Olano 负责解密和校验。
两个策略开关值得在上线前定好:私聊策略和群聊策略,各自可以选开放、白名单或禁用。刚上线时私聊白名单、群聊禁用是最稳的起点——先让几个同事用,再逐步放开。
钉钉:Stream 模式,不用公网地址
钉钉是三者里部署最省事的。Olano 用 Stream 模式主动连接钉钉接收消息,所以不需要暴露任何公网回调地址——对于内网部署或者不想配域名和证书的团队,这一点很实际。需要的只是钉钉应用的 Client ID 和 Client Secret。回复以 Markdown 格式发出。
群聊里有两个独立开关:回应范围(全部消息 / 仅被@时 / 不回应)和监听范围(关闭 / 全部 / 仅@)。区分这两个是有意的:一个智能体可以“听”群里所有消息来积累上下文,但只在被@时才开口。另外,钉钉的发送者白名单是硬门槛——名单上的人能进,其他人一律不响应,不是软过滤。
一个已知的平台限制:钉钉群机器人的 Webhook 方式可能只投递@消息,这是钉钉侧的行为,Stream 模式下不受此影响。
飞书:长连接或 Webhook,支持卡片
飞书需要应用的 App ID、App Secret 和验证 Token,其中验证 Token 是第二道校验,用来确认事件确实来自飞书。连接方式二选一:长连接不需要公网地址,Webhook 需要。
飞书的特点是消息卡片:智能体可以发出带按钮的卡片,用户点击后触发动作——比如“批准 / 拒绝”直接在飞书里完成审批。Olano 对卡片动作做了去重和限流,重复点击不会重复执行。
三者共同的部分,也是真正重要的部分
- 每个人的历史彼此隔离。同一个机器人服务全公司,A 的对话、偏好、待办不会出现在 B 的回复里。这是渠道层面强制的,不是提示词里的一句话。
- 审批边界一视同仁。不管消息从哪个渠道进来,涉及发送、支付、发布、删除的动作都要过审批——智能体在群里被人@一句“把这封邮件发出去”,不等于它就发了。
- 每一次动作都有记录。做了什么、在哪个渠道、谁触发的。这是事后能说清楚的前提,也是合规里反复出现的要求。
- 渠道和模型无关。接哪个渠道跟用哪个模型是两个独立的选择,可以用通义千问,也可以用别的。
该接哪一个
答案通常不在功能对比表里,而在你的团队和客户已经在哪。内部协作用什么就接什么;三个都用的公司也不少,那就三个都接——一个智能体、三个入口、一份记忆。
如果对象是外部客户而不是内部团队,问题就变成了微信客服,判断标准不一样,见微信与 WhatsApp 上的 AI 客服怎么做。如果团队一半在国内、一半在海外,同一个部署可以同时接企业微信和 WhatsApp,见出海东南亚。
上线前的三个决定
- 先白名单,再放开。三个渠道都支持某种形式的名单控制,用它。
- 群里默认只在被@时说话。一个在群里主动接话的机器人,是被人拉出群的最快方式。
- 指定一个人每周看一次记录。没有这个人,三个月后它会悄悄变得不可靠,而且没人知道。
延伸阅读
常见问题
Olano 支持企业微信、钉钉和飞书吗?
三个都是内置渠道,在控制台里通过带引导的表单添加。企业微信通过智能机器人回调接入,需要 Bot ID 和 Secret;钉钉用 Stream 模式,需要 Client ID 和 Client Secret;飞书需要 App ID、App Secret 和验证 Token,可选长连接或 Webhook。
接钉钉需要公网服务器吗?
不需要。Olano 用钉钉的 Stream 模式主动连接接收消息,不用暴露回调地址,也不用配域名和证书。这让钉钉成为三者里部署最省事的一个。
智能体在群里会不会乱说话?
由你控制。钉钉有独立的回应范围(全部 / 仅被@ / 不回应)和监听范围(关闭 / 全部 / 仅@)开关,可以让它听全部消息但只在被@时开口;企业微信的群聊策略可选开放、白名单或禁用;飞书支持@触发。上线时建议默认只在被@时说话。
同一个机器人服务全公司,大家的对话会混在一起吗?
不会。每个人的对话历史、偏好和待办在渠道层面强制隔离,A 的内容不会出现在 B 的回复里。这不是提示词里的一句约定,而是系统强制的。
在群里@智能体让它发邮件,它会直接发吗?
不会。不论消息从哪个渠道进来,涉及发送、支付、发布、删除的动作都要经过审批边界。飞书里可以用消息卡片上的按钮直接完成批准或拒绝。
一个智能体,三个入口,一份记忆
企业微信、钉钉、飞书开箱即用,每个人的历史彼此隔离,对外动作一律过审批——团队在哪里工作,智能体就在哪里。