最近笙什，不少行業(yè)都開始使用企業(yè)微信來進(jìn)行客戶裂變了茵烈，常見的裂變套路包括：分享海報(bào)添加企業(yè)微信員工或加入企業(yè)微信外部客戶群并完成邀請助力活動后绸吸，可以免費(fèi)或低價領(lǐng)取獎品婉烟。流程大致如下圖：
這個過程娩井，實(shí)際上用到了企業(yè)微信API中的不少能力，包括：生成企微員工【聯(lián)系我】二維碼圖像似袁、客戶添加企微員工后自動發(fā)送歡迎語等洞辣。
一. 【聯(lián)系我】二維碼：
官方API介紹：
https://work.weixin.qq.com/api/doc/90001/90143/92577
我們可以調(diào)用該接口生成任意單人或多人隨機(jī)的二維碼圖，并將此圖與設(shè)計(jì)好的營銷海報(bào)合成為最終列表海報(bào)昙衅。
在實(shí)際設(shè)計(jì)過程中扬霜，有以下內(nèi)容需要注意的：
- 生成的二維碼，掃出來以后是單人還是多人的問題而涉。若設(shè)置為多人著瓶，掃碼出人的規(guī)則是由企業(yè)微信設(shè)置的，我們不可控制啼县，實(shí)際測試并未發(fā)現(xiàn)明顯的規(guī)律材原。若需控制掃碼出人的規(guī)律，建議此處設(shè)置為單人碼谭羔，真正的分配人員規(guī)律由自己后臺生成华糖。
- 用戶掃碼后，可無需企微員工驗(yàn)證即添加為好友瘟裸，此功能需在生成二維碼API中設(shè)置skip_verify=true.
- 每個二維碼圖客叉，均可設(shè)置不同的參數(shù)。此參數(shù)可在獲取客戶（外部聯(lián)系人）詳情時拿到话告，結(jié)合這個過程兼搏，通過這個個性化的參數(shù)，可實(shí)現(xiàn)后續(xù)多種定制化服務(wù)沙郭。例如：根據(jù)不同來源的客戶發(fā)送不同的歡迎語佛呻、計(jì)算客戶本人已裂變帶來的新客戶人數(shù)等。需注意：該參數(shù)長度不超過30字符病线。
4.每個生成的二維碼對應(yīng)一個config_id吓著，我們后臺需妥善保存鲤嫡。另外，每個企業(yè)最多生成50萬個绑莺，達(dá)到閾值前建議定時清空歷史數(shù)據(jù)暖眼。
5.該功能需要被展示員工開通了企業(yè)微信客戶聯(lián)系功能、并完成企業(yè)微信激活與實(shí)名認(rèn)證操作纺裁。
二. 外部聯(lián)系人添加事件回調(diào)：
官方API介紹：
https://work.weixin.qq.com/api/doc/90001/90143/92277
外部聯(lián)系人主動或被動添加企業(yè)微信員工時诫肠，均會產(chǎn)生相應(yīng)的回調(diào)事件，我們需進(jìn)行記錄欺缘，用于后續(xù)的發(fā)送歡迎語的操作栋豫。
在回調(diào)事件中，需注意以下內(nèi)容：
- ExternalUserID,即企業(yè)微信體系中外部聯(lián)系人的userID（即裂變帶來的外部微信客戶）谚殊。通過ExternalUserID,可繼續(xù)調(diào)用API——獲取客戶詳情 丧鸯。見后續(xù)介紹。
2.state,即生成二維碼海報(bào)時的自定義參數(shù)络凿÷馑停可識別出該客戶是掃的哪張海報(bào)加入的。對于后續(xù)裂變客戶絮记，此處也可識別出裂變客戶是哪位種子客戶裂變產(chǎn)生的摔踱。
3.welcomecode,可結(jié)合state、與發(fā)送新客戶歡迎語功能怨愤，對該客戶發(fā)送定制化的新人歡迎語派敷。見后續(xù)介紹。
4.注意：外部聯(lián)系人添加的回調(diào)事件撰洗，需配置事件回調(diào)URL篮愉，此處可在企微后臺-客戶聯(lián)系中配置，也可在自建應(yīng)用差导、第三方應(yīng)用進(jìn)行配置试躏，將同時受到該信息。
三. 發(fā)送新客戶歡迎語：
官方API介紹：
https://work.weixin.qq.com/api/doc/90001/90143/92599
該功能的實(shí)現(xiàn)设褐，需要結(jié)合外部聯(lián)系人的回調(diào)事件進(jìn)行觸發(fā)颠蕴，包括外部聯(lián)系人主動與被動添加企微員工的兩種形式均可。
需注意以下幾點(diǎn)內(nèi)容：
（1）企業(yè)微信限定：該接口僅可在收到回調(diào)事件20秒內(nèi)調(diào)用助析，且只可調(diào)用一次犀被，這個需要注意不可超時。
（2）因回調(diào)事件可在多處進(jìn)行配置外冀，所以發(fā)送歡迎語的功能需控制調(diào)用方寡键，避免發(fā)生多處調(diào)用的問題。若出現(xiàn)該種情況雪隧，企業(yè)微信會按照最先調(diào)用的進(jìn)行發(fā)送西轩，其他皆失敗處理员舵。建議此處可按照state類型區(qū)分開調(diào)用方。
（3）發(fā)送的內(nèi)容遭商，最多可發(fā)兩條固灵，即一個文本內(nèi)容與一個（圖片、小程序劫流、H5消息 之一）內(nèi)容。
四. 獲取客戶詳情：
官方API介紹：
https://work.weixin.qq.com/api/doc/90001/90143/92265
外部聯(lián)系人添加入我方企業(yè)后丛忆，會有個唯一ID--External_UserID,通過該ID我們可獲取到該客戶的詳細(xì)信息祠汇。
獲取到該客戶的詳情信息，字段如下：
| 參數(shù) | 說明 |
|---|---|
| errcode | 返回碼 |
| errmsg | 對返回碼的文本描述內(nèi)容 |
| external_userid | 外部聯(lián)系人的userid |
| name | 外部聯(lián)系人的名稱[注1] |
| avatar | 外部聯(lián)系人頭像熄诡，第三方不可獲取 |
| type | 外部聯(lián)系人的類型可很，1表示該外部聯(lián)系人是微信用戶，2表示該外部聯(lián)系人是企業(yè)微信用戶 |
| gender | 外部聯(lián)系人性別 0-未知 1-男性 2-女性 |
| unionid | 外部聯(lián)系人在微信開放平臺的唯一身份標(biāo)識（微信unionid）凰浮，通過此字段企業(yè)可將外部聯(lián)系人與公眾號/小程序用戶關(guān)聯(lián)起來我抠。僅當(dāng)聯(lián)系人類型是微信用戶，且企業(yè)或第三方服務(wù)商綁定了微信開發(fā)者ID有此字段袜茧。查看綁定方法 |
| position | 外部聯(lián)系人的職位菜拓，如果外部企業(yè)或用戶選擇隱藏職位，則不返回笛厦，僅當(dāng)聯(lián)系人類型是企業(yè)微信用戶時有此字段 |
| corp_name | 外部聯(lián)系人所在企業(yè)的簡稱纳鼎，僅當(dāng)聯(lián)系人類型是企業(yè)微信用戶時有此字段 |
| corp_full_name | 外部聯(lián)系人所在企業(yè)的主體名稱，僅當(dāng)聯(lián)系人類型是企業(yè)微信用戶時有此字段 |
| external_profile | 外部聯(lián)系人的自定義展示信息裳凸，可以有多個字段和多種類型贱鄙，包括文本，網(wǎng)頁和小程序姨谷，僅當(dāng)聯(lián)系人類型是企業(yè)微信用戶時有此字段逗宁，字段詳情見對外屬性； |
| follow_user.userid | 添加了此外部聯(lián)系人的企業(yè)成員userid |
| follow_user.remark | 該成員對此外部聯(lián)系人的備注 |
| follow_user.description | 該成員對此外部聯(lián)系人的描述 |
| follow_user.createtime | 該成員添加此外部聯(lián)系人的時間 |
| follow_user.tags.group_name | 該成員添加此外部聯(lián)系人所打標(biāo)簽的分組名稱（標(biāo)簽功能需要企業(yè)微信升級到2.7.5及以上版本） |
| follow_user.tags.tag_name | 該成員添加此外部聯(lián)系人所打標(biāo)簽名稱 |
| follow_user.tags.type | 該成員添加此外部聯(lián)系人所打標(biāo)簽類型, 1-企業(yè)設(shè)置, 2-用戶自定義 |
| follow_user.remark_corp_name | 該成員對此客戶備注的企業(yè)名稱 |
| follow_user.remark_mobiles | 該成員對此客戶備注的手機(jī)號碼梦湘，第三方不可獲取 |
| follow_user.add_way | 該成員添加此客戶的來源瞎颗，具體含義詳見來源定義 |
| follow_user.oper_userid | 發(fā)起添加的userid，如果成員主動添加践叠，為成員的userid言缤；如果是客戶主動添加，則為客戶的外部聯(lián)系人userid禁灼；如果是內(nèi)部成員共享/管理員分配管挟，則為對應(yīng)的成員/管理員userid |
| follow_user.state | 企業(yè)自定義的state參數(shù)，用于區(qū)分客戶具體是通過哪個「聯(lián)系我」添加弄捕，由企業(yè)通過創(chuàng)建「聯(lián)系我」方式指定 |
需注意的是：客戶詳情的UnionID僻孝，可用來關(guān)聯(lián)此客戶的企微環(huán)境信息與微信環(huán)境信息导帝。實(shí)際操作中，在客戶看到海報(bào)并掃碼進(jìn)入H5頁面時穿铆，即獲取UnionID您单，并關(guān)聯(lián)H5頁面填寫的部分信息（如手機(jī)號、姓名荞雏、地區(qū)等）虐秦，再結(jié)合企微的UnionID，可完成企微環(huán)境與微信環(huán)境的信息打通凤优。
