微信小程序 send

customerServiceMessage.send

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

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

發(fā)送客服消息給用戶。詳細(xì)規(guī)則見 發(fā)送客服消息

調(diào)用方式：

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

HTTPS 調(diào)用

請求地址

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

請求參數(shù)

msgtype 的合法值

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

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

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

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

返回值

Object

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

errcode 的合法值

下發(fā)消息示例

發(fā)送文本消息

{
  "touser":"OPENID",
  "msgtype":"text",
  "text":
  {
    "content":"Hello World"
  }
}

發(fā)送文本消息時，支持添加可跳轉(zhuǎn)小程序的文字連接

文本內(nèi)容...<a  rel="external nofollow" target="_blank"  rel="external nofollow" target="_blank"  data-miniprogram-appid="appid" data-miniprogram-path="pages/index/index">點擊跳小程序</a>

說明：

1. data-miniprogram-appid 項，填寫小程序appid，則表示該鏈接跳轉(zhuǎn)小程序；
2. data-miniprogram-path項，填寫小程序路徑，路徑與app.json中保持一致，可帶參數(shù)；
3. 對于不支持 data-miniprogram-appid 項的客戶端版本（6.5.16 以下），如果有 herf 項，則仍然保持跳 href 中的鏈接；
4. 小程序發(fā)帶小程序文字鏈的文本消息，data-miniprogram-appid必須是該小程序的appid。

發(fā)送圖片消息

{
  "touser":"OPENID",
  "msgtype":"image",
  "image": {
    "media_id":"MEDIA_ID"
  }
}

發(fā)送圖文鏈接

每次可以發(fā)送一個圖文鏈接

{
  "touser": "OPENID",
  "msgtype": "link",
  "link": {
    "title": "Happy Day",
    "description": "Is Really A Happy Day",
    "url": "URL",
    "thumb_url": "THUMB_URL"
  }
}

發(fā)送小程序卡片

{
 "touser":"OPENID",
 "msgtype":"miniprogrampage",
 "miniprogrampage": {
   "title":"title",
   "pagepath":"pagepath",
   "thumb_media_id":"thumb_media_id"
 }
}

云調(diào)用

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

接口方法

openapi.customerServiceMessage.send

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

請求參數(shù)

msgtype 的合法值

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

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

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

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

返回值

Object

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

errCode 的合法值

異常

Object

拋出的異常

errCode 的合法值

下發(fā)消息示例

發(fā)送文本消息

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.customerServiceMessage.send({
        touser: 'OPENID',
        msgtype: 'text',
        text: {
          content: 'Hello World'
        }
      })
    return result
  } catch (err) {
    return err
  }
}

發(fā)送文本消息時，支持添加可跳轉(zhuǎn)小程序的文字連接

文本內(nèi)容...<a  rel="external nofollow" target="_blank"  rel="external nofollow" target="_blank"  data-miniprogram-appid="appid" data-miniprogram-path="pages/index/index">點擊跳小程序</a>

說明：

1. data-miniprogram-appid 項，填寫小程序appid，則表示該鏈接跳轉(zhuǎn)小程序；
2. data-miniprogram-path項，填寫小程序路徑，路徑與app.json中保持一致，可帶參數(shù)；
3. 對于不支持 data-miniprogram-appid 項的客戶端版本（6.5.16 以下），如果有 herf 項，則仍然保持跳 href 中的鏈接；
4. 小程序發(fā)帶小程序文字鏈的文本消息，data-miniprogram-appid必須是該小程序的appid。

發(fā)送圖片消息

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.customerServiceMessage.send({
        touser: 'OPENID',
        msgtype: 'image',
        image: {
          mediaId: 'MEDIA_ID'
        }
      })
    return result
  } catch (err) {
    return err
  }
}

發(fā)送圖文鏈接

每次可以發(fā)送一個圖文鏈接

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.customerServiceMessage.send({
        touser: 'OPENID',
        msgtype: 'link',
        link: {
          title: 'Happy Day',
          description: 'Is Really A Happy Day',
          url: 'URL',
          thumbUrl: 'THUMB_URL'
        }
      })
    return result
  } catch (err) {
    return err
  }
}

發(fā)送小程序卡片

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.customerServiceMessage.send({
        touser: 'OPENID',
        msgtype: 'miniprogrampage',
        miniprogrampage: {
          title: 'title',
          pagepath: 'pagepath',
          thumbMediaId: 'thumb_media_id'
        }
      })
    return result
  } catch (err) {
    return err
  }
}