平台对接企业微信流程

1. 获取企业 ID

  • 登陆企业微信管理后台 (https://work.weixin.qq.com/wework_admin/frame)
  • 点击【我的企业】,进入我的企业页面,获取企业 ID。

2. 在企业微信中创建应用。(如果已有应用跳过这一步**

  • 点击【应用管理】中自建一栏里的【创建应用】
  • 在创建应用页面中填入应用的基本信息,点击【创建】

3. 获取企业微信应用的 AgentId, Secret, Token, EncodingAESKey

  • 【应用管理】中自建一栏点击刚创建好的应用,进入应用界面(如果已有应用,则直接点击应用)
  • 应用界面会有展示这个应用的AgentId, Secret

  • 功能-接收消息,点击【设置API接收】,进入 API 接收消息界面

  • 在 API 接收消息界面里,token,EncodingAESKey点击随机获取(也可使用自定义的字符串)

  • 按照需要设置需要接收的消息事件类型

如果勾选上上报进入应用事件,则会启用进入应用时,自动发送欢迎语)

  • 这个界面先不要关闭,后续需要填写此处的 URL。

4. 生成轻语平台消息接收 URL

  • 进入轻语平台,选择需要绑定的机器人,并发布机器人

  • 在轻语平台的机器人页面中点击【对接】【企业微信】

  • 在轻语平台的企业微信绑定页面填写对应企业微信的信息

  • 企业微信名称,用来区分此机器人绑定多个企业微信应用,仅用做展示。
  • 企业ID,AgentId, Secret, Token, EncodingAESKey填写上面步骤中获取的即可。需要保证这里的参数与企业微信的信息一致。
  • Welcome,进入应用时的自动回复(仅在勾选“上报进入应用事件”时有效)
  • 在轻语平台的企业微信绑定页面点击提交后,会生成一个消息接收链接(bindUrl)。

5. 在企业微信中设置消息接收 URL

  • 回到企业微信应用的接收消息配置的页面中
  • 在 URL 中填写上一步中生成消息接收链接(bindUrl),点击保存。



以下步骤为可选,企业微信菜单设置


6. 绑定企业微信的菜单(在点击这个菜单后,将切换到这个菜单绑定的机器人)

  • 回到企业微信应用的设置面板,点击【自定义菜单】(这一步不用企业微信管理员,应用负责人也可修改。应用负责人可以在应用的页面里设置。)
  • 创建所需的菜单样式,将菜单内容设置为【点击】,同时填写对应的菜单 ID,菜单 ID 不可重复。填写完后保存。例如:

  • 切换到轻语平台的企业微信绑定界面,填写对应的菜单信息后,保存
    • title 仅做展示用
    • wxMenuId 用来填写在企业微信应用的菜单 ID
    • botId 与这个菜单所绑定的轻语平台的机器人 ID
    • welcome 点击菜单后的欢迎语