微信小程序API模板消息這么使用

這篇文章主要講解了“微信小程序API模板消息這么使用”，文中的講解內(nèi)容簡單清晰，易于學(xué)習(xí)與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學(xué)習(xí)“微信小程序API模板消息這么使用”吧！

使用說明

步驟一：獲取模板ID

有兩個方法可以獲取模版ID

1. 通過模版消息管理接口獲取模版ID（詳見模版消息管理）

2. 在微信公眾平臺手動配置獲取模版ID

登錄https://mp.weixin.qq.com獲取模板，如果沒有合適的模板，可以申請?zhí)砑有履０?，審核通過后可使用，詳見模板審核說明

步驟二：頁面的<form/>組件，屬性report-submit為true時，可以聲明為需發(fā)模板消息，此時點(diǎn)擊按鈕提交表單可以獲取formId，用于發(fā)送模板消息。或者當(dāng)用戶完成支付行為，可以獲取prepay_id用于發(fā)送模板消息。

步驟三：調(diào)用接口下發(fā)模板消息

模版消息管理

1.獲取小程序模板庫標(biāo)題列表

接口地址

https://api.weixin.qq.com/cgi-bin/wxopen/template/library/list?access_token=ACCESS_TOKEN

HTTP請求方式：

POST

POST參數(shù)說明：

示例：

{"offset":0,"count":5}

返回碼說明：

在調(diào)用模板消息接口后，會返回JSON數(shù)據(jù)包。

正常時的返回JSON數(shù)據(jù)包示例：

{"errcode":0,"errmsg":"ok","list":[
{"id":"AT0002","title":"購買成功通知"},
{"id":"AT0003","title":"購買失敗通知"},
{"id":"AT0004","title":"交易提醒"},
{"id":"AT0005","title":"付款成功通知"},
{"id":"AT0006","title":"付款失敗通知"}
],"total_count":599}

返回參數(shù)說明：

2.獲取模板庫某個模板標(biāo)題下關(guān)鍵詞庫

接口地址

https://api.weixin.qq.com/cgi-bin/wxopen/template/library/get?access_token=ACCESS_TOKEN

HTTP請求方式：

POST

POST參數(shù)說明：

示例：

{"id":"AT0002"}

返回碼說明：

在調(diào)用模板消息接口后，會返回JSON數(shù)據(jù)包。

正常時的返回JSON數(shù)據(jù)包示例：

{"errcode": 0,"errmsg": "ok","id": "AT0002","title": "購買成功通知","keyword_list": [
        {"keyword_id": 3,"name": "購買地點(diǎn)","example": "TIT造艦廠"},
        {"keyword_id": 4,"name": "購買時間","example": "2016年6月6日"},
        {"keyword_id": 5,"name": "物品名稱","example": "咖啡"}
    ]
}

返回參數(shù)說明：

3.組合模板并添加至帳號下的個人模板庫

接口地址

https://api.weixin.qq.com/cgi-bin/wxopen/template/add?access_token=ACCESS_TOKEN

HTTP請求方式：

POST

POST參數(shù)說明：

示例：

{"id":"AT0002", 
"keyword_id_list":[3,4,5] 
}

返回碼說明：

在調(diào)用模板消息接口后，會返回JSON數(shù)據(jù)包。

正常時的返回JSON數(shù)據(jù)包示例：

{"errcode": 0,"errmsg": "ok","template_id": "wDYzYZVxobJivW9oMpSCpuvACOfJXQIoKUm0PY397Tc"}

返回參數(shù)說明：

4.獲取帳號下已存在的模板列表

接口地址

https://api.weixin.qq.com/cgi-bin/wxopen/template/list?access_token=ACCESS_TOKEN

HTTP請求方式：

POST

POST參數(shù)說明：

示例：

{"offset":0,"count":1}

返回碼說明：

在調(diào)用模板消息接口后，會返回JSON數(shù)據(jù)包。

正常時的返回JSON數(shù)據(jù)包示例：

{"errcode": 0,"errmsg": "ok","list": [
        {"template_id": "wDYzYZVxobJivW9oMpSCpuvACOfJXQIoKUm0PY397Tc","title": "購買成功通知","content": "購買地點(diǎn){{keyword1.DATA}}\n購買時間{{keyword2.DATA}}\n物品名稱{{keyword3.DATA}}\n","example": "購買地點(diǎn)：TIT造艦廠\n購買時間：2016年6月6日\n物品名稱：咖啡\n"}
    ]
}

返回參數(shù)說明：

5.刪除帳號下的某個模板

接口地址

https://api.weixin.qq.com/cgi-bin/wxopen/template/del?access_token=ACCESS_TOKEN

HTTP請求方式：

POST

POST參數(shù)說明：

示例：

{"template_id":"wDYzYZVxobJivW9oMpSCpuvACOfJXQIoKUm0PY397Tc"}

返回碼說明：

在調(diào)用模板消息接口后，會返回JSON數(shù)據(jù)包。

正常時的返回JSON數(shù)據(jù)包示例：

{"errcode": 0,"errmsg": "ok"}

發(fā)送模板消息

1. 獲取access_token

access_token是全局唯一接口調(diào)用憑據(jù)，開發(fā)者調(diào)用各接口時都需使用access_token，請妥善保存。access_token的存儲至少要保留512個字符空間。access_token的有效期目前為2個小時，需定時刷新，重復(fù)獲取將導(dǎo)致上次獲取的access_token失效。

公眾平臺的API調(diào)用所需的access_token的使用及生成方式說明：

1. 為了保密appsecrect，第三方需要一個access_token獲取和刷新的中控服務(wù)器。而其他業(yè)務(wù)邏輯服務(wù)器所使用的access_token均來自于該中控服務(wù)器，不應(yīng)該各自去刷新，否則會造成access_token覆蓋而影響業(yè)務(wù)；

2. 目前access_token的有效期通過返回的expire_in來傳達(dá)，目前是7200秒之內(nèi)的值。中控服務(wù)器需要根據(jù)這個有效時間提前去刷新新access_token。在刷新過程中，中控服務(wù)器對外輸出的依然是老access_token，此時公眾平臺后臺會保證在刷新短時間內(nèi)，新老access_token都可用，這保證了第三方業(yè)務(wù)的平滑過渡；

3. access_token的有效時間可能會在未來有調(diào)整，所以中控服務(wù)器不僅需要內(nèi)部定時主動刷新，還需要提供被動刷新access_token的接口，這樣便于業(yè)務(wù)服務(wù)器在API調(diào)用獲知access_token已超時的情況下，可以觸發(fā)access_token的刷新流程。

開發(fā)者可以使用AppID和AppSecret調(diào)用本接口來獲取access_token。AppID和AppSecret可登錄微信公眾平臺官網(wǎng)-設(shè)置-開發(fā)設(shè)置中獲得（需要已經(jīng)綁定成為開發(fā)者，且?guī)ぬ枦]有異常狀態(tài)）。AppSecret生成后請自行保存，因?yàn)樵诠娖脚_每次生成查看都會導(dǎo)致AppSecret被重置。注意調(diào)用所有微信接口時均需使用https協(xié)議。如果第三方不使用中控服務(wù)器，而是選擇各個業(yè)務(wù)邏輯點(diǎn)各自去刷新access_token，那么就可能會產(chǎn)生沖突，導(dǎo)致服務(wù)不穩(wěn)定。

接口地址：

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

HTTP請求方式:

GET

參數(shù)說明 :

返回參數(shù)說明：

正常情況下，微信會返回下述JSON數(shù)據(jù)包給開發(fā)者：

{"access_token":"ACCESS_TOKEN","expires_in":7200}

錯誤時微信會返回錯誤碼等信息，JSON數(shù)據(jù)包示例如下（該示例為AppID無效錯誤）:

{"errcode":40013,"errmsg":"invalid appid"}

2. 發(fā)送模板消息

接口地址：(ACCESS_TOKEN需換成上文獲取到的access_token)

https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKEN

HTTP請求方式：

POST

POST參數(shù)說明：

示例：

{  "touser": "OPENID",  
  "template_id": "TEMPLATE_ID", 
  "page": "index",          
  "form_id": "FORMID",         
  "data": {      "keyword1": {          "value": "339208499", 
          "color": "#173177"  }, 
      "keyword2": {          "value": "2015年01月05日 12:30", 
          "color": "#173177"  }, 
      "keyword3": {          "value": "粵海喜來登酒店", 
          "color": "#173177"  } , 
      "keyword4": {          "value": "廣州市天河區(qū)天河路208號", 
          "color": "#173177"  } 
  },  "emphasis_keyword": "keyword1.DATA" }

返回碼說明：

在調(diào)用模板消息接口后，會返回JSON數(shù)據(jù)包。

正常時的返回JSON數(shù)據(jù)包示例：

{  "errcode":0,  "errmsg":"ok",
}

錯誤時會返回錯誤碼信息，說明如下：

下發(fā)條件說明

1. 支付

   當(dāng)用戶在小程序內(nèi)完成過支付行為，可允許開發(fā)者向用戶在7天內(nèi)推送有限條數(shù)的模板消息（1次支付可下發(fā)3條，多次支付下發(fā)條數(shù)獨(dú)立，互相不影響）

2. 提交表單

   當(dāng)用戶在小程序內(nèi)發(fā)生過提交表單行為且該表單聲明為要發(fā)模板消息的，開發(fā)者需要向用戶提供服務(wù)時，可允許開發(fā)者向用戶在7天內(nèi)推送有限條數(shù)的模板消息（1次提交表單可下發(fā)1條，多次提交下發(fā)條數(shù)獨(dú)立，相互不影響）

審核說明

1.標(biāo)題

1.1標(biāo)題不能存在相同

1.2標(biāo)題意思不能存在過度相似

1.3標(biāo)題必須以“提醒”或“通知”結(jié)尾

1.4標(biāo)題不能帶特殊符號、個性化字詞等沒有行業(yè)通用性的內(nèi)容

1.5標(biāo)題必須能體現(xiàn)具體服務(wù)場景

1.6標(biāo)題不能涉及營銷相關(guān)內(nèi)容，包括不限于：

消費(fèi)優(yōu)惠類、購物返利類、商品更新類、優(yōu)惠券類、代金券類、紅包類、會員卡類、積分類、活動類等營銷傾向通知

2.關(guān)鍵詞

2.1同一標(biāo)題下，關(guān)鍵詞不能存在相同

2.2同一標(biāo)題下，關(guān)鍵詞不能存在過度相似

2.3關(guān)鍵詞不能帶特殊符號、個性化字詞等沒有行業(yè)通用性的內(nèi)容

2.4關(guān)鍵詞內(nèi)容示例必須與關(guān)鍵詞對應(yīng)匹配

2.5關(guān)鍵詞不能太過寬泛，需要具有限制性，例如：“內(nèi)容”這個就太寬泛，不能審核通過

違規(guī)說明

除不能違反運(yùn)營規(guī)范外，還不能違反以下規(guī)則，包括但不限于：

1. 不允許惡意誘導(dǎo)用戶進(jìn)行觸發(fā)操作，以達(dá)到可向用戶下發(fā)模板目的

2. 不允許惡意騷擾，下發(fā)對用戶造成騷擾的模板

3. 不允許惡意營銷，下發(fā)營銷目的模板

處罰說明

根據(jù)違規(guī)情況給予相應(yīng)梯度的處罰，一般處罰規(guī)則如下：

第一次違規(guī)，刪除違規(guī)模板以示警告，

第二次違規(guī)，封禁接口7天，

第三次違規(guī)，封禁接口30天，

第四次違規(guī)，永久封禁接口

處罰結(jié)果及原因以站內(nèi)信形式告知

Bug & Tip

tip: 微信6.5.2及以上版本支持模板功能。低于該版本將無法收到模板消息。

感謝各位的閱讀，以上就是“微信小程序API模板消息這么使用”的內(nèi)容了，經(jīng)過本文的學(xué)習(xí)后，相信大家對微信小程序API模板消息這么使用這一問題有了更深刻的體會，具體使用情況還需要大家實(shí)踐驗(yàn)證。這里是億速云，小編將為大家推送更多相關(guān)知識點(diǎn)的文章，歡迎關(guān)注！