企微的标签看起来简单背后其实藏着两套独立体系企业标签和个人标签。我之前做客户分层的时候踩了个大坑——给一批客户打了高意向企业标签结果另一个同事同时在企微里手动改了几个客户的个人标签我的API调用把那几个客户的所有标签都覆盖掉了。先搞清楚标签分两种类型谁来管API可控典型场景企业标签管理员在企微后台创建✅ 全部可控高意向已成交待跟进个人标签员工自己在手机端创建❌ API拿不到员工个人的备忘标记Eyun的标签模块/wx-api/api/label/*只覆盖企业标签个人标签是员工私有的任何第三方API都读不到也改不了。做客户分层的时候一定要把这个边界讲清楚别想着靠API统一管理所有标签——做不到。企业标签怎么创建和查询# 创建企业标签 requests.post( f{BASE}/wx-api/api/label/createLabel, headersHEADERS, json{ labelName: 高意向客户, groupId: group_xxx # 标签分组可选 } ) # 查询全部企业标签 resp requests.get( f{BASE}/wx-api/api/label/getLabelList, headersHEADERS ) # 返回企业标签数组每条有 labelId、labelName、groupId查询返回的labelId是给客户打标签时要用的别直接用 labelName——企微允许同名标签name 不能当唯一标识。给客户打标签覆盖式不是追加这是我踩过的最痛的坑。企微API给客户打标签的接口是/wx-api/api/contact/updateLabel传进去什么标签列表客户身上就变成什么——直接覆盖不会追加。正确的流程必须三步# 第一步先拉客户现有标签 profile requests.get( f{BASE}/wx-api/api/contact/getUserProfileDetail, headersHEADERS, params{externalUserId: external_userid} ) existing_labels profile[data].get(labels, []) # 现有标签ID数组 # 第二步合并要加的标签 new_label_id lbl_high_intent_123 if new_label_id not in existing_labels: existing_labels.append(new_label_id) # 第三步把合并后的完整列表写回去 requests.post( f{BASE}/wx-api/api/contact/updateLabel, headersHEADERS, json{ externalUserId: external_userid, labels: existing_labels # 完整列表不是增量 } )直接跳第一步把labels: [new_label_id]传上去等于把客户身上原来的标签全清了只留你新打的那个——别问我怎么知道的我们团队500个客户的标签数据那次全乱了花了三天手动恢复。客户分层怎么做用企业标签做分层的核心思路建企业标签 → 给客户打标签 → 拉客户列表时按标签过滤。Eyun 的contact/getExternalContactList接口支持传tagIdList参数一次拉某个分层的全部客户。requests.post( f{BASE}/wx-api/api/contact/getExternalContactList, headersHEADERS, json{tagIdList: [lbl_high_intent_123, lbl_vip_456]} # 多个标签取交集 )一个客户可以同时有多个标签既是高意向又是VIP用 API 按标签查询时tagIdList是交集逻辑——同时拥有这几个标签的客户才会返回。要做并集就得自己拉多次然后合并。总结企业标签API可控个人标签API不可控别混淆给客户打标签永远是覆盖式必须先拉再合客户分层靠企业标签筛选交集查询要自己处理并集
企微的标签看起来简单背后其实藏着两套独立体系企业标签和个人标签。我之前做客户分层的时候踩了个大坑——给一批客户打了高意向企业标签结果另一个同事同时在企微里手动改了几个客户的个人标签我的API调用把那几个客户的所有标签都覆盖掉了。先搞清楚标签分两种类型谁来管API可控典型场景企业标签管理员在企微后台创建✅ 全部可控高意向已成交待跟进个人标签员工自己在手机端创建❌ API拿不到员工个人的备忘标记Eyun的标签模块/wx-api/api/label/*只覆盖企业标签个人标签是员工私有的任何第三方API都读不到也改不了。做客户分层的时候一定要把这个边界讲清楚别想着靠API统一管理所有标签——做不到。企业标签怎么创建和查询# 创建企业标签 requests.post( f{BASE}/wx-api/api/label/createLabel, headersHEADERS, json{ labelName: 高意向客户, groupId: group_xxx # 标签分组可选 } ) # 查询全部企业标签 resp requests.get( f{BASE}/wx-api/api/label/getLabelList, headersHEADERS ) # 返回企业标签数组每条有 labelId、labelName、groupId查询返回的labelId是给客户打标签时要用的别直接用 labelName——企微允许同名标签name 不能当唯一标识。给客户打标签覆盖式不是追加这是我踩过的最痛的坑。企微API给客户打标签的接口是/wx-api/api/contact/updateLabel传进去什么标签列表客户身上就变成什么——直接覆盖不会追加。正确的流程必须三步# 第一步先拉客户现有标签 profile requests.get( f{BASE}/wx-api/api/contact/getUserProfileDetail, headersHEADERS, params{externalUserId: external_userid} ) existing_labels profile[data].get(labels, []) # 现有标签ID数组 # 第二步合并要加的标签 new_label_id lbl_high_intent_123 if new_label_id not in existing_labels: existing_labels.append(new_label_id) # 第三步把合并后的完整列表写回去 requests.post( f{BASE}/wx-api/api/contact/updateLabel, headersHEADERS, json{ externalUserId: external_userid, labels: existing_labels # 完整列表不是增量 } )直接跳第一步把labels: [new_label_id]传上去等于把客户身上原来的标签全清了只留你新打的那个——别问我怎么知道的我们团队500个客户的标签数据那次全乱了花了三天手动恢复。客户分层怎么做用企业标签做分层的核心思路建企业标签 → 给客户打标签 → 拉客户列表时按标签过滤。Eyun 的contact/getExternalContactList接口支持传tagIdList参数一次拉某个分层的全部客户。requests.post( f{BASE}/wx-api/api/contact/getExternalContactList, headersHEADERS, json{tagIdList: [lbl_high_intent_123, lbl_vip_456]} # 多个标签取交集 )一个客户可以同时有多个标签既是高意向又是VIP用 API 按标签查询时tagIdList是交集逻辑——同时拥有这几个标签的客户才会返回。要做并集就得自己拉多次然后合并。总结企业标签API可控个人标签API不可控别混淆给客户打标签永远是覆盖式必须先拉再合客户分层靠企业标签筛选交集查询要自己处理并集
