[企业微信开发]部署一个企业微信机器人:懒人包重用

写在前面

腾讯有提供企业微信开发 SDK,官方支持开发很多应用或对接外部系统。这里说的机器人接入,有两种方式。1 企业微信应用的方式使用。只能私聊,不支持群聊。不占用企微账号。安全。2 企业微信账号方式使用。占用企微账号,功能跟正常企微账号一样。封号风险。

首先你需要按上一篇提到的方式下载 chatgpt-on-wechat 项目并安装 Python 和对应的依赖包, 或者下载懒人包 https://github.com/zhayujie/chatgpt-on-wechat(包括 Python3 和依赖包),并配置对应的 config.json

企微应用

接入企微应用,需要的资源如下:

  • 一台有独立 IP 的服务器 (如果用 OpenAI API Key 的话,要能联外网)
  • 注册一个企业微信,个人也可以注册,只是无法认证
  • 如果是认证的企业微信,还需要一个对应主体备案的域名
  1. 创建企微应用
    首先在 企业微信管理后台,点击 “我的企业” 菜单,在最下方可以看到 “企业 ID”,保存这个 id,后续需要填写在配置的 wechatcom_corp_id 字段中。

2.切换到 “应用管理” 菜单,点击创建应用:[企业微信开发]部署一个企业微信机器人:懒人包重用进入到应用创建页面,记录下页面上显示的 agentld 和 secret 信息:[企业微信开发]部署一个企业微信机器人:懒人包重用

点击 “设置 API 接收” 配置应用接口:[企业微信开发]部署一个企业微信机器人:懒人包重用

  • 其中 url 的格式为 http://ip:port/wxcomapp,如果是认证企业则需要填写备案域名
  • 随机获取 Token 和 EncodingAESKey 并保存下来,后续需要填写在配置文件中。

此时保存 API 接收配置 是无法成功的,因为我们的 python 程序还没有启动起来,等项目运行后再回来保存。

  1. 配置和运行程序
    企业微信相比个人微信需要增加一些配置,打开 config.json 配置文件,除了 配置说明 中必填的配置外,还需要添加或修改以下配置。各配置项和企业微信后台各参数的对应关系已经在上述截图中说明。

{
  "channel_type": "wechatcom_app",   #更改 channel_type 为 wechatcom_app
  "single_chat_prefix": [""],   
  "wechatcom_corp_id": "",              
  "wechatcomapp_token": "",             
  "wechatcomapp_secret": "",           
  "wechatcomapp_agent_id": "",          
  "wechatcomapp_aes_key": "",
  "wechatcomapp_port": 9898       
}

配置完成后,运行 start.sh启动程序。当后台日志显示 http://0.0.0.0:9898/ 的时候就说明程序已经运行成功,监听 9898 端口了,此时需要将该端口对外开放,比如在云服务器的安全组中放开该端口。

程序启动后就可以回到 企业微信后台 保存 “消息服务器配置” 了,保存成功后还需要将服务器的 ip 添加到 “企业可信 IP” 中,否则是无法收发消息的。

注意:

如遇到企业微信后台 url 设置显示回调不通过或者配置失败,参考下面的解决方案:确保 服务器防火墙关闭 且 安全组放行监听的端口
仔细检查 token,secret key 等参数配置是否一致,后台 url 格式配置是否正确
对于认证的企业微信需要配置与主体一致的备案域名

  1. 运行效果
    接下来就可以在企业微信中搜索我们刚刚创建的应用名称,直接和应用对话了。如果将项目复制多份,分别监听不同端口,还可以创建多个企微应用,效果如下:[企业微信开发]部署一个企业微信机器人:懒人包重用

另外,如果想让外部个人微信用户使用,可以在 “我的企业 – 微信插件”,分享邀请关注二维码。个人微信扫码点击关注,验证手机号后就可以加入到该公司,并与上面创建的应用对话。[企业微信开发]部署一个企业微信机器人:懒人包重用

企微账户

企微账户方式启动的话,你需要
1.更改 config.json 里的 channel_type


"channel_type": "wework"  ##企信账户方式运行
  1. 安装特定版本的企微应用。懒人包支持这个版本,下载重新安装 https://dldir1.qq.com/wework/work_weixin/WeCom_4.0.8.6027.exe
  2. 非管理员账户登陆企微
  3. 运行程序 win_start.bat[企业微信开发]部署一个企业微信机器人:懒人包重用
  4. 聊天效果与微信类似,但 PC 版与机器人不冲突,它们运行在同一台电脑上。[企业微信开发]部署一个企业微信机器人:懒人包重用

注意这种启动方式不是官方支持的,有被限制的风险。所以请务不要用管理员账号这样使用,用于研究和测试,低频使用应该还行。如果你需要企业对外使用,正常做企微开发是最稳妥的。

© 版权声明

☆ END ☆
喜欢就点个赞吧
点赞0 分享
图片正在生成中,请稍后...