diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index a6b9d7608..5300f7c15 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -91,7 +91,19 @@ export default defineConfig({ }, ], }, - { text: "企业微信", link: "/deploy/platforms/wecom/wecom" }, + { text: "企业微信", + collapsed: true, + items: [ + { + text: "内部应用", + link: "/deploy/platforms/wecom/wecom", + }, + { + text: "对外客服", + link: "/deploy/platforms/wecom/wecomcs", + }, + ], + }, { text:"微信公众号",link:"/deploy/platforms/wxoa.md"}, { text: "飞书", link: "/deploy/platforms/lark" }, { text:"钉钉",link:"/deploy/platforms/dingtalk.md"}, diff --git a/docs/assets/image/wecomcs_01.jpg b/docs/assets/image/wecomcs_01.jpg new file mode 100644 index 000000000..092585909 Binary files /dev/null and b/docs/assets/image/wecomcs_01.jpg differ diff --git a/docs/deploy/platforms/readme.md b/docs/deploy/platforms/readme.md index 3a24c7c77..5dba87988 100644 --- a/docs/deploy/platforms/readme.md +++ b/docs/deploy/platforms/readme.md @@ -8,10 +8,11 @@ LangBot 需要连接消息平台 API 才能与用户交互,目前支持以下 | QQ 个人号 | ✅ | 使用普通的 QQ 号作为机器人,需要使用独立的协议端,支持 OneBot v11 和 go-cqhttp 协议 | [NapCat](/deploy/platforms/qq/aiocqhttp/napcat)
[Lagrange](/deploy/platforms/qq/aiocqhttp/lagrange)
[LiteLoaderQQNT](/deploy/platforms/qq/aiocqhttp/llonebot)
[go-cqhttp(不推荐)](/deploy/platforms/qq/gocq) | | QQ 官方机器人 | ✅ | 接入 QQ 开放平台的机器人 API | [教程](/deploy/platforms/qq/official_webhook) | | 企业微信 | ✅ | 企业内部机器人 | [教程](/deploy/platforms/wecom/wecom) | +| 企业微信客服 | ✅ | 企业对外机器人 | [教程](/deploy/platforms/wecom/wecomcs) | | 微信公众号 | ✅ | 微信公众平台机器人 | [教程](/deploy/platforms/wxoa.md) | | 个人微信 | ✅ | 个人微信机器人 | [Gewechat](/deploy/platforms/wechat/gewechat) | | 飞书 | ✅ | | [教程](/deploy/platforms/lark) | | 钉钉 | ✅ | | [教程](/deploy/platforms/dingtalk) | | Discord | ✅ | | [教程](/deploy/platforms/discord) | | Telegram | ✅ | | [教程](/deploy/platforms/telegram) | -| Slack | ✅ | | [教程](/deploy/platforms/slack) | +| Slack | ✅ | | [教程](/deploy/platforms/slack) | \ No newline at end of file diff --git a/docs/deploy/platforms/wecom/wecom.md b/docs/deploy/platforms/wecom/wecom.md index f634c454e..7c5a55ff2 100644 --- a/docs/deploy/platforms/wecom/wecom.md +++ b/docs/deploy/platforms/wecom/wecom.md @@ -2,6 +2,10 @@ 部署企业微信机器人接入 LangBot 。 +:::info +此种接入方式为企业内部自建应用,是在企业内部使用的,若需要对外接待,请查看[企业微信客服接入方案](wecomcs.md)。 +::: + ## 创建机器人 diff --git a/docs/deploy/platforms/wecom/wecomcs.md b/docs/deploy/platforms/wecom/wecomcs.md new file mode 100644 index 000000000..ff958f54d --- /dev/null +++ b/docs/deploy/platforms/wecom/wecomcs.md @@ -0,0 +1,38 @@ +# 部署企业微信客服 + +:::info + +本文详细讲述 LangBot 部署到企业微信客服号的过程,此功能可以将客服号与普通微信进行对话。若只需要在企业微信内部使用,请参考[企业微信内部应用实现](wecom.md)。 + +**部署企业微信客服号需要企业资质**,具体查看[企业微信客服号接入指南](https://developer.work.weixin.qq.com/document/path/94638),并且根据此文档提供对应的企业资质证明。 + +::: + +## 效果图 + +![效果图](/assets/image/wecomcs_01.jpg) + +## 部署指南 + +企业微信客服号需要四个配置项,如下: + +```json +{ + "adapter": "wecomcs", + "enable": false, + "port": 2289, + "corpid": "", + "secret": "", + "token": "", + "EncodingAESKey": "" +} +``` + +后续的配置方式和配置项和[企业微信内部应用](wecom.md)一样,只是不需要 `contacts_secret`。 + +## 注意事项 + +1. 一定要按照上文的企业微信官方文档步骤走,将客服账号添加入 `api 管理`中。 +2. 步骤与企业微信内部应用一样,不要漏看,同样需要保存回调地址,因为本质上只是在企业微信内部应用上增加了其他的权限。 +3. LangBot 不会读取敏感信息如聊天记录和企业资质内容。 + diff --git a/docs/deploy/quick-config/config.md b/docs/deploy/quick-config/config.md index 48a95b1fe..18487d8ed 100644 --- a/docs/deploy/quick-config/config.md +++ b/docs/deploy/quick-config/config.md @@ -221,7 +221,7 @@ ## 钉钉适配器 -具体用法请查看[配置钉钉机器人](/deploy/platforms/dingtalk.md) +具体用法请查看[配置钉钉机器人](/deploy/platforms/dingtalk.md)。 ```json { @@ -262,6 +262,22 @@ } ``` +### 企业微信客服号 + +具体用法请查看[配置企业微信客服号](/deploy/platforms/wecomcs.md) + +```json +{ + "adapter": "wecomcs", + "enable": false, + "port": 2289, + "corpid": "", + "secret": "", + "token": "", + "EncodingAESKey": "" +} +``` + ## provider.json 修改此配置文件以设置所连接的 AI 提供商的相关信息。