xinmi/docs/wiki/集成扩展/IM集成开发.md

title, tags, aliases, source

title	tags	aliases	source
IM集成开发	集成扩展 IM 企微 飞书 Lark Slack Telegram 钉钉 Mattermost	IM集成 IM开发 企业微信 即时通讯	IM集成开发文档.md

IM 集成开发

WeKnora 的 IM 集成模块将企业即时通讯平台（企业微信、飞书、Lark、Slack、Telegram、钉钉、Mattermost）接入 WeKnora 知识问答管道，支持在 IM 中直接向 AI 提问并获得实时流式回答。

IM 渠道绑定到 Agent，一个 Agent 可接入多个 IM 渠道。

IM 渠道中的 Agent 可以使用 MCP 工具 和 Skills 技能

支持的平台

平台	WebSocket 模式	Webhook 模式	流式输出
企业微信	✅	✅	✅
飞书	✅	✅	✅ (CardKit)
Lark（飞书国际版）	✅	✅	✅ (CardKit)
Slack	✅ (Socket Mode)	✅ (Events API)	✅
Telegram	✅ (长轮询)	✅	✅
钉钉	✅ (Stream)	✅	✅ (AI 卡片)
Mattermost	—	✅	✅

快速接入指南

前置条件

• WeKnora 已部署并运行
• 已创建至少一个 Agent（自定义智能体）
• Agent 已配置好模型和知识库

Agent 配置模型参见 内置模型管理

企业微信接入

提供两种模式：

• WebSocket 模式（智能机器人，推荐）— 无需公网域名
• Webhook 模式（自建应用）— 需要公网回调地址

飞书接入

• WebSocket 模式（推荐）— 无需公网域名
• Webhook 模式 — 需要公网回调地址

飞书同时也是数据源导入的支持平台，参见 数据源导入开发

Lark 接入

Lark 是飞书的国际版，IM 接口一致，与飞书共用同一套适配器。接入步骤基本相同，但开放平台 与权限清单不同：

• 飞书：https://open.feishu.cn/
• Lark：https://open.larksuite.com/

权限不可套用飞书的清单：飞书清单混入了数据源连接器（Wiki 同步）用的权限，其中部分在 Lark 并不存在，整份导入会失败。Lark 只需 IM 相关的 6 项，见 IM集成开发文档 — Lark 权限配置。

两朵云的应用互不通用，凭证只在创建它的那朵云上有效。

Slack 接入

• Socket Mode（推荐）— 无需公网域名
• Events API — 需要公网回调地址

Telegram 接入

• 长轮询模式（推荐）— 无需公网域名
• Webhook 模式 — 需要 HTTPS 公网回调

钉钉接入

• Stream 模式（推荐）— 无需公网域名
• Webhook 模式 — 需要公网回调地址

Mattermost 接入

• 仅支持 Webhook 模式（出站 Webhook + REST API v4）

架构设计

系统采用 Adapter Pattern，每个平台实现 im.Adapter 接口，通过 AdapterFactory 动态创建。核心设计模式包括：

模式	用途
Adapter Pattern	统一不同 IM 平台的差异
Factory Pattern	从数据库渠道配置动态创建 Adapter
Command Pattern	可插拔的斜杠指令系统
Producer-Consumer	QA 队列 + Worker Pool

斜杠指令系统

指令	说明
/help	显示所有可用指令
/info	查看当前绑定智能体信息
/search	对知识库执行混合检索
/stop	取消当前 QA 请求
/clear	清空当前对话记忆

扩展新平台

接入新的 IM 平台只需 3 步：

1. 实现 im.Adapter 接口（可选 StreamSender、FileDownloader）
2. 注册适配器工厂
3. 前端添加平台选项

扩展开发模式与 添加网络搜索引擎 和 集成向量数据库 类似

相关主题

• 数据源导入开发 — 飞书数据源同步（共享飞书应用凭证）
• MCP功能使用说明 — Agent 可调用 MCP 工具
• Agent技能系统 — Agent 可使用 Skills 技能
• 开发指南 — 开发环境搭建

---

反向链接

• Home — Wiki 首页导航
• 数据源导入开发 — 同样涉及飞书集成，可共享应用凭证
• MCP功能使用说明 — IM 中 Agent 可调用 MCP 工具
• Agent技能系统 — IM 中 Agent 可使用 Skills
• 版本路线图 — IM 集成已完成的里程碑