| ylbtech-微信-小程序-開發文檔-服務端-模板消息：templateMessage.send |
| 1.返回頂部 |
1、
templateMessage.send
本接口應在服務器端調用，詳細說明參見服務端API。
本接口支持雲調用。需開發者工具版本 >=
1.02.1904090（最新穩定版下載），wx-server-sdk>=0.4.0
發送模板消息
調用方式：
HTTPS 調用
請求地址
POST https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKEN
請求參數
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口調用憑證 | |
| touser | string | 是 | 接收者（用戶）的 openid | |
| template_id | string | 是 | 所需下發的模板消息的id | |
| page | string | 否 | 點擊模板卡片后的跳轉頁面，僅限本小程序內的頁面。支持帶參數,（示例index?foo=bar）。該字段不填則模板無跳轉。 | |
| form_id | string | 是 | 表單提交場景下，為 submit 事件帶上的 formId；支付場景下，為本次支付的 prepay_id | |
| data | Object | 否 | 模板內容，不填則下發空模板。具體格式請參考示例。 | |
| emphasis_keyword | string | 否 | 模板需要放大的關鍵詞，不填則默認無放大 |
返回值
Object
返回的 JSON 數據包
| 屬性 | 類型 | 說明 |
|---|---|---|
| errcode | number | 錯誤碼 |
| errmsg | string | 錯誤信息 |
errcode 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| 40037 | template_id不正確 | |
| 41028 | form_id不正確，或者過期 | |
| 41029 | form_id已被使用 | |
| 41030 | page不正確 | |
| 45009 | 接口調用超過限額（目前默認每個帳號日調用限額為100萬） |
請求示例
{ "touser": "OPENID", "template_id": "TEMPLATE_ID", "page": "index", "form_id": "FORMID", "data": { "keyword1": { "value": "339208499" }, "keyword2": { "value": "2015年01月05日 12:30" }, "keyword3": { "value": "騰訊微信總部" } , "keyword4": { "value": "廣州市海珠區新港中路397號" } }, "emphasis_keyword": "keyword1.DATA" } 返回示例
{ "errcode": 0, "errmsg": "ok" }
雲調用
雲調用是小程序·雲開發提供的在雲函數中調用微信開放接口的能力，需要在雲函數中通過
wx-server-sdk使用。
接口方法
openapi.templateMessage.send 需在
config.json中配置templateMessage.sendAPI 的權限，詳情
請求參數
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| touser | string | 是 | 接收者（用戶）的 openid | |
| templateId | string | 是 | 所需下發的模板消息的id | |
| page | string | 否 | 點擊模板卡片后的跳轉頁面，僅限本小程序內的頁面。支持帶參數,（示例index?foo=bar）。該字段不填則模板無跳轉。 | |
| formId | string | 是 | 表單提交場景下，為 submit 事件帶上的 formId；支付場景下，為本次支付的 prepay_id | |
| data | Object | 否 | 模板內容，不填則下發空模板。具體格式請參考示例。 | |
| emphasisKeyword | string | 否 | 模板需要放大的關鍵詞，不填則默認無放大 |
返回值
Object
返回的 JSON 數據包
| 屬性 | 類型 | 說明 |
|---|---|---|
| errCode | number | 錯誤碼 |
| errMsg | string | 錯誤信息 |
errCode 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| 0 | 成功 |
異常
Object
拋出的異常
| 屬性 | 類型 | 說明 |
|---|---|---|
| errCode | number | 錯誤碼 |
| errMsg | string | 錯誤信息 |
errCode 的合法值
| 值 | 說明 | 最低版本 |
|---|---|---|
| 40037 | template_id不正確 | |
| 41028 | form_id不正確，或者過期 | |
| 41029 | form_id已被使用 | |
| 41030 | page不正確 | |
| 45009 | 接口調用超過限額（目前默認每個帳號日調用限額為100萬） |
請求示例
const cloud = require('wx-server-sdk') cloud.init() exports.main = async (event, context) => { try { const result = await cloud.openapi.templateMessage.send({ touser: 'OPENID', page: 'index', data: { keyword1: { value: '339208499' }, keyword2: { value: '2015年01月05日 12:30' }, keyword3: { value: '騰訊微信總部' }, keyword4: { value: '廣州市海珠區新港中路397號' } }, templateId: 'TEMPLATE_ID', formId: 'FORMID', emphasisKeyword: 'keyword1.DATA' }) console.log(result) return result } catch (err) { console.log(err) return err } } 返回示例
{ "errCode": 0, "errMsg": "openapi.templateMessage.send:ok" }
2、
| 2.返回頂部 |
| 3.返回頂部 |
| 4.返回頂部 |
| 5.返回頂部 |
1、
2、
| 6.返回頂部 |
 |
作者：ylbtech 出處：http://ylbtech.cnblogs.com/ 本文版權歸作者和博客園共有，歡迎轉載，但未經作者同意必須保留此段聲明，且在文章頁面明顯位置給出原文連接，否則保留追究法律責任的權利。 |