企业微信二次开发：用 Python 跑通联系人管理核心业务流

在私域流量运营中，对加进来的好友进行标签细分和备注规范，是后续精准推送的前提。很多刚接触企业微信二次开发的同学，往往不知道如何把“查询”、“改名”、“打标”这几个动作有机地串联起来。

本文直接分享一段纯干货代码。我们只用一个脚本，便能优雅地完成对外部联系人资料的读取与动态修改，帮助大家在实际生产中快速对接 CRM 系统。

一、 核心业务逻辑实现

在实际场景中，我们往往需要：

1. 先读取客户在微信端的真实头像和昵称。

2. 结合系统数据，动态为客户生成统一格式的备注（例如：VIP_昵称）。

3. 为其打上对应的企业标签（如高意向、2026年首单），便于后续精准运营。

参考官方在线文档：平台介绍 - QiWe开放平台

二、 实战源码：联系人信息同步与打标闭环

以下是完整的 Python 脚本。你只需要将其保存为contact_workflow.py，修改头部的 Token 和 GUID，即可一键运行：

import requests import json import time # ==================== 1. 基础配置区 ==================== # 官方统一入口与文档地址参考: https://doc.qiweapi.com/ OFFICIAL_API_URL = "http://manager.qiweapi.com/qiwe/api/qw/doApi" X_QIWEI_TOKEN = "YOUR_OFFICIAL_TOKEN_HERE" # 替换为你的真实 Token DEVICE_GUID = "YOUR_DEVICE_GUID_HERE" # 替换为你的设备 GUID TARGET_WXID = "external_wxid_example_123" # 替换为需要测试的联系人微信ID # ==================== 2. 核心业务工作流 ==================== def run_contact_workflow(userid): headers = { "X-QIWEI-TOKEN": X_QIWEI_TOKEN, "Content-Type": "application/json" } print(f"🎬 开始处理联系人: {wxid}...") # ---------------- 主动查询联系人当前资料 ---------------- get_payload = { "method": "/contact/getContactDetails", "params": { "guid": DEVICE_GUID, "toid":userid } }

三、 避坑指南

1. tags参数覆盖风险：

   在官方接口设计中，/contact/setRemarkAndTag的tags数组通常会直接覆盖此人原有的标签。如果你只想给客户“追加”标签，建议先在“步骤一”中提取出客户已有的标签数组，与新标签做并集去重后，再在“步骤二”中统一提交。

2. 操作频率限制：

   修改备注和打标签是敏感动作。如果有大批量的客户需要打标，切勿使用多线程并发修改。建议在for循环中加入 $1\sim2$ 秒的随机延时，模拟人类的手动修改速度，保障账号安全。