企微与LinkFlow对接指引
了解企微在客户旅程中的操作可以点击《企微_客户旅程》
如何在linkflow里面连接和设置企业微信
【企业微信】，原【微信企业号】，是腾讯团队为企业打造的内部协同办公工具。通过对接企业微信，您可以同步企业微信【客户联系】功能中的“客户/外部联系人”成为Linkflow用户，也可以在Linkflow里面对您的内部员工发送消息。
企业微信与Linkflow对接前，需完成以下准备工作。
企业微信与Linkflow对接后，必须要完成《设置客户联系接收事件服务器》
完成《设置客户联系接收事件服务器》对接后，先同步成员数据、然后再同步客户数据。
注意：企微与LinkFlow对接，必须要一个企业域名且在阿里云完成备案，域名备案的【企业主体】必须和企微【企业主体】一致。且必须在阿里云备案。
详细可以点击《企微官方文档》查看！（如下图，也可以点击查看）
对接的详细步骤见下述说明。
准备工作
在Linkflow系统内对接企业微信前，需做一些准备工作，如下：
1、若您需对接Linkflow的自建应用为2022.6.28号之前创建的【自建应用】，不需要LinkFlow售后协助提供一个【企业可信IP】。
——登录【企业微信】后台，打开【自建应用】-【开发者接口】并未看到【企业可信IP】模块，代表此【自建应用】为2022.6.28号前创建！
2、若您需对接Linkflow的【自建应用】为2022.6.28号之后创建的，烦请联系LinkFlow售后，售后会免费为您提供一个【企业可信IP】！
3、需要在一个【一级域名】下申请两个【二级域名】，且此【一级域名】的备案的企业主体必须和企微企业主体一致，且必须在阿里云备案。
4、需要有一个企业邮箱，且邮箱后缀与步骤【3】的域名一致，主体一致。（如：【一级域名】为testcdp.com，【企业邮箱】就是：zhangsan@testcdp.com，或者是备案主体与【一级域名】主体一致的【企业邮箱】）
5、【自建应用】与Linkflow对接，烦请按照以下操作顺序完成！！
1、（非必须）创建企业微信自建应用
在Linkflow对接前，需创建好企业微信自建应用。若需对接Linkflow的应用已存在，则不需额外创建。
2、申请企业域名
需申请两个二级域名。并将其对应的一级域名设置在企业管理端-我的企业-企业域名处。
例：
域名一：m.company.cn
域名二：app.company.cn
注意：该域名备案的企业必须和企微企业主体一致。且必须在阿里云备案。
详细可以点击《企微官方文档》查看！
添加路径：登录企业微信>【我的企业】>【企业信息】>【企业域名】>【添加】
——域名添加完成后，根据弹窗（如下图），企微会生成一个有【验证邮箱】，然后在【企微后台】新建这个邮箱，然后再点击完成下面的域名验证！
3、添加cname解析
需要运维配合，将上述申请的两个域名做cname解析：
app.company.cn指向cdp.linkflowtech.com
m.company.cn指向cdp-m.linkflowtech.com（指向cdp-m.linkflowtech.com的为可信域名，后续需要可信域名完成配置）
（这两个域名为示例，非真实邮箱，仅用于文档说明）
注意：需注意指向的对应关系，下述对接需按对应关系配置域名。将域名指向关系给到售后人员。（就是下述【步骤4】的ingress操作，此步骤由LinkFlow售后人员协助完成）
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 > 【连接管理】> 点击【新建连接】tab> 点击【协同办公】> 点击【企业微信】。
上述已完成新建连接的第一步“上传域名校验文件（见上述“在企业微信管理端操作-1、配置可信域名”），之后直接在下图中填写以上获取的相关参数即可。
注：
1、企业ID、Agent ID、Agent Secret即上述在企业微信管理端所获取的信息。将信息复制在弹窗内即可。
2、企业可信ip即上述联系售后所得的ip。注意需和企业微信应用详情页内的“企业可信IP‘填写的一致，且必须先在企业微信应用内配置完成后，再在本系统内新建连接。
若您需对接本系统的应用详情页内未有“企业可信IP‘模块，则在系统内新建连企业微信接时，该企业可信IP可不进行填写，仅填写企业ID、AgentID与Secre后直接创建连接即可。
3、点击确定按钮，成功新建Linkflow对接后，仍需要进行一些配置。见下一步
2、企业微信相关配置
完成上述操作后，进入到企业微信配置信息界面，需要进行设置事件服务器、配置属性和身份映射、同步成员和客户数据操作。
详细见企业微信-配置信息。
企业微信与Linkflow解绑
如何解绑
解绑路径：【连接管理】> 已有连接>找到已绑定的“企业微信”并点击【
】> 在弹出的窗口中点击【确定】
