6.2.1　接口描述

客服接口的请求地址如下：

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

发送客服消息需要向上述请求地址POST特定格式的JSON数据包，各种类型的消息所需的JSON数据包如下。

1）发送文本消息：

  1. {
  2.     "touser": "OPENID",
  3.     "msgtype": "text",
  4.     "text": {
  5.         "content": "Hello World"
  6.     }
  7. }

2）发送图片消息：

  1. {
  2.     "touser": "OPENID",
  3.     "msgtype": "image",
  4.     "image": {
  5.        "media_id": "MEDIA_ID"
  6.     }
  7. }

3）发送语音消息：

  1. {
  2.     "touser": "OPENID",
  3.     "msgtype": "voice",
  4.     "voice": {
  5.         "media_id": "MEDIA_ID"
  6.     }
  7. }

4）发送视频消息：

  1. {
  2.     "touser": "OPENID",
  3.     "msgtype": "video",
  4.     "video": {
  5.         "media_id": "MEDIA_ID",
  6.         "thumb_media_id": "THUMB_MEDIA_ID"
  7.     }
  8. }

5）发送音乐消息：

  1. {
  2.     "touser": "OPENID",
  3.     "msgtype": "music",
  4.     "music": {
  5.         "title": "MUSIC_TITLE",
  6.         "description": "MUSIC_DESCRIPTION",
  7.         "musicurl": "MUSIC_URL",
  8.         "hqmusicurl": "HQ_MUSIC_URL",
  9.         "thumb_media_id": "THUMB_MEDIA_ID"
  10.     }
  11. }

6）发送图文消息：

  1. {
  2.     "touser": "OPENID",
  3.     "msgtype": "news",
  4.     "news": {
  5.         "articles": [
  6.             {
  7.                 "title": "Happy Day",
  8.                 "description": "Is Really A Happy Day",
  9.                 "url": "URL",
  10.                 "picurl": "PIC_URL"
  11.             },
  12.             {
  13.                 "title": "Happy Day",
  14.                 "description": "Is Really A Happy Day",
  15.                 "url": "URL",
  16.                 "picurl": "PIC_URL"
  17.             }
  18.         ]
  19.     }
  20. }

其中，参数touser是消息的发送对象，msgtype是消息类型，其他参数在第4章介绍响应消息时都有说明。消息发送成功时返回的JSON结果示例如下：

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

消息发送失败时返回的JSON结果示例如下：

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