前段时间接手了一个PHP项目,因为没有PHP项目经验,所以很慌,但还好只是维护。上周来了个需求,让添加一个企微的吸粉账号,捣鼓了好几天,终于搞定。因为项目牵扯的流程比较复杂,相关文档较少,所以分享下流程,留作笔记。 原项目中已经有了对应的代码,只需要照搬复制一份,改下对应的id就可以。
步骤如下:
1. 原项目内,写好对应的crm管理后台的相关配置页面,用于开启企微配置(开启后才可显示对应企微账号配置)。
2. 原项目内,写好对应的回调接口,并部署代码。原项目是在回调中会将日志存储到本地文件中(后面会用到,比如授权码换取永久授权码,即secret)。
3. 登录企微服务商后台(open.work.weixin.qq.com),对应的如图:
点击前往,会有已创建的模板,点击进入
如下图,这时候把授权二维码发给客户,或者测试号,让其扫码。
注:扫码后,需要获取secret,这个流程必须在2个小时内完成。否则需要重新扫码
4. 客户扫码授权后,回调接口会收到一条请求,并将日志文件存储。
授权回调的设置位置如下:
在【回调配置】-【待开发模板回调url】处,设置回调的接口。该处除了返回ticket,还会返回authcode(临时授权码)
在回调的日志中,搜索authcode,会有如下返回,拿到临时授权码authCode
5. 获取永久授权码。
需要编写脚本,调用2个企微开发文档的接口。
-
获取suite_access_token,接口文档如下:
请求后,接口会返回suite_access_token
suite_id - 模版id,第四步模板信息内获取
suite_secrect - 模板secret,第四步模板信息内获取
suite_ticket - 模板ticket,第四步的回调日志中获取,如下: -
获取永久授权码permanent_code,接口文档如下:
注意:请求的suite_access_token是拼在参数里的,auth_code是放在请求体的
这一步的返回里,会有corpID和permanent_code(永久授权码)
6. 替换项目中的corpID、secret
项目中会有corpID、secret、token、key、suiteId字段去配置
7. 配置模板下客户应用的基本信息
进入对应代开发应用的【操作】,开启权限,需客户方同意授权
配置回调url、token、key、可信任域名
8. 将客户添加到测试企业
【工具】-【应用开发】-【通用配置】-【测试企业配置】
此处打开之后,让客户扫一下二维码,如下位置
9. 购买许可证(必须是互通账号)
注意这里必须买互通账号,根据需求购买,正常可以免费试用一个月,到期后购买正式就可以
之后在【许可账号管理】内,就可以看到。目前是测试账号,可以去测试列表查看
10. 待开发应用发布上线
如下步骤发布即可,发布后大约等待10分钟左右
11. 沟通客户,登录企微管理后台关联对外人员
客户对接群内,告知客户,可以添加对外人员了。提醒客户添加完后,告知我方
微信管理后台的网址:work.weixin.qq.com/
【应用管理】-【第三方应用】处,会出现我们上线的应用,客户进入编辑即可
如下,是客户后台编辑完后的样子
12. 向客户索要关注二维码(活码)
向客户索要关注二维码,配置在线上后台。用户关注时,返回该二维码即可
活码生成可以参照这个攻略:zhuanlan.zhihu.com/p/405483290