当我们锁定了 QiApi 平台，我为你准备了一段基于 Python 的核心演示代码。这段代码集成了两个最常用的自动化场景：生成自动加人的二维码 以及 发送定时群发任务。

准备工作
1. 在 QiApi 官网 获取你的 BASE_URL 和 ACCESS_TOKEN。
2. 确保你的服务器 IP 已在 QiApi 后台的白名单中。

Python 实战 Demo
Python
下载代码
复制代码
import
 requests
import
 json

class QiApiManager:
    def __init__(self, base_url, token):
        self.base_url = base_url
        self.token = token
        self.headers = {
"Content-Type": "application/json"
}

    # 1. 生成【自动通过】的加人二维码
    def create_auto_add_qr(self, user_ids, state="default_source"):
        url = 
f"{self.base_url}/externalcontact/add_contact_way?access_token={self.token}"
        payload = {
            "type": 2,          # 1-单人, 2-多人分流
            "scene": 2,         # 2-二维码
            "skip_verify": True, # 【关键】开启后自动通过好友申请
            "state": state,      # 渠道标识
            "user": user_ids     # 负责接待的成员UserID列表
        }
        response = requests.post(url, json=payload, headers=self.headers)
        return
 response.json()

    # 2. 创建【营销群发】任务
    def create_group_broadcast(self, sender_id, content, link_url, link_title):
        url = 
f"{self.base_url}/externalcontact/add_msg_template?access_token={self.token}"
        payload = {
            "chat_type": "single", # single-发给个人, group-发给群
            "sender": sender_id,   # 执行发送任务的员工ID
            "text"
: {
                "content"
: content
            },
            "attachments"
: [
                {
                    "msgtype": "link"
,
                    "link"
: {
                        "title"
: link_title,
                        "url"
: link_url,
                        "picurl": "https://your-image-url.com/poster.jpg" # 封面图
                    }
                }
            ]
        }
        response = requests.post(url, json=payload, headers=self.headers)
        return
 response.json()

# --- 调用示例 ---

# 替换为你的 QiApi 实际地址和 Token
QI_API_URL = 
"https://api.qiweapi.com" 
MY_TOKEN = 
"你的_ACCESS_TOKEN"

manager = QiApiManager(QI_API_URL, MY_TOKEN)

# 场景一：生成一个自动加人的活码
qr_result = manager.create_auto_add_qr([
"UserID_001", "UserID_002"], state="Tiktok_Ads"
)
print(
"二维码链接:", qr_result.get("qr_code"
))

# 场景二：执行定时群发（逻辑上你可以在特定时间点调用此函数）
msg_result = manager.create_group_broadcast(
    sender_id=
"UserID_001"
,
    content=
"🔔 亲爱的客户，本周秒杀活动即将开始！"
,
    link_url=
"https://yourshop.com/sale"
,
    link_title=
"点击抢购限量优惠券"
)
print(
"群发任务状态:"
, msg_result)

💡 核心逻辑解析（结合 QiApi 文档）
1. 关于 skip_verify (自动通过)
这是 QiApi 封装中最实用的功能。在原生企业微信中，你需要处理复杂的参数，而在 QiApi 接口里，只需传 True。开启后，客户扫码直接变为好友，系统会立即通过 Webhook 推送 “添加成功” 事件给你。
2. 关于 state 参数 (精准营销的基础)
建议为每个推广渠道生成不同的二维码。例如：
• 抖音来的设为 state: "TikTok"
• 线下门店设为 state: "Store_01"
这样当用户加进来时，你的后台可以根据这个 
state 自动给客户打上标签。
3. 关于群发确认
这段代码执行后，员工 UserID_001 的企业微信会收到一个 “群发助手” 的通知。员工只需要点击“发送”即可。这是官方 API 的硬性规定，目前 QiApi 平台也是遵循这一逻辑以保证账号安全。

接下来建议：
1. 测试 Webhook：在 QiApi 后台配置一个回调地址，尝试扫一次码，看看你的服务器能不能收到加人成功的 JSON 数据。
2. 素材准备：群发接口支持 media_id（图片、视频），你可以通过 QiApi 的素材上传接口预先上传。