对于企业营销或个人私域运营者而言，弄清楚自己的微信号里有多少好友、多少个群，以及每个人的标签至关重要。E云管家 API 提供了直接拉取完整通讯录的接口，无需人工翻看。
接下来我们看看如何通过网络请求把这些信息结构化地拉取下来：
import json import requests BASE_URL = "http://api.e-yun-guanjia.com/v1" TOKEN = "your_token" INSTANCE_ID = "ins_999" def fetch_contact_list(): """使用 E云管家 api 批量获取微信通讯录列表""" url = f"{BASE_URL}/contact/get_list" headers = {"Authorization": f"Bearer {TOKEN}"} payload = { "instance_id": INSTANCE_ID, "type": "all" # all:全部，friend:好友，group:群聊 } response = requests.post(url, json=payload, headers=headers) if response.status_code != 200: print("请求失败") return res_data = response.json() contacts = res_data.get("data", {}).get("list", []) print(f"成功获取到 {len(contacts)} 个联系人/群聊数据。") # 筛选并保存到本地 friends = [] groups = [] for c in contacts: if "chatroom" in c.get("wxid", ""): groups.append({"group_id": c.get("wxid"), "nickname": c.get("nickname")}) else: friends.append({"wxid": c.get("wxid"), "nickname": c.get("nickname"), "remark": c.get("remark")}) with open("my_friends.json", "w", encoding="utf-8") as f: json.dump(friends, f, ensure_ascii=False, indent=4) print("好友列表已成功导出为 JSON 文件。") if __name__ == "__main__": fetch_contact_list()实战扩展：获取到好友的wxid和备注（remark）后，你可以将其与内部的 CRM 系统对接。当收到客户通过E云管家 api转发过来的消息时，可以瞬间在后台弹屏显示该客户在 CRM 中的购买记录、服务周期等，极大地赋能私域导购场景。
