了解企微在客户旅程中的操作可以点击《企微_客户旅程》

如何在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” > 在【可调用应用】中点击修改 > 在需要对接的自建应用中打勾（仅在需要对接的自建应用中打“√”）

6、（非必须）企业微信绑定微信公众号、小程序

若您希望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系统内操作

在企业微信管理端完成上述操作后，接下来可直接在Linflow系统内对接企业微信了。

1、新建企业微信连接

路径：登录Linkflow > 【连接管理】> 点击【新建连接】tab> 点击【协同办公】> 点击【企业微信】。

上述已完成新建连接的第一步“上传域名校验文件（见上述“在企业微信管理端操作-1、配置可信域名”），之后直接在下图中填写以上获取的相关参数即可。

注：

1、企业ID、Agent ID、Agent Secret即上述在企业微信管理端所获取的信息。将信息复制在弹窗内即可。

2、企业可信ip即上述联系售后所得的ip。注意需和企业微信应用详情页内的“企业可信IP‘填写的一致，且必须先在企业微信应用内配置完成后，再在本系统内新建连接。

若您需对接本系统的应用详情页内未有“企业可信IP‘模块，则在系统内新建连企业微信接时，该企业可信IP可不进行填写，仅填写企业ID、AgentID与Secre后直接创建连接即可。

3、点击确定按钮，成功新建Linkflow对接后，仍需要进行一些配置。见下一步

2、企业微信相关配置

完成上述操作后，进入到企业微信配置信息界面，需要进行设置事件服务器、配置属性和身份映射、同步成员和客户数据操作。

详细见企业微信-配置信息。

企业微信与Linkflow解绑

如何解绑

解绑路径：【连接管理】> 已有连接>找到已绑定的“企业微信”并点击【】> 在弹出的窗口中点击【确定】

新建企业微信连接成功后，为保证企业微信相关功能使用正常，仍需要完成以下配置。

一、设置客户联系接收时间服务器

路径：企业微信连接→配置信息→设置客户联系接收事件服务器。

1、【消息回调配置】时，如果您的【企业微信】有多个【自建应用】，那么不建议您按照以下【方式一】的配置【消息回调】（以下【方式一】仅适合【企业微信】仅有一个【自建应用】的客户！）

2、建议配置方式选择【方式二】。企业有多个自建应用或一个自建应用均可用方式二进行配置。

方式一：【企业微信】仅有一个【自建应用】

1、点击“生成新的”，可生成回调参数。

回调配置完成后，非必要请勿再次点击“生成新的”按钮。生成新参数后，若未在企业微信后台完成相关操作，会导致系统无法接收到企业微信相关事件。

2、将上述URL、Token、EncodingAESKey的参数值复制到企业微信 → 客户联系→接收事件服务器中，当服务人员添加或者删除了外部联系人时，将以事件的形式推送到指定url

若新建企业微信连接前，有新建企业域名的，则在此处复制粘贴参数时，应将URL中的域名改为企业自身的域名【即指向cdp.linkflowtech.com的企业域名】

详见企业微信相关文档说明：《企业微信-设置接收事件服务器相关说明》

方式二：【企业微信】有多个【自建应用】

1、点击“生成新的”，可生成回调参数。

回调配置完成后，非必要请勿再次点击“生成新的”按钮。生成新参数后，若未在企业微信后台完成相关操作，会导致系统无法接收到企业微信相关事件。

2、若方式一的“客户联系”处“接收事件服务器”已被占用（即对接多个平台），可以在对接系统的自建应用中，选择“设置API接收”。

路径：登录企业微信 > 应用管理 > 应用 > 找到已对接的“自建应用” > 然后将系统中的URL、Token、EncodingAESKey参数值复制到企业微信的自建应用

注意：若新建企业微信连接前，有新建企业域名的，则在此处复制粘贴参数时，应将URL中的域名改为企业自身的域名【即指向cdp.linkflowtech.com的企业域名】

二、配置属性与身份映射

完成上述设置接收事件回调后，点击下一步，需进行属性与身份映射操作。即可以配置系统是否记录企业微信渠道的用户属性、用户身份，以及记录在哪个用户属性、用户身份上。

路径：企业微信连接→配置信息→配置属性与身份映射。

1、用户属性映射

系统会自动记录企业微信用户的姓名、头像、性别、职位、企业简称、企业全称，若不需要记录，可以设置为不映射。

成员备注手机号默认不映射，若需要，可以设置对应关系，建议映射至“手机号码”用户属性上。

注意：成员备注手机号，仅会记录最近添加用户的成员给外部联系人备注的手机号，若备注多个手机号，则取第一个。

2、用户身份映射

系统会默认记录企业微信用户的externaluserid、微信unionid，这些身份有助于系统识别用户以及合并用户。

成员备注手机号，系统默认不映射，若需要，可以设置其映射关系。

注意：企微用户的手机号，是取自员工给用户备注的手机号，若员工备注非真实手机号或者是其他字符，设置了该身份映射，可能导致身份混乱，以及错误合并用户。

3、用户属性和用户身份均配置完成后，点击保存即可完成设置。

后续同步企微用户或者创建用户时，即会根据配置的映射关系记录用户属性以及用户身份。

三、同步成员和客户数据

完成上述设置后，点击下一步，进行同步成员和客户数据操作。

路径：企业微信连接→配置信息→同步成员和客户数据。

1、同步成员数据

成员即企业的内部员工，点击同步按钮即可同步成员数据。

必须先完成“同步成员数据”才可以“同步客户数据”！
企业微信内部的人员，可以用来获取相应的外部联系人，但不可读为企业组织架构里的员工，也不支持其它任何操作！
同步成员数据前，请确保企业微信后台应用的成员可见范围和客户联系使用范围保持一致，否则成员数据同步不完全。详细见【企业微信与LinkFlow连接】-开始对接-在企业微信端操作的3、4步。

2、同步客户数据

成员数据同步完成后，即可同步客户数据，系统会基于前一步的所有成员，同步其下的所有外部联系人。

3、成员和客户数据均同步完成后，点击“开始使用‘即可正常使用企业微信的功能。

企业微信与Linkflow连接