公众号skill开发入门：从零搭建到消息交互的完整指南

2次阅读

没有评论

共计 4176 个字符，预计需要花费 11 分钟才能阅读完成。

微信公众号开发是指基于微信公众平台提供的开放接口，实现自定义功能和服务的技术开发。公众号 skill 可以用于自动回复、菜单交互、模板消息推送等多种场景，适用于客服系统、内容分发、电商服务等领域。

对于新手来说，微信公众号开发可能显得有些复杂，但只要掌握了核心流程，就能快速上手。本文将从基础环境搭建开始，逐步介绍消息加解密、API 调用等关键环节，帮助你快速入门公众号 skill 开发。

在开始开发之前，你需要完成以下准备工作：

注册公众号
前往微信公众平台 (https://mp.weixin.qq.com/) 注册一个公众号
选择订阅号或服务号类型(服务号功能更全面)
服务器配置
准备一台可公网访问的服务器
确保服务器支持 HTTPS(微信公众号要求所有接口必须使用 HTTPS)
推荐使用 Nginx 或 Apache 作为 Web 服务器
公众号后台设置
进入公众号后台 → 开发 → 基本配置
获取 AppID 和 AppSecret(妥善保管)
配置服务器 URL、Token 和 EncodingAESKey

微信公众号的消息交互采用加密传输，开发者需要实现消息的加解密逻辑。以下是一个 Python 示例：

from Crypto.Cipher import AES
import base64
import hashlib
import xml.etree.ElementTree as ET

class WXBizMsgCrypt:
    def __init__(self, token, encoding_aes_key, app_id):
        self.token = token
        self.app_id = app_id
        self.key = base64.b64decode(encoding_aes_key + "=")
        self.iv = self.key[:16]

    def decrypt(self, encrypted_msg):
        cipher = AES.new(self.key, AES.MODE_CBC, self.iv)
        decrypted = cipher.decrypt(base64.b64decode(encrypted_msg))
        # 处理 PKCS#7 填充
        pad = ord(decrypted[-1])
        content = decrypted[16:-pad]
        xml_len = int(content[:4].decode('utf-8'))
        xml_content = content[4:xml_len+4]
        from_appid = content[xml_len+4:].decode('utf-8')
        return xml_content

# 使用示例
crypt = WXBizMsgCrypt("your_token", "your_encoding_aes_key", "your_appid")
xml_content = crypt.decrypt(encrypted_message)

以下是使用 Node.js 创建自定义菜单的示例代码：

const axios = require('axios');

async function createMenu(accessToken) {
    const menu = {
        "button": [
            {
                "type": "click",
                "name": "今日推荐",
                "key": "V1001_TODAY_RECOMMEND"
            },
            {
                "name": "菜单",
                "sub_button": [
                    {
                        "type": "view",
                        "name": "官网",
                        "url": "http://www.example.com"
                    }
                ]
            }
        ]
    };

    try {
        const response = await axios.post(`https://api.weixin.qq.com/cgi-bin/menu/create?access_token=${accessToken}`,
            menu
        );
        console.log(response.data);
    } catch (error) {console.error('创建菜单失败:', error.response.data);
    }
}

模板消息是公众号向用户推送重要通知的有效方式：

import requests

def send_template_message(access_token, openid, template_id, data):
    url = f"https://api.weixin.qq.com/cgi-bin/message/template/send?access_token={access_token}"
    payload = {
        "touser": openid,
        "template_id": template_id,
        "data": data
    }
    response = requests.post(url, json=payload)
    return response.json()

# 使用示例
data = {"first": {"value":"您好，您有新的订单", "color":"#173177"},
    "orderID": {"value":"123456789", "color":"#173177"},
    "remark": {"value":"请及时处理", "color":"#173177"}
}
send_template_message(access_token, "user_openid", "template_id", data)

微信公众号会推送各种事件通知，如用户关注、取消关注、点击菜单等。你需要根据事件类型进行相应处理：

from flask import Flask, request, make_response
import xml.etree.ElementTree as ET

app = Flask(__name__)

@app.route('/', methods=['GET', 'POST'])
def wechat_auth():
    if request.method == 'GET':
        # 验证服务器地址
        signature = request.args.get('signature')
        timestamp = request.args.get('timestamp')
        nonce = request.args.get('nonce')
        echostr = request.args.get('echostr')

        # 验证逻辑...
        return echostr
    else:
        # 处理消息
        xml_data = request.data
        xml_tree = ET.fromstring(xml_data)
        msg_type = xml_tree.find('MsgType').text

        if msg_type == 'event':
            event = xml_tree.find('Event').text
            if event == 'subscribe':
                # 处理用户关注事件
                return reply_text(xml_tree, "感谢关注！")
            elif event == 'CLICK':
                # 处理菜单点击事件
                event_key = xml_tree.find('EventKey').text
                return handle_menu_click(event_key, xml_tree)
        else:
            # 处理普通消息
            return handle_message(xml_tree)

def reply_text(xml_tree, content):
    from_user = xml_tree.find('ToUserName').text
    to_user = xml_tree.find('FromUserName').text
    reply = f"""
    <xml>
        <ToUserName><![CDATA[{to_user}]]></ToUserName>
        <FromUserName><![CDATA[{from_user}]]></FromUserName>
        <CreateTime>{int(time.time())}</CreateTime>
        <MsgType><![CDATA[text]]></MsgType>
        <Content><![CDATA[{content}]]></Content>
    </xml>
    """
    return make_response(reply)

在开发过程中，新手常会遇到以下问题：