接入指南

把 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、SecretClient ID、Client SecretApp 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,见出海东南亚。

上线前的三个决定

  1. 先白名单,再放开。三个渠道都支持某种形式的名单控制,用它。
  2. 群里默认只在被@时说话。一个在群里主动接话的机器人,是被人拉出群的最快方式。
  3. 指定一个人每周看一次记录。没有这个人,三个月后它会悄悄变得不可靠,而且没人知道。

延伸阅读

常见问题

Olano 支持企业微信、钉钉和飞书吗?

三个都是内置渠道,在控制台里通过带引导的表单添加。企业微信通过智能机器人回调接入,需要 Bot ID 和 Secret;钉钉用 Stream 模式,需要 Client ID 和 Client Secret;飞书需要 App ID、App Secret 和验证 Token,可选长连接或 Webhook。

接钉钉需要公网服务器吗?

不需要。Olano 用钉钉的 Stream 模式主动连接接收消息,不用暴露回调地址,也不用配域名和证书。这让钉钉成为三者里部署最省事的一个。

智能体在群里会不会乱说话?

由你控制。钉钉有独立的回应范围(全部 / 仅被@ / 不回应)和监听范围(关闭 / 全部 / 仅@)开关,可以让它听全部消息但只在被@时开口;企业微信的群聊策略可选开放、白名单或禁用;飞书支持@触发。上线时建议默认只在被@时说话。

同一个机器人服务全公司,大家的对话会混在一起吗?

不会。每个人的对话历史、偏好和待办在渠道层面强制隔离,A 的内容不会出现在 B 的回复里。这不是提示词里的一句约定,而是系统强制的。

在群里@智能体让它发邮件,它会直接发吗?

不会。不论消息从哪个渠道进来,涉及发送、支付、发布、删除的动作都要经过审批边界。飞书里可以用消息卡片上的按钮直接完成批准或拒绝。

一个智能体,三个入口,一份记忆

企业微信、钉钉、飞书开箱即用,每个人的历史彼此隔离,对外动作一律过审批——团队在哪里工作,智能体就在哪里。

开始部署