企業微信機器人 + 自部署 AI 服務 30 分鐘復現

1. 登入 work.weixin.qq.com（企業管理員）→ 應用管理 → 自建 → 建立應用
2. 填應用名/頭像 → 建立後進入應用詳情，記錄三個值：
   • CorpID（我的企業 → 企業資訊 → 最底部）
   • AgentId（應用詳情頁，純數字）
   • Secret（應用詳情 → Secret → 檢視，關頁面後要重置才能再看）
3. 應用詳情 → 企業可信 IP：填你伺服器的公網出口 IP（少了它調 API 報 60020，見文末報錯 3）
4. 應用詳情 → 接收訊息 → 設定 API 接收：填 Token（自己編一串隨機字串）和 EncodingAESKey（點隨機生成）
5. 「接收訊息」頁會要你填回撥 URL——先不填，第 3 步用 ngrok 拿到公網地址再回來填

企業微信回撥驗證比飛書多一層：GET 請求帶 msg_signature，echostr 是 AES 加密的，必須先解密再原樣返回。這段程式碼直接拷：

import hashlib, base64, struct
from flask import Flask, request, Response
from Crypto.Cipher import AES

app = Flask(__name__)

TOKEN = "你填的Token"
AES_KEY = "你填的EncodingAESKey"  # 43位，程式碼裡補一個"="
CORP_ID = "你的CorpID"

def decrypt_msg(encrypted):
    key = base64.b64decode(AES_KEY + "=")
    cipher = AES.new(key, AES.MODE_CBC, key[:16])
    plain = cipher.decrypt(base64.b64decode(encrypted))
    pad = plain[-1]
    plain = plain[:-pad]                      # 去 PKCS7 填充
    plain = plain[16:]                        # 去 16 位元組隨機串
    msg_len = struct.unpack("!i", plain[:4])[0]
    return plain[4:4 + msg_len].decode()      # 訊息體

def verify_signature(signature, timestamp, nonce, echostr):
    s = "".join(sorted([TOKEN, timestamp, nonce, echostr]))
    return hashlib.sha1(s.encode()).hexdigest() == signature

@app.route("/wecom/callback", methods=["GET"])
def verify_url():
    args = request.args
    if verify_signature(args["msg_signature"], args["timestamp"],
                        args["nonce"], args["echostr"]):
        return Response(decrypt_msg(args["echostr"]), mimetype="text/plain")
    return "signature error", 403

@app.route("/wecom/callback", methods=["POST"])
def receive_msg():
    # 企業微信 POST 的訊息體是 { Encrypt: "..." }，同樣先驗籤再解密
    # 解密後是 XML：text + Content + FromUserName...
    # 這裡先列印日誌，第 4 步換成 AI 呼叫
    return Response("success", mimetype="text/plain")

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8080)

⚠️ 依賴：pip install flask pycryptodome。企業微信要求回撥返回純文字 success（不是 JSON），返回別的會一直重試推送。

1. 執行：ngrok http 8080（或 cloudflared / bore 都行）
2. 複製 https://xxxx.ngrok-free.app 這樣的 URL
3. 回企業微信「接收訊息」→ 填 https://xxxx.ngrok-free.app/wecom/callback → 儲存
4. 儲存時企業微信會立刻 GET 一次驗證 URL——你的 verify_url() 返回解密後的 echostr 就透過，看到「儲存成功」即通

POST 回撥解密後是 XML，用 xml.etree 解析，然後調 AI，再用「傳送應用訊息」API 回給員工：

import requests, xml.etree.ElementTree as ET

def get_access_token():
    url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken"
    r = requests.get(url, params={"corpid": CORP_ID, "corpsecret": SECRET},
                     timeout=10)
    return r.json()["access_token"]          # 2 小時有效，建議快取

def send_to_user(user_id, content):
    token = get_access_token()
    url = "https://qyapi.weixin.qq.com/cgi-bin/message/send"
    requests.post(url, params={"access_token": token}, json={
        "touser": user_id,                    # UserID，不是手機號/姓名
        "msgtype": "text",
        "agentid": AGENT_ID,
        "text": {"content": content}
    }, timeout=10)

# 在 receive_msg() 裡（解密出 xml_str 後）：
root = ET.fromstring(xml_str)
user_id = root.findtext("FromUserName")      # 發訊息的員工 UserID
content = root.findtext("Content")           # 員工發的文字

reply = ask_ai(content)                       # 調你的自部署 AI 服務
send_to_user(user_id, reply)

第一次跑通後，再加：

• 記憶（redis 存 user_id → 對話歷史）
• 知識庫檢索（先查知識庫再調 LLM）
• Skill 呼叫（按模板處理固定流程）

1. 應用詳情 → 可見範圍：先選一個部門（如 IT 部）小範圍試點
2. 把 ngrok 地址換成本機 Nginx 反代（proxy_pass http://127.0.0.1:8080）或直接部署到伺服器
3. 企業微信「我的企業 → 微信外掛」——員工在企業微信裡就能搜到你的應用
4. 給應用發條訊息 → 收到 AI 回覆 → 完成