企业微信与Linkflow连接
了解企微在客户旅程中的操作可以点击《企微_客户旅程》
如何在linkflow里面连接和设置企业微信
【企业微信】,原【微信企业号】,是腾讯团队为企业打造的内部协同办公工具。通过对接企业微信,您可以同步企业微信【客户联系】功能中的“客户/外部联系人”成为Linkflow用户,也可以在Linkflow里面对您的内部员工发送消息。
企业微信与Linkflow对接前,需完成以下准备工作。
企业微信与Linkflow对接后,必须要完成《设置客户联系接收事件服务器》
完成《设置客户联系接收事件服务器》对接后,先同步成员数据、然后再同步客户数据。
详细步骤见下述说明。
准备工作
在Linkflow系统内对接企业微信前,需做一些准备工作,如下:
1、(非必须)创建企业微信自建应用
在Linkflow对接前,需创建好企业微信自建应用。若需对接Linkflow的应用已存在,则不需额外创建。
2、申请企业域名
需申请两个二级域名。并将其对应的一级域名设置在企业管理端-我的企业-企业域名处。
例:
域名一:m.company.cn
域名二:app.company.cn
注意:该域名备案的企业必须和企微企业主体一致。且必须在阿里云备案。
添加路径:登录企业微信>【我的企业】>【企业信息】>【企业域名】>【添加】
——域名添加完成后,根据弹窗(如下图),企微会生成一个有【验证邮箱】,然后在【企微后台】新建这个邮箱,然后再点击完成下面的域名验证!
3、添加cname解析
需要运维配合,将上述申请的两个域名做cname解析:
app.company.cn指向app.linkflowtech.com
m.company.cn指向m.linkflowtech.com(指向m.linkflowtech.com的为可信域名,后续需要可信域名完成配置)
(这两个域名为示例,非真实邮箱,仅用于文档说明)
注意:需注意指向的对应关系,下述对接需按对应关系配置域名。将域名指向关系给到售后人员。
4、联系Linkflow售后
上述步骤都完成后,联系售后,协助为您开通代理IP(即企业可信IP)、配置ingress等一系列操作。
开始对接
一、在企业微信管理端操作
登录企业微信的管理后台,下述步骤均需在企业微信后台完成。
1、配置可信域名
在需对接的应用内,设置可信域名处,填入上述申请的m.cpmpany.com域名,同时下载“域名校验文件‘。
之后需登录本系统,在新建企业微信连接的第一步内,上传上述下载的域名校验文件,并点击下一步(进入到下一步后,暂不关闭网页,后续需用到)。
上述完成后,回到企业微信管理后台,再次打开设置可信域名界面,待界面显示"已验证"后点击确定,企业微信界面显示"已启用"即配置完成。接着进行下一步配置企业可信IP操作。
2、配置企业可信IP
将上述准备工作中,售后提供的企业可信IP,填入至自建应用-企业可信IP处。
1、配置企业可信ip,需要在本系统内新建企业微信连接前设置完成。否则无法创建连接。
2、配置完成后,切勿进行修改。仅所配IP可通过接口获取企业数据,修改企业可信ip会导致Linkflow无法获取数据。
3、企业可信IP非所有应用都需配置,若您需对接本系统的自建应用详情页内并没有下图“企业可信ip”模块(2022.6.28号前创建的自建应用),则可以不进行配置。
3、设置成员可见范围
需给应用配置可见范围,对接Linkflow后,系统仅可获取可见范围内的员工,及其员工的客户。
为保证系统可以获取全量的客户,建议您选择企业的根部门。
4、设置客户联系使用成员
需设置客户联系的使用范围,如下图,下述两个地方均需选中企业部门。
为保证系统可以获取全量的客户,建议您选择企业的根部门。
5、可调用应用设置
在【客户联系】> 【客户】> 点击“API” > 在【可调用应用】中点击修改 > 在需要对接的自建应用中打勾(仅在需要对接的自建应用中打“√”)
绑定微信公众号、小程序
若您希望Linkflow获取的企业微信用户可以和微信渠道用户进行合并,则可以在企业微信内绑定微信。若不需要和微信用户合并,则可以不进行此步骤设置。
——绑定路径:登录【企业微信】>【客户与上下游】>【客户】>点击【API】>点击【绑定】>弹出扫码授权页面
——绑定作用:通过UnionID合并联系人
详细的操作指引可以点击查看《微信公众号授权认证》
1、需要绑定同一个主体的公众号、小程序!
2、需要使用【微信公众号】、【小程序】的管理员个人微信号扫码授权
7、获取Corp ID(企业ID)、Agent ID、Agent Secret三个参数
Corp ID(企业ID)、Agent ID、Agent Secret这三个参数在后续对接Linkflow时会使用到,您可按下述方式获取:
①Corp ID(企业ID)
企微管理后台【我的企业】> 【企业信息】> 拉动到后面复制【Corp ID(企业ID)】
②Agent ID
在【应用管理】内,点击需对接Linkflow的自建应用,在其内获取Agent ID。
③Agent Secret
同样在应用详情页,点击查看,获取Secret。
该应用对接Linkflow后,不能点击【重新获取】,会生成新的secret,导致对接失败或影响功能使用。
点击【发送】,登录企业微信账号的人员的企业微信会收取到以下信息:
路径:登录Linkflow > 【连接管理】> 点击【新建连接】> 点击【协同办公】> 点击【企业微信】。
上述已完成新建连接的第一步“上传域名校验文件(见上述“在企业微信管理端操作-1、配置可信域名”),之后直接在下图中填写以上获取的相关参数即可。
1、企业ID、Agent ID、Agent Secret即上述在企业微信管理端所获取的信息。将信息复制在弹窗内即可。
2、企业可信ip即上述联系售后所得的ip。注意需和企业微信应用详情页内的“企业可信IP‘填写的一致,且必须先在企业微信应用内配置完成后,再在本系统内新建连接。
若您需对接本系统的应用详情页内未有“企业可信IP‘模块,则在系统内新建连企业微信接时,该企业可信IP可不进行填写,仅填写企业ID、AgentID与Secre后直接创建连接即可。
3、点击确定按钮,成功新建Linkflow对接后,会弹出“消息回调配置”设置页面,记得不要关闭,需要将这些信息复制并完成相关设置,见下一步。
2、设置客户联系接收事件服务器
新建连接成功后,需设置消息回调,详细操作可以直接点击下方查看设置指引。
如果不完成此项设置,企业微信事件无法同步到Linkflow!
企业微信与Linkflow解绑
如何解绑
解绑路径:【连接管理】> 找到已绑定的“企业微信”并点击【