将企业微信机器人API接入现有的企业内部系统，需要严格遵循企业微信开放平台的通信协议规范。本文提供一套标准化的协议接入与联调指南。

一、 接入前置条件

1. 企业微信后台配置：

   • 在“应用管理”或“微信客服”中创建应用，获取 CorpID、Secret。

   • 配置可信IP白名单（防止凭证泄露后被恶意调用）。

   • 配置“接收消息服务器URL”并生成 Token 与 EncodingAESKey。

二、 核心API接口清单

三、 代码实战：获取 Access Token 与发送主动消息

使用 Python 的 requests 库实现凭证获取与消息下发：

import requests
import json

CORPID = "YOUR_CORPID"
SECRET = "YOUR_SECRET"

def get_access_token(corpid, secret):
    url = f"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={corpid}&corpsecret={secret}"
    response = requests.get(url)
    data = response.json()
    if "access_token" in data:
        return data["access_token"]
    else:
        raise Exception(f"Failed to get token: {data}")

def send_kf_message(access_token, touser, open_kfid, content):
    url = f"https://qyapi.weixin.qq.com/cgi-bin/kf/send_msg?access_token={access_token}"
    payload = {
        "touser": touser,
        "open_kfid": open_kfid,
        "msgtype": "text",
        "text": {
            "content": content
        }
    }
    response = requests.post(url, data=json.dumps(payload))
    return response.json()