发送客服消息
发送客服消息
当用户主动发消息给认证账号的时候（包括发送信息、关注事件、扫描二维码事件），微博将会把消息数据推送给开发者，开发者在一段时间内（目前为7天）可以调用客服消息接口一定次数（目前用户发送消息，则认证账号可以回复3次，用户关注公众账号，公众账号可以回复1次），通过POST一个JSON数据包来发送消息给普通用户。
URL
https://m.api.weibo.com/2/messages/reply.json
HTTP请求方式
POST
是否需要登录
是
关于登录授权，参见 如何登录授权
接口请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 在粉丝服务平台 - 高级功能 - 开发者模式页面中获取，或者OAuth2.0授权后获得, 详细参考 获取粉丝服务平台开发接口的access token。 |
| type | true | string | 需要以何种类型的消息进行响应，text：纯文本、articles：图文、position：位置。 |
| data | true | string | 消息数据，具体内容严格遵循type类型对应格式，必须为json做URLEncode后的字符串格式，采用UTF-8编码。 |
| receiver_id | true | int64 | 消息接收方的ID。 |
注意事项
- 1、如果调用走OAuth方式，则access_token参数必填，id参数和receiver_id参数必填一个；
- 2、如果调用走OAuth方式，则access_token参数必填，id参数和receiver_id参数必填一个；
- 5、调用接口时，需要消息发送方有针对于消息接收方的消息配额；一般来说，如果消息接收方给消息发送方主动发送过消息，则在7天内，消息发送方具备针对于消息接收方的主动配额一条；
此接口不得用于推广或引导用户使用任何与新浪微博有直接竞争关系的公司的服务，否则将永久关停指定应用或V用户使用资格。
蓝V可回复的私信类型
当前支持蓝V回复的私信类型（type）中，data参数支持的参数：
1、纯文本类型私信消息：text
{
"text": "纯文本回复"
}
| data参数支持的参数 | |||
|---|---|---|---|
| 参数名称 | 值的类型 | 是否必填 | 说明描述 |
| text | string | true | 要回复的私信文本内容。文本大小必须小于300个汉字。 |
举例： 当data对应json为{"text": "纯文本响应"} 时，则进行URLEncode后对应data参数值为："%7b%0a++++%22text%22%3a+%22%e7%ba%af%e6%96%87%e6%9c%ac%e5%93%8d%e5%ba%94%22%0a%7d"。
则对应的调用为：
curl -u "USERNAME:PASSWORD" -d "source=YOUR_APPKEY&id=1307180000*****&type=text&data=%7b%0a++++%22text%22%3a+%22%e7%ba%af%e6%96%87%e6%9c%ac%e5%93%8d%e5%ba%94%22%0a%7d" "https://m.api.weibo.com/2/messages/reply.json" -k
2、图文类型私信消息：articles
{
"articles": [
{
"display_name": "两个故事",
"summary": "今天讲两个故事，分享给你。谁是公司？谁又是中国人？",
"image": "http://storage.mcp.weibo.cn/0JlIv.jpg",
"url": "http://e.weibo.com/mediaprofile/article/detail?uid=1722052204&aid=983319"
},
... //最多支持8个图文，建议为1或3个
]
}
| data参数支持的参数 | |||
|---|---|---|---|
| 参数名称 | 值的类型 | 是否必填 | 说明描述 |
| articles:display_name | string | true | 图文的显示名称标题 |
| articles:summary | string | true | 图文的文字描述，大于等于2个图文时，仅显示第一个图文的描述 |
| articles:image | string | true | 图文的缩略显示图片，需为JPG、PNG格式，单图及多图第一张推荐使用280*155，多图非第一张推荐使用64*64 |
| articles:url | string | true | 图文的URL地址，点击后跳转 |
3、位置类型私信消息：position
{
"longitude": "344.3344",
"latitude": "232.343434"
}
| data参数支持的参数 | |||
|---|---|---|---|
| 参数名称 | 值的类型 | 是否必填 | 说明描述 |
| longitude | string | true | 经度 |
| latitude | string | true | 纬度 |
返回结果
// 成功返回
{
"result": true,
"sender_id": "123",
"receiver_id": "456",
"type":"position"
"data": "%7B%22longitude%22%3A%22344.3344%22%2C%22latitude%22%3A%22232.343434%22%7D"
}
