零门槛搭建企业微信私域流量自动曝光系统

前言

本文将带你使用Python语言，基于企业微信官方API，从零构建一套私域流量自动曝光系统。这套系统不依赖任何第三方付费软件，直接利用企业微信的“应用消息”和“群机器人”接口，实现向指定员工或客户群自动推送图文、卡片等富媒体消息，极大提升私域运营触达效率。

第一步：获取企业微信接口凭证

在编写代码前，必须先在企业微信管理后台获取三个核心参数：CorpId、AgentId、Secret，并配置服务器IP白名单。

1. 获取CorpId（企业ID）

登录企业微信管理后台（https://work.weixin.qq.com），点击顶部导航栏的“我的企业”，在页面最下方“企业信息”栏中，即可看到企业ID。将其复制并保存到记事本。

2. 创建自建应用并获取凭证

在管理后台点击“应用管理” -> “应用” -> “自建”。点击右上角“创建应用”，输入应用名称（如“私域曝光助手”），选择可见范围（建议选择需要接收消息的部门或全员）。

创建成功后，进入应用详情页。在“应用信息”栏中，复制AgentId和Secret。Secret默认是隐藏的，点击“查看”并扫码验证后即可获取。请务必妥善保存Secret。

3. 配置可信IP（关键步骤）

如果不配置此步骤，调用API时会返回“ip not in whitelist”错误。在应用详情页找到“开发者接口”部分，点击“配置可信IP”。将你运行Python脚本的服务器的公网IP地址填入。如果是本地测试，可以在百度搜索“IP”获取本机公网IP。输入后点击保存。

第二步：搭建Python开发环境

确保你的电脑已安装Python（建议3.6及以上版本）。打开终端（CMD或PowerShell），安装官方请求库requests。这是唯一需要依赖的第三方库。

执行以下命令：

```bash pip install requests ```

第三步：编写核心API调用代码

新建一个文件名为wecom_exposure.py。我们将编写三个核心函数：获取Access Token、发送应用消息、发送群机器人消息。

1. 获取Access Token

企业微信的所有API调用都需要携带Access Token，有效期通常为2小时。我们需要一个函数来动态获取它。

```python import requests import json 替换为你刚才获取的凭证 CORP_ID = 'wwxxxxxxxxxxxxxxxxx' SECRET = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' AGENT_ID = 1000002 def get_access_token(corp_id, secret): url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken" params = { "corpid": corp_id, "corpsecret": secret } response = requests.get(url, params=params) result = response.json() if result['errcode'] == 0: return result['access_token'] else: print(f"获取Token失败: {result}") return None ```

2. 发送文本消息给指定成员

这是私域曝光的基础功能。通过touser参数指定接收消息的成员账号（通常为手机号或自定义UserID）。

```python def send_text_message(access_token, agent_id, user_id, content): url = f"https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={access_token}" data = { "touser": user_id, 接收者ID，如果是多人用'|'分隔，如 "UserID1|UserID2" "msgtype": "text", "agentid": agent_id, "text": { "content": content }, "safe": 0 } response = requests.post(url, data=json.dumps(data)) result = response.json() if result['errcode'] == 0: print(f"消息发送成功给: {user_id}") else: print(f"消息发送失败: {result}") ```

3. 发送图文卡片消息（高曝光率）

纯文本曝光效果有限，图文卡片（News消息）包含标题、描述、链接和图片，点击率更高。

```python def send_news_message(access_token, agent_id, user_id, title, description, url, pic_url): api_url = f"https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={access_token}" data = { "touser": user_id, "msgtype": "news", "agentid": agent_id, "news": { "articles": [ { "title": title, "description": description, "url": url, "picurl": pic_url } ] }, "safe": 0 } response = requests.post(api_url, data=json.dumps(data)) result = response.json() if result['errcode'] == 0: print(f"图文卡片发送成功给: {user_id}") else: print(f"图文卡片发送失败: {result}") ```

第四步：利用群机器人实现群内高频曝光

除了点对点通知，群聊是私域流量聚集地。企业微信支持群机器人，我们可以在群内添加机器人，通过Webhook地址推送消息。

1. 获取群Webhook地址

在目标企业微信群聊中，点击右上角“...” -> “群机器人” -> “添加机器人”。输入机器人名称（如“曝光播报”），创建后会生成一个Webhook地址（以https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=...开头）。复制该地址。

2. 编写群消息推送代码

机器人支持Markdown格式，可以发送结构化的高亮信息。

```python def send_group_robot_message(webhook_url, content): url = webhook_url data = { "msgtype": "markdown", "markdown": { "content": content } } headers = {"Content-Type": "application/json"} response = requests.post(url, data=json.dumps(data), headers=headers) result = response.json() if result['errcode'] == 0: print("群消息发送成功") else: print(f"群消息发送失败: {result}") ```

第五步：完整运行脚本与实操演示

将上述函数整合，编写main入口函数。请注意，user_id必须是企业微信通讯录中已存在的成员账号。你可以在管理后台“通讯录” -> 点击成员名字查看“账号”字段获取。

```python def main(): 1. 获取Token token = get_access_token(CORP_ID, SECRET) if not token: return 2. 配置接收者 提示：请确保这里的UserID在你的企业微信通讯录中真实存在 target_user = "zhangsan" 3. 发送文本提醒 text_content = "【私域曝光】今日新上架的技术实操文档已更新，请查收。" send_text_message(token, AGENT_ID, target_user, text_content) 4. 发送图文卡片（例如推广一篇技术博客） pic_url建议使用正方形图片，效果最佳 send_news_message( token, AGENT_ID, target_user, "企业微信自动化开发指南", "点击查看完整的API调用文档与代码示例，零门槛上手。", "https://www.baidu.com/img/flexible/logo/pc/result.png", 示例图片 "https://work.weixin.qq.com" 点击跳转链接 ) 5. 群机器人曝光（Markdown格式） 替换为你真实的群机器人Webhook robot_webhook = "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" markdown_msg = ( " 私域流量日报\n" ">今日曝光数据统计：\n" "> - 触达人数：50人\n" "> - 点击率：30%\n" ">请相关运营人员注意跟进转化。" ) send_group_robot_message(robot_webhook, markdown_msg) if __name__ == "__main__": main() ```

常见报错处理

在实操过程中，你可能会遇到以下错误，请对照排查：

• errcode: 40014, errmsg: invalid access_token：Token已过期或无效。检查get_access_token函数是否正常调用，每次运行脚本都会重新获取Token，正常情况不会报错。
• errcode: 60020, errmsg: not allow to access from this ip：IP白名单未配置。请返回第一步，检查管理后台应用设置中的“可信IP”是否包含你当前的网络公网IP。
• errcode: 301002, errmsg: invalid user list：接收者UserID错误。请确认touser字段填写的账号与通讯录中的“账号”完全一致，不要使用姓名或昵称。
• errcode: 93000, errmsg: api freq out of limit：接口频率超限。企业微信API有频率限制，不要在死循环中无间隔调用，建议每次发送后增加time.sleep(1)。