发送客服消息

出自中南e行公众平台开发者文档
跳转到: 导航, 搜索

当用户主动发消息给公众号的时候(包括发送信息、点击自定义菜单、订阅事件、扫描二维码事件、支付成功事件、用户维权),中南e行将会把消息数据推送给开发者,开发者在一段时间内(目前修改为48小时)可以调用客服消息接口,通过POST一个JSON数据包来发送消息给普通用户,在48小时内不限制发送次数。此接口主要用于客服等有人工消息处理环节的功能,方便开发者为用户提供更加优质的服务。

接口调用请求说明

http请求方式: POST
http://app.its.csu.edu.cn/mqtt/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN

各消息类型所需的JSON数据包如下。

目录

发送文本消息

{
    "touser":"OPENID",
    "msgtype":"text",
    "text":
    {
         "content":"Hello World"
    }
}
参数 是否必须 说明
access_token 调用接口凭证
touser 普通用户openid
msgtype 消息类型,text
content 文本消息内容

发送图片消息

{
    "touser":"OPENID",
    "msgtype":"image",
    "image":
    {
      "media_id":"MEDIA_ID"
    }
}
参数 是否必须 说明
access_token 调用接口凭证
touser 普通用户openid
msgtype 消息类型,image
media_id 发送的图片的媒体ID

发送语音消息

{
    "touser":"OPENID",
    "msgtype":"voice",
    "voice":
    {
      "media_id":"MEDIA_ID"
    }
}
参数 是否必须 说明
access_token 调用接口凭证
touser 普通用户openid
msgtype 消息类型,voice
media_id 发送的语音的媒体ID

发送图文消息

图文消息条数限制在10条以内,注意,如果图文数超过10,则将会无响应。

{
    "touser":"OPENID",
    "msgtype":"news",
    "news":{
        "articles": [
         {
             "title":"Happy Day",
             "description":"Is Really A Happy Day",
             "url":"URL",
             "picurl":"PIC_URL"
         },
         {
             "title":"Happy Day",
             "description":"Is Really A Happy Day",
             "url":"URL",
             "picurl":"PIC_URL"
         }
         ]
    }
}
参数 是否必须 说明
access_token 调用接口凭证
touser 普通用户openid
msgtype 消息类型,news
title 标题
description 描述
url 点击后跳转的链接
picurl 图文消息的图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80