微信小程序 send

uniformMessage.send

本接口應(yīng)在服務(wù)器端調(diào)用，詳細(xì)說(shuō)明參見(jiàn)服務(wù)端API。

本接口支持云調(diào)用。需開(kāi)發(fā)者工具版本 >= 1.02.1904090（最新穩(wěn)定版下載）
wx-server-sdk >= 0.4.0

下發(fā)小程序和公眾號(hào)統(tǒng)一的服務(wù)消息

調(diào)用方式：

• HTTPS 調(diào)用
• 云調(diào)用

HTTPS 調(diào)用

請(qǐng)求地址

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

請(qǐng)求參數(shù)

weapp_template_msg 的結(jié)構(gòu)

mp_template_msg 的結(jié)構(gòu)

返回值

Object

返回的 JSON 數(shù)據(jù)包

錯(cuò)誤

請(qǐng)求數(shù)據(jù)示例

{
    "touser":"OPENID",
    "weapp_template_msg":{
        "template_id":"TEMPLATE_ID",
        "page":"page/page/index",
        "form_id":"FORMID",
        "data":{
            "keyword1":{
                "value":"339208499"
            },
            "keyword2":{
                "value":"2015年01月05日 12:30"
            },
            "keyword3":{
                "value":"騰訊微信總部"
            },
            "keyword4":{
                "value":"廣州市海珠區(qū)新港中路397號(hào)"
            }
        },
        "emphasis_keyword":"keyword1.DATA"
    },
    "mp_template_msg":{
        "appid":"APPID ",
        "template_id":"TEMPLATE_ID",
        "url":"http://weixin.qq.com/download",
        "miniprogram":{
            "appid":"xiaochengxuappid12345",
            "pagepath":"index?foo=bar"
        },
        "data":{
            "first":{
                "value":"恭喜你購(gòu)買(mǎi)成功！",
                "color":"#173177"
            },
            "keyword1":{
                "value":"巧克力",
                "color":"#173177"
            },
            "keyword2":{
                "value":"39.8元",
                "color":"#173177"
            },
            "keyword3":{
                "value":"2014年9月22日",
                "color":"#173177"
            },
            "remark":{
                "value":"歡迎再次購(gòu)買(mǎi)！",
                "color":"#173177"
            }
        }
    }
}

返回?cái)?shù)據(jù)示例

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

云調(diào)用

云調(diào)用是小程序·云開(kāi)發(fā)提供的在云函數(shù)中調(diào)用微信開(kāi)放接口的能力，需要在云函數(shù)中通過(guò) wx-server-sdk 使用。

接口方法

openapi.uniformMessage.send

需在 config.json 中配置 uniformMessage.send API 的權(quán)限，詳情

請(qǐng)求參數(shù)

weappTemplateMsg 的結(jié)構(gòu)

mpTemplateMsg 的結(jié)構(gòu)

返回值

Object

返回的 JSON 數(shù)據(jù)包

異常

Object

拋出的異常

errCode 的合法值

錯(cuò)誤

請(qǐng)求數(shù)據(jù)示例

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.uniformMessage.send({
        touser: 'OPENID',
        weappTemplateMsg: {
          page: 'page/page/index',
          data: {
            keyword1: {
              value: '339208499'
            },
            keyword2: {
              value: '2015年01月05日 12:30'
            },
            keyword3: {
              value: '騰訊微信總部'
            },
            keyword4: {
              value: '廣州市海珠區(qū)新港中路397號(hào)'
            }
          },
          templateId: 'TEMPLATE_ID',
          formId: 'FORMID',
          emphasisKeyword: 'keyword1.DATA'
        },
        mpTemplateMsg: {
          appid: 'APPID ',
          url: 'http://weixin.qq.com/download',
          miniprogram: {
            appid: 'xiaochengxuappid12345',
            pagepath: 'index?foo=bar'
          },
          data: {
            first: {
              value: '恭喜你購(gòu)買(mǎi)成功！',
              color: '#173177'
            },
            keyword1: {
              value: '巧克力',
              color: '#173177'
            },
            keyword2: {
              value: '39.8元',
              color: '#173177'
            },
            keyword3: {
              value: '2014年9月22日',
              color: '#173177'
            },
            remark: {
              value: '歡迎再次購(gòu)買(mǎi)！',
              color: '#173177'
            }
          },
          templateId: 'TEMPLATE_ID'
        }
      })
    return result
  } catch (err) {
    return err
  }
}

返回?cái)?shù)據(jù)示例

{
  "errCode": 0,
  "errMsg": "openapi.uniformMessage.send:ok"
}