一、功能說明
做推廣時,除了告訴對方公眾號名稱讓他們搜尋關注,更便利的方式是直接掃描二維碼。掃一下就進入關注流程,若已關注則直接跳進對話畫面。而且二維碼可以依場景產生不同版本,用在推廣文宣上更生動。
微信對二維碼支援得不錯,可以依需要產生不同場景值的碼。以下說明如何取得與使用。
注意:此功能限已微信認證的服務號。

為了支援渠道推廣分析,公眾平台提供「生成帶參數二維碼」的介面,可以產生多個帶不同場景值的碼,使用者掃描後公眾號會收到事件推送。
二維碼分兩種:臨時碼有過期時間(最長 1800 秒),但數量上限寬鬆;永久碼不過期,但參數目前只支援 1~1000。兩者分別適合帳號綁定與用戶來源統計等情境。
使用者掃描帶場景值的二維碼時,會有兩種情況:尚未關注者,關注後微信會推送「帶場景值關注事件」;已關注者,掃描後自動進入會話,微信會推送「帶場景值掃描事件」。
整個流程分兩步:先建立二維碼 ticket,再用 ticket 換取二維碼圖片。
POST https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN
{"expire_seconds": 1800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}POST https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN
{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}}參數說明:expire_seconds 為有效秒數,上限 1800;action_name 中 QR_SCENE 是臨時、QR_LIMIT_SCENE 是永久;scene_id 是場景值,臨時碼為 32 位整數,永久碼上限 1000。
成功回傳:
{"ticket":"gQG28DoAAAA...","expire_seconds":1800}
其中 ticket 用來後續換取圖片。失敗則回傳錯誤碼,例如 {"errcode":40013,"errmsg":"invalid appid"}。
這個介面不需要登入態:
GET https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET
成功時 HTTP 狀態碼是 200,回應內容即為圖片(Content-Type: image/jpg),可直接顯示或下載;ticket 非法則回傳 404。
仍延續先前的機器人專案,直接看程式碼:
public class DimensionalCodeManager {
// 注意:字串中要輸出 { 必須寫成 {{,否則 string.Format 會報格式錯誤
private const string TEMP_JSON_DATA =
"{{\"expire_seconds\": 1800, \"action_name\": \"QR_SCENE\", \"action_info\": {{\"scene\": {{\"scene_id\": {0}}}}}}}";
private const string PERMANENT_URL =
"{{\"action_name\": \"QR_LIMIT_SCENE\", \"action_info\": {{\"scene\": {{\"scene_id\": {0}}}}}}}";
private const string GET_TICKET_URL =
"https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token={0}";
private const string GET_CODE_URL =
"https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket={0}";
/// 依場景 ID 取得 ticket
private static string GetTicket(int sceneID, bool isTemp) {
string data;
if (isTemp) {
data = string.Format(TEMP_JSON_DATA, sceneID.ToString());
} else {
if (sceneID > 0 && sceneID <= 1000) {
data = string.Format(PERMANENT_URL, sceneID);
} else {
return null; // 永久碼的 scene_id 範圍不合法
}
}
string ticketJson = HttpUtility.GetData(string.Format(GET_TICKET_URL, Context.AccessToken));
XDocument doc = XmlUtility.ParseJson(ticketJson, "root");
XElement ticket = doc.Root?.Element("ticket");
return ticket?.Value;
}
public static string GenerateTemp(int sceneID) {
string ticket = GetTicket(sceneID, true);
if (ticket == null) { return null; }
return HttpUtility.GetData(string.Format(GET_CODE_URL, ticket));
}
public static string GeneratePermanent(int sceneID) {
string ticket = GetTicket(sceneID, false);
if (ticket == null) { return null; }
return HttpUtility.GetData(string.Format(GET_CODE_URL, ticket));
}
}實作時有兩個容易忽略的點:一是永久碼的 scene_id 有 1~1000 的範圍限制,超出要自行擋掉;二是字串內要輸出單一大括號時,在 string.Format 裡必須寫成兩個。