企业微信二次开发：用 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$ 秒的随机延时，模拟人类的手动修改速度，保障账号安全。