做企微二次开发时最头疼的一件事员工在 CRM 里有个内部ID客户在企微里有个external_userid两边对不上。我上周刚遇到——客户A先被销售李添加成好友external_useridext_001后来又加了销售张external_useridext_002CRM 里两个不同的外部用户其实是同一个微信用户。先理清楚到底有哪些IDID归属来源特点userid(uin)内部员工contact/getSyncList企微内唯一永不变external_userid外部客户客户列表、Webhook事件同一微信用户被不同员工添加会有多个external_useridopenid微信用户微信OAuth/JS-SDK单应用内唯一unionid微信用户微信开放平台跨应用可识别同一用户映射方案一靠归属关系推荐企微客户有个归属员工ownerUserId在拉客户列表时会一起返回resp requests.get( f{BASE}/wx-api/api/contact/getExternalContactList, headersHEADERS, params{cursor: cursor, limit: 50} ) # 返回每条客户记录里有 externalUserId ownerUserId归属员工的uin拿到之后在自己的数据库里建三张表Eyun 返回的 id 全部是 int64 类型存的时候用 bigint 不要用 varchar-- 内部员工 staff(userid, name, department) -- 外部客户去重后一个微信用户一条 customer(customer_id, unionid, nickname, avatar) -- 企微关系一个微信用户被多少个员工加好友就有多少条 wecom_relation(external_userid, customer_id, owner_userid, added_at)核心思路external_userid永远不能当客户的唯一标识得用unionid或者微信昵称头像组合来做去重external_userid只是关系表的外键。映射方案二靠 add_external_contact 事件新客户添加时Webhook 会推送add_external_contact事件payload 里同时带了userid添加方内部员工和external_userid被添加方外部客户{ event: add_external_contact, eventDetail: { userid: staff_uin_xxx, externalUserId: ext_abc123, state: from_live, nickname: 张先生 } }收到事件时直接更新关系表比轮询客户列表实时得多。我建议两个方案都用事件做实时更新客户列表做每日全量对账。同一个人多个 external_userid 怎么去重这是最烦的场景。客户同时加了李、王、赵三个销售就有三个external_userid。企微 API 不直接返回unionid那是微信侧的只有客户自己的微信里才能拿到。实际做法先用external_userid ownerUserId建唯一键避免关系表重复同一微信用户的多个external_userid靠昵称头像URL的组合判断是否同一个人如果有条件让客户通过 OAuth2 授权之前写过的 OAuth2 网页授权接口拿到unionid后就能精准去重# 拉客户详情时拿到微信头像URL detail requests.get( f{BASE}/wx-api/api/contact/getUserProfileDetail, headersHEADERS, params{externalUserId: ext_id} ) avatar_hash md5(detail[data][avatarUrl]) # 头像URL的hash用来模糊匹配打通后能做什么内部CRM里一个客户有多个企微好友的场景就能统一了给客户发消息时选任意一个有归属关系的员工的external_userid都能送到做销售业绩统计时同一个客户在不同销售名下不会重复计数。总结下来就一句话external_userid是关系ID谁加的谁不是用户ID这个人是谁。把这两个概念分开映射就通了。
做企微二次开发时最头疼的一件事员工在 CRM 里有个内部ID客户在企微里有个external_userid两边对不上。我上周刚遇到——客户A先被销售李添加成好友external_useridext_001后来又加了销售张external_useridext_002CRM 里两个不同的外部用户其实是同一个微信用户。先理清楚到底有哪些IDID归属来源特点userid(uin)内部员工contact/getSyncList企微内唯一永不变external_userid外部客户客户列表、Webhook事件同一微信用户被不同员工添加会有多个external_useridopenid微信用户微信OAuth/JS-SDK单应用内唯一unionid微信用户微信开放平台跨应用可识别同一用户映射方案一靠归属关系推荐企微客户有个归属员工ownerUserId在拉客户列表时会一起返回resp requests.get( f{BASE}/wx-api/api/contact/getExternalContactList, headersHEADERS, params{cursor: cursor, limit: 50} ) # 返回每条客户记录里有 externalUserId ownerUserId归属员工的uin拿到之后在自己的数据库里建三张表Eyun 返回的 id 全部是 int64 类型存的时候用 bigint 不要用 varchar-- 内部员工 staff(userid, name, department) -- 外部客户去重后一个微信用户一条 customer(customer_id, unionid, nickname, avatar) -- 企微关系一个微信用户被多少个员工加好友就有多少条 wecom_relation(external_userid, customer_id, owner_userid, added_at)核心思路external_userid永远不能当客户的唯一标识得用unionid或者微信昵称头像组合来做去重external_userid只是关系表的外键。映射方案二靠 add_external_contact 事件新客户添加时Webhook 会推送add_external_contact事件payload 里同时带了userid添加方内部员工和external_userid被添加方外部客户{ event: add_external_contact, eventDetail: { userid: staff_uin_xxx, externalUserId: ext_abc123, state: from_live, nickname: 张先生 } }收到事件时直接更新关系表比轮询客户列表实时得多。我建议两个方案都用事件做实时更新客户列表做每日全量对账。同一个人多个 external_userid 怎么去重这是最烦的场景。客户同时加了李、王、赵三个销售就有三个external_userid。企微 API 不直接返回unionid那是微信侧的只有客户自己的微信里才能拿到。实际做法先用external_userid ownerUserId建唯一键避免关系表重复同一微信用户的多个external_userid靠昵称头像URL的组合判断是否同一个人如果有条件让客户通过 OAuth2 授权之前写过的 OAuth2 网页授权接口拿到unionid后就能精准去重# 拉客户详情时拿到微信头像URL detail requests.get( f{BASE}/wx-api/api/contact/getUserProfileDetail, headersHEADERS, params{externalUserId: ext_id} ) avatar_hash md5(detail[data][avatarUrl]) # 头像URL的hash用来模糊匹配打通后能做什么内部CRM里一个客户有多个企微好友的场景就能统一了给客户发消息时选任意一个有归属关系的员工的external_userid都能送到做销售业绩统计时同一个客户在不同销售名下不会重复计数。总结下来就一句话external_userid是关系ID谁加的谁不是用户ID这个人是谁。把这两个概念分开映射就通了。
