企微第三方平台代开发流程

191 阅读3分钟

前段时间接手了一个PHP项目,因为没有PHP项目经验,所以很慌,但还好只是维护。上周来了个需求,让添加一个企微的吸粉账号,捣鼓了好几天,终于搞定。因为项目牵扯的流程比较复杂,相关文档较少,所以分享下流程,留作笔记。 原项目中已经有了对应的代码,只需要照搬复制一份,改下对应的id就可以。

步骤如下:
1. 原项目内,写好对应的crm管理后台的相关配置页面,用于开启企微配置(开启后才可显示对应企微账号配置)。
2. 原项目内,写好对应的回调接口,并部署代码。原项目是在回调中会将日志存储到本地文件中(后面会用到,比如授权码换取永久授权码,即secret)。
3. 登录企微服务商后台(open.work.weixin.qq.com),对应的如图:

image.png 点击前往,会有已创建的模板,点击进入 image.png 如下图,这时候把授权二维码发给客户,或者测试号,让其扫码。

注:扫码后,需要获取secret,这个流程必须在2个小时内完成。否则需要重新扫码

image.png

4. 客户扫码授权后,回调接口会收到一条请求,并将日志文件存储。

授权回调的设置位置如下: image.png 在【回调配置】-【待开发模板回调url】处,设置回调的接口。该处除了返回ticket,还会返回authcode(临时授权码) image.png 在回调的日志中,搜索authcode,会有如下返回,拿到临时授权码authCode image.png

5. 获取永久授权码。

需要编写脚本,调用2个企微开发文档的接口。

  1. 获取suite_access_token,接口文档如下: image.png 请求后,接口会返回suite_access_token image.png suite_id - 模版id,第四步模板信息内获取
    suite_secrect - 模板secret,第四步模板信息内获取
    suite_ticket - 模板ticket,第四步的回调日志中获取,如下: image.png

  2. 获取永久授权码permanent_code,接口文档如下: image.png 注意:请求的suite_access_token是拼在参数里的,auth_code是放在请求体的
    这一步的返回里,会有corpIDpermanent_code(永久授权码)

6. 替换项目中的corpID、secret

项目中会有corpID、secret、token、key、suiteId字段去配置

7. 配置模板下客户应用的基本信息

进入对应代开发应用的【操作】,开启权限,需客户方同意授权 image.png 配置回调url、token、key、可信任域名 image.png

8. 将客户添加到测试企业

【工具】-【应用开发】-【通用配置】-【测试企业配置】 image.png 此处打开之后,让客户扫一下二维码,如下位置 image.png

9. 购买许可证(必须是互通账号)

注意这里必须买互通账号,根据需求购买,正常可以免费试用一个月,到期后购买正式就可以

image.png

image.png

image.png

image.png 之后在【许可账号管理】内,就可以看到。目前是测试账号,可以去测试列表查看

image.png

image.png

image.png

10. 待开发应用发布上线

如下步骤发布即可,发布后大约等待10分钟左右

image.png

image.png

11. 沟通客户,登录企微管理后台关联对外人员

客户对接群内,告知客户,可以添加对外人员了。提醒客户添加完后,告知我方

微信管理后台的网址:work.weixin.qq.com/

【应用管理】-【第三方应用】处,会出现我们上线的应用,客户进入编辑即可

如下,是客户后台编辑完后的样子

image.png

12. 向客户索要关注二维码(活码)

向客户索要关注二维码,配置在线上后台。用户关注时,返回该二维码即可
活码生成可以参照这个攻略:zhuanlan.zhihu.com/p/405483290