Merge pull request #44 from wangcham/main

添加企业微信客服的文档

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"},

docs/deploy/platforms/readme.md

@@ -8,10 +8,11 @@ LangBot 需要连接消息平台 API 才能与用户交互，目前支持以下
 | QQ 个人号 | ✅ | 使用普通的 QQ 号作为机器人，需要使用独立的协议端，支持 OneBot v11 和 go-cqhttp 协议 | [NapCat](/deploy/platforms/qq/aiocqhttp/napcat) <br> [Lagrange](/deploy/platforms/qq/aiocqhttp/lagrange) <br> [LiteLoaderQQNT](/deploy/platforms/qq/aiocqhttp/llonebot) <br> [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) |

docs/deploy/platforms/wecom/wecom.md

@@ -2,6 +2,10 @@
 
 部署企业微信机器人接入 LangBot 。
 
+:::info
+此种接入方式为企业内部自建应用，是在企业内部使用的，若需要对外接待，请查看[企业微信客服接入方案](wecomcs.md)。
+:::
+
 
 ## 创建机器人
 

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 不会读取敏感信息如聊天记录和企业资质内容。
+

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 提供商的相关信息。