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,可完成企微环境与微信环境的信息打通。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 200,667评论 5 472
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,361评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 147,700评论 0 333
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,027评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,988评论 5 361
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,230评论 1 277
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,705评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,366评论 0 255
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,496评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,405评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,453评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,126评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,725评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,803评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,015评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,514评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,111评论 2 341