最近，不少行業(yè)都開始使用企業(yè)微信來進(jìn)行客戶裂變了，常見的裂變套路包括：分享海報(bào)添加企業(yè)微信員工或加入企業(yè)微信外部客戶群并完成邀請助力活動(dòng)后，可以免費(fèi)或低價(jià)領(lǐng)取獎(jiǎng)品。流程大致如下圖：
這個(gè)過程，實(shí)際上用到了企業(yè)微信API中的不少能力，包括：生成企微員工【聯(lián)系我】二維碼圖像、客戶添加企微員工后自動(dòng)發(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ī)律由自己后臺(tái)生成。
- 用戶掃碼后，可無需企微員工驗(yàn)證即添加為好友，此功能需在生成二維碼API中設(shè)置skip_verify=true.
- 每個(gè)二維碼圖，均可設(shè)置不同的參數(shù)。此參數(shù)可在獲取客戶（外部聯(lián)系人）詳情時(shí)拿到，結(jié)合這個(gè)過程，通過這個(gè)個(gè)性化的參數(shù)，可實(shí)現(xiàn)后續(xù)多種定制化服務(wù)。例如：根據(jù)不同來源的客戶發(fā)送不同的歡迎語、計(jì)算客戶本人已裂變帶來的新客戶人數(shù)等。需注意：該參數(shù)長度不超過30字符。
4.每個(gè)生成的二維碼對(duì)應(yīng)一個(gè)config_id，我們后臺(tái)需妥善保存。另外，每個(gè)企業(yè)最多生成50萬個(gè)，達(dá)到閾值前建議定時(shí)清空歷史數(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)系人主動(dòng)或被動(dòng)添加企業(yè)微信員工時(shí)，均會(huì)產(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í)的自定義參數(shù)?？勺R(shí)別出該客戶是掃的哪張海報(bào)加入的。對(duì)于后續(xù)裂變客戶，此處也可識(shí)別出裂變客戶是哪位種子客戶裂變產(chǎn)生的。
3.welcomecode,可結(jié)合state、與發(fā)送新客戶歡迎語功能，對(duì)該客戶發(fā)送定制化的新人歡迎語。見后續(xù)介紹。
4.注意：外部聯(lián)系人添加的回調(diào)事件，需配置事件回調(diào)URL，此處可在企微后臺(tái)-客戶聯(lián)系中配置，也可在自建應(yīng)用、第三方應(yīng)用進(jìn)行配置，將同時(shí)受到該信息。
三. 發(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)系人主動(dòng)與被動(dòng)添加企微員工的兩種形式均可。
需注意以下幾點(diǎn)內(nèi)容：
（1）企業(yè)微信限定：該接口僅可在收到回調(diào)事件20秒內(nèi)調(diào)用，且只可調(diào)用一次，這個(gè)需要注意不可超時(shí)。
（2）因回調(diào)事件可在多處進(jìn)行配置，所以發(fā)送歡迎語的功能需控制調(diào)用方，避免發(fā)生多處調(diào)用的問題。若出現(xiàn)該種情況，企業(yè)微信會(huì)按照最先調(diào)用的進(jìn)行發(fā)送，其他皆失敗處理。建議此處可按照state類型區(qū)分開調(diào)用方。
（3）發(fā)送的內(nèi)容，最多可發(fā)兩條，即一個(gè)文本內(nèi)容與一個(gè)（圖片、小程序、H5消息 之一）內(nèi)容。
四. 獲取客戶詳情：
官方API介紹：
https://work.weixin.qq.com/api/doc/90001/90143/92265
外部聯(lián)系人添加入我方企業(yè)后，會(huì)有個(gè)唯一ID--External_UserID,通過該ID我們可獲取到該客戶的詳細(xì)信息。
獲取到該客戶的詳情信息，字段如下：
| 參數(shù) | 說明 |
|---|---|
| errcode | 返回碼 |
| errmsg | 對(duì)返回碼的文本描述內(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)系人在微信開放平臺(tái)的唯一身份標(biāo)識(shí)（微信unionid），通過此字段企業(yè)可將外部聯(lián)系人與公眾號(hào)/小程序用戶關(guān)聯(lián)起來。僅當(dāng)聯(lián)系人類型是微信用戶，且企業(yè)或第三方服務(wù)商綁定了微信開發(fā)者ID有此字段。查看綁定方法 |
| position | 外部聯(lián)系人的職位，如果外部企業(yè)或用戶選擇隱藏職位，則不返回，僅當(dāng)聯(lián)系人類型是企業(yè)微信用戶時(shí)有此字段 |
| corp_name | 外部聯(lián)系人所在企業(yè)的簡稱，僅當(dāng)聯(lián)系人類型是企業(yè)微信用戶時(shí)有此字段 |
| corp_full_name | 外部聯(lián)系人所在企業(yè)的主體名稱，僅當(dāng)聯(lián)系人類型是企業(yè)微信用戶時(shí)有此字段 |
| external_profile | 外部聯(lián)系人的自定義展示信息，可以有多個(gè)字段和多種類型，包括文本，網(wǎng)頁和小程序，僅當(dāng)聯(lián)系人類型是企業(yè)微信用戶時(shí)有此字段，字段詳情見對(duì)外屬性； |
| follow_user.userid | 添加了此外部聯(lián)系人的企業(yè)成員userid |
| follow_user.remark | 該成員對(duì)此外部聯(lián)系人的備注 |
| follow_user.description | 該成員對(duì)此外部聯(lián)系人的描述 |
| follow_user.createtime | 該成員添加此外部聯(lián)系人的時(shí)間 |
| follow_user.tags.group_name | 該成員添加此外部聯(lián)系人所打標(biāo)簽的分組名稱（標(biāo)簽功能需要企業(yè)微信升級(jí)到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 | 該成員對(duì)此客戶備注的企業(yè)名稱 |
| follow_user.remark_mobiles | 該成員對(duì)此客戶備注的手機(jī)號(hào)碼，第三方不可獲取 |
| follow_user.add_way | 該成員添加此客戶的來源，具體含義詳見來源定義 |
| follow_user.oper_userid | 發(fā)起添加的userid，如果成員主動(dòng)添加，為成員的userid；如果是客戶主動(dòng)添加，則為客戶的外部聯(lián)系人userid；如果是內(nèi)部成員共享/管理員分配，則為對(duì)應(yīng)的成員/管理員userid |
| follow_user.state | 企業(yè)自定義的state參數(shù)，用于區(qū)分客戶具體是通過哪個(gè)「聯(lián)系我」添加，由企業(yè)通過創(chuàng)建「聯(lián)系我」方式指定 |
需注意的是：客戶詳情的UnionID，可用來關(guān)聯(lián)此客戶的企微環(huán)境信息與微信環(huán)境信息。實(shí)際操作中，在客戶看到海報(bào)并掃碼進(jìn)入H5頁面時(shí)，即獲取UnionID，并關(guān)聯(lián)H5頁面填寫的部分信息（如手機(jī)號(hào)、姓名、地區(qū)等），再結(jié)合企微的UnionID，可完成企微環(huán)境與微信環(huán)境的信息打通。
