2020-08-23 企业微信-邀请海报助力原理

最近，不少行业都开始使用企业微信来进行客户裂变了，常见的裂变套路包括：分享海报添加企业微信员工或加入企业微信外部客户群并完成邀请助力活动后，可以免费或低价领取奖品。流程大致如下图：

image.png

这个过程，实际上用到了企业微信API中的不少能力，包括：生成企微员工【联系我】二维码图像、客户添加企微员工后自动发送欢迎语等。

一. 【联系我】二维码：

官方API介绍：
https://work.weixin.qq.com/api/doc/90001/90143/92577

我们可以调用该接口生成任意单人或多人随机的二维码图，并将此图与设计好的营销海报合成为最终列表海报。
在实际设计过程中，有以下内容需要注意的：

1. 生成的二维码，扫出来以后是单人还是多人的问题。若设置为多人，扫码出人的规则是由企业微信设置的，我们不可控制，实际测试并未发现明显的规律。若需控制扫码出人的规律，建议此处设置为单人码，真正的分配人员规律由自己后台生成。
2. 用户扫码后，可无需企微员工验证即添加为好友，此功能需在生成二维码API中设置skip_verify=true.
3. 每个二维码图，均可设置不同的参数。此参数可在获取客户（外部联系人）详情时拿到，结合这个过程，通过这个个性化的参数，可实现后续多种定制化服务。例如：根据不同来源的客户发送不同的欢迎语、计算客户本人已裂变带来的新客户人数等。需注意：该参数长度不超过30字符。
   4.每个生成的二维码对应一个config_id，我们后台需妥善保存。另外，每个企业最多生成50万个，达到阈值前建议定时清空历史数据。
   5.该功能需要被展示员工开通了企业微信客户联系功能、并完成企业微信激活与实名认证操作。

二. 外部联系人添加事件回调：

官方API介绍：
https://work.weixin.qq.com/api/doc/90001/90143/92277

外部联系人主动或被动添加企业微信员工时，均会产生相应的回调事件，我们需进行记录，用于后续的发送欢迎语的操作。
在回调事件中，需注意以下内容：

1. ExternalUserID,即企业微信体系中外部联系人的userID（即裂变带来的外部微信客户）。通过ExternalUserID,可继续调用API——获取客户详情 。见后续介绍。
   2.state,即生成二维码海报时的自定义参数。可识别出该客户是扫的哪张海报加入的。对于后续裂变客户，此处也可识别出裂变客户是哪位种子客户裂变产生的。
   3.welcomecode,可结合state、与发送新客户欢迎语功能，对该客户发送定制化的新人欢迎语。见后续介绍。
   4.注意：外部联系人添加的回调事件，需配置事件回调URL，此处可在企微后台-客户联系中配置，也可在自建应用、第三方应用进行配置，将同时受到该信息。

三. 发送新客户欢迎语：

官方API介绍：
https://work.weixin.qq.com/api/doc/90001/90143/92599

该功能的实现，需要结合外部联系人的回调事件进行触发，包括外部联系人主动与被动添加企微员工的两种形式均可。
需注意以下几点内容：
（1）企业微信限定：该接口仅可在收到回调事件20秒内调用，且只可调用一次，这个需要注意不可超时。
（2）因回调事件可在多处进行配置，所以发送欢迎语的功能需控制调用方，避免发生多处调用的问题。若出现该种情况，企业微信会按照最先调用的进行发送，其他皆失败处理。建议此处可按照state类型区分开调用方。
（3）发送的内容，最多可发两条，即一个文本内容与一个（图片、小程序、H5消息 之一）内容。

四. 获取客户详情：

官方API介绍：
https://work.weixin.qq.com/api/doc/90001/90143/92265
外部联系人添加入我方企业后，会有个唯一ID--External_UserID,通过该ID我们可获取到该客户的详细信息。
获取到该客户的详情信息，字段如下：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
external_userid	外部联系人的userid
name	外部联系人的名称[注1]
avatar	外部联系人头像，第三方不可获取
type	外部联系人的类型，1表示该外部联系人是微信用户，2表示该外部联系人是企业微信用户
gender	外部联系人性别 0-未知 1-男性 2-女性
unionid	外部联系人在微信开放平台的唯一身份标识（微信unionid），通过此字段企业可将外部联系人与公众号/小程序用户关联起来。仅当联系人类型是微信用户，且企业或第三方服务商绑定了微信开发者ID有此字段。查看绑定方法
position	外部联系人的职位，如果外部企业或用户选择隐藏职位，则不返回，仅当联系人类型是企业微信用户时有此字段
corp_name	外部联系人所在企业的简称，仅当联系人类型是企业微信用户时有此字段
corp_full_name	外部联系人所在企业的主体名称，仅当联系人类型是企业微信用户时有此字段
external_profile	外部联系人的自定义展示信息，可以有多个字段和多种类型，包括文本，网页和小程序，仅当联系人类型是企业微信用户时有此字段，字段详情见对外属性；
follow_user.userid	添加了此外部联系人的企业成员userid
follow_user.remark	该成员对此外部联系人的备注
follow_user.description	该成员对此外部联系人的描述
follow_user.createtime	该成员添加此外部联系人的时间
follow_user.tags.group_name	该成员添加此外部联系人所打标签的分组名称（标签功能需要企业微信升级到2.7.5及以上版本）
follow_user.tags.tag_name	该成员添加此外部联系人所打标签名称
follow_user.tags.type	该成员添加此外部联系人所打标签类型, 1-企业设置, 2-用户自定义
follow_user.remark_corp_name	该成员对此客户备注的企业名称
follow_user.remark_mobiles	该成员对此客户备注的手机号码，第三方不可获取
follow_user.add_way	该成员添加此客户的来源，具体含义详见来源定义
follow_user.oper_userid	发起添加的userid，如果成员主动添加，为成员的userid；如果是客户主动添加，则为客户的外部联系人userid；如果是内部成员共享/管理员分配，则为对应的成员/管理员userid
follow_user.state	企业自定义的state参数，用于区分客户具体是通过哪个「联系我」添加，由企业通过创建「联系我」方式指定

需注意的是：客户详情的UnionID，可用来关联此客户的企微环境信息与微信环境信息。实际操作中，在客户看到海报并扫码进入H5页面时，即获取UnionID，并关联H5页面填写的部分信息（如手机号、姓名、地区等），再结合企微的UnionID，可完成企微环境与微信环境的信息打通。