uniformMessage.send

本接口应在服务器端调用,详细说明参见服务端API

本接口支持云调用。需开发者工具版本 >= 1.02.1904090(最新稳定版下载),wx-server-sdk >= 0.4.0

下发小程序和公众号统一的服务消息

调用方式:

HTTPS 调用

请求地址

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

请求参数

属性类型默认值必填说明
access_tokenstring接口调用凭证
touserstring用户openid,可以是小程序的openid,也可以是mp_template_msg.appid对应的公众号的openid
weapp_template_msgObject小程序模板消息相关的信息,可以参考小程序模板消息接口; 有此节点则优先发送小程序模板消息
mp_template_msgObject公众号模板消息相关的信息,可以参考公众号模板消息接口;有此节点并且没有weapp_template_msg节点时,发送公众号模板消息

weapp_template_msg 的结构

属性类型默认值必填说明
template_idstring小程序模板ID
pagestring小程序页面路径
form_idstring小程序模板消息formid
datastring小程序模板数据
emphasis_keywordstring小程序模板放大关键词

mp_template_msg 的结构

属性类型默认值必填说明
appidstring公众号appid,要求与小程序有绑定且同主体
template_idstring公众号模板id
urlstring公众号模板消息所要跳转的url
miniprogramstring公众号模板消息所要跳转的小程序,小程序的必须与公众号具有绑定关系
datastring公众号模板消息的数据

返回值

Object

返回的 JSON 数据包

属性类型说明
errcodenumber错误码
errmsgstring错误信息

错误

错误码错误信息说明
40037模板id不正确,weapp_template_msg.template_id或者mp_template_msg.template_id
41028weapp_template_msg.form_id过期或者不正确
41029weapp_template_msg.form_id已被使用
41030weapp_template_msg.page不正确
45009接口调用超过限额
40003touser不是正确的openid
40013appid不正确,或者不符合绑定关系要求

请求数据示例

  1. {
  2. "touser":"OPENID",
  3. "weapp_template_msg":{
  4. "template_id":"TEMPLATE_ID",
  5. "page":"page/page/index",
  6. "form_id":"FORMID",
  7. "data":{
  8. "keyword1":{
  9. "value":"339208499"
  10. },
  11. "keyword2":{
  12. "value":"2015年01月05日 12:30"
  13. },
  14. "keyword3":{
  15. "value":"腾讯微信总部"
  16. },
  17. "keyword4":{
  18. "value":"广州市海珠区新港中路397号"
  19. }
  20. },
  21. "emphasis_keyword":"keyword1.DATA"
  22. },
  23. "mp_template_msg":{
  24. "appid":"APPID ",
  25. "template_id":"TEMPLATE_ID",
  26. "url":"http://weixin.qq.com/download",
  27. "miniprogram":{
  28. "appid":"xiaochengxuappid12345",
  29. "pagepath":"index?foo=bar"
  30. },
  31. "data":{
  32. "first":{
  33. "value":"恭喜你购买成功!",
  34. "color":"#173177"
  35. },
  36. "keyword1":{
  37. "value":"巧克力",
  38. "color":"#173177"
  39. },
  40. "keyword2":{
  41. "value":"39.8元",
  42. "color":"#173177"
  43. },
  44. "keyword3":{
  45. "value":"2014年9月22日",
  46. "color":"#173177"
  47. },
  48. "remark":{
  49. "value":"欢迎再次购买!",
  50. "color":"#173177"
  51. }
  52. }
  53. }
  54. }

返回数据示例

  1. {
  2. "errcode": 0,
  3. "errmsg": "ok"
  4. }

云调用

云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力,需要在云函数中通过 wx-server-sdk 使用。

接口方法

  1. openapi.uniformMessage.send

需在 config.json 中配置 uniformMessage.send API 的权限,详情

请求参数

属性类型默认值必填说明
touserstring用户openid,可以是小程序的openid,也可以是mp_template_msg.appid对应的公众号的openid
weappTemplateMsgObject小程序模板消息相关的信息,可以参考小程序模板消息接口; 有此节点则优先发送小程序模板消息
mpTemplateMsgObject公众号模板消息相关的信息,可以参考公众号模板消息接口;有此节点并且没有weapp_template_msg节点时,发送公众号模板消息

weappTemplateMsg 的结构

属性类型默认值必填说明
templateIdstring小程序模板ID
pagestring小程序页面路径
formIdstring小程序模板消息formid
datastring小程序模板数据
emphasisKeywordstring小程序模板放大关键词

mpTemplateMsg 的结构

属性类型默认值必填说明
appidstring公众号appid,要求与小程序有绑定且同主体
templateIdstring公众号模板id
urlstring公众号模板消息所要跳转的url
miniprogramstring公众号模板消息所要跳转的小程序,小程序的必须与公众号具有绑定关系
datastring公众号模板消息的数据

返回值

Object

返回的 JSON 数据包

属性类型说明
errCodenumber错误码
errMsgstring错误信息

异常

Object

抛出的异常

属性类型说明
errCodenumber错误码
errMsgstring错误信息

errCode 的合法值

说明最低版本

错误

错误码错误信息说明
40037模板id不正确,weapp_template_msg.template_id或者mp_template_msg.template_id
41028weapp_template_msg.form_id过期或者不正确
41029weapp_template_msg.form_id已被使用
41030weapp_template_msg.page不正确
45009接口调用超过限额
40003touser不是正确的openid
40013appid不正确,或者不符合绑定关系要求

请求数据示例

  1. const cloud = require('wx-server-sdk')
  2. cloud.init()
  3. exports.main = async (event, context) => {
  4. try {
  5. const result = await cloud.openapi.uniformMessage.send({
  6. touser: 'OPENID',
  7. weappTemplateMsg: {
  8. page: 'page/page/index',
  9. data: {
  10. keyword1: {
  11. value: '339208499'
  12. },
  13. keyword2: {
  14. value: '2015年01月05日 12:30'
  15. },
  16. keyword3: {
  17. value: '腾讯微信总部'
  18. },
  19. keyword4: {
  20. value: '广州市海珠区新港中路397号'
  21. }
  22. },
  23. templateId: 'TEMPLATE_ID',
  24. formId: 'FORMID',
  25. emphasisKeyword: 'keyword1.DATA'
  26. },
  27. mpTemplateMsg: {
  28. appid: 'APPID ',
  29. url: 'http://weixin.qq.com/download',
  30. miniprogram: {
  31. appid: 'xiaochengxuappid12345',
  32. pagepath: 'index?foo=bar'
  33. },
  34. data: {
  35. first: {
  36. value: '恭喜你购买成功!',
  37. color: '#173177'
  38. },
  39. keyword1: {
  40. value: '巧克力',
  41. color: '#173177'
  42. },
  43. keyword2: {
  44. value: '39.8元',
  45. color: '#173177'
  46. },
  47. keyword3: {
  48. value: '2014年9月22日',
  49. color: '#173177'
  50. },
  51. remark: {
  52. value: '欢迎再次购买!',
  53. color: '#173177'
  54. }
  55. },
  56. templateId: 'TEMPLATE_ID'
  57. }
  58. })
  59. console.log(result)
  60. return result
  61. } catch (err) {
  62. console.log(err)
  63. return err
  64. }
  65. }

返回数据示例

  1. {
  2. "errCode": 0,
  3. "errMsg": "openapi.uniformMessage.send:ok"
  4. }