发送客服消息
(→注意事项) |
|||
(未显示3个用户的16个中间版本) | |||
第1行: | 第1行: | ||
=发送客服消息= | =发送客服消息= | ||
− | + | 当用户主动发消息给认证账号后,微博将会把消息数据推送给开发者,开发者可以调用客服消息接口一定次数。 | |
+ | |||
+ | 用户没有主动发消息给认证账号,无法调此接口回复消息。 | ||
+ | |||
+ | 用户发送消息,关注/订阅事件,点击自定义菜单,扫描二维码事件后,目前修改为开发者在48小时内不限制发送次数。 | ||
+ | |||
+ | 用户取消关注后,开发者无法回复消息。 | ||
+ | |||
+ | 用户@事件,目前暂不开放,已有权限的开发者在48小时内可以回复一次。 | ||
第22行: | 第30行: | ||
!width="10%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|类型及范围 | !width="10%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|类型及范围 | ||
!width="75%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|说明 | !width="75%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|说明 | ||
− | {{api_args| | + | {{api_args|access_token|true|string|在粉丝服务平台 - 高级功能 - 开发者模式页面中获取,或者OAuth2.0授权后获得, 详细参考 [[Messages_api/access_token|获取粉丝服务平台开发接口的access token]]。}} |
− | + | ||
{{api_args|type|true|string|需要以何种类型的消息进行响应,text:纯文本、articles:图文、position:位置。}} | {{api_args|type|true|string|需要以何种类型的消息进行响应,text:纯文本、articles:图文、position:位置。}} | ||
{{api_args|data|true|string|消息数据,具体内容严格遵循type类型对应格式,必须为json做URLEncode后的字符串格式,采用UTF-8编码。}} | {{api_args|data|true|string|消息数据,具体内容严格遵循type类型对应格式,必须为json做URLEncode后的字符串格式,采用UTF-8编码。}} | ||
− | {{api_args|receiver_id| | + | {{api_args|receiver_id|true|int64|消息接收方的ID。}} |
− | {{api_args| | + | {{api_args|save_sender_box|false|int|取值为0或1,不填则默认为1。取值为1时,通过本接口发送的消息会进入发送方的私信箱;取值为0时,通过本接口发送的消息不会进入发送方的私信箱。}} |
|} | |} | ||
+ | |||
+ | *注:Content-Type: application/x-www-form-urlencoded | ||
==注意事项== | ==注意事项== | ||
− | * | + | *1、发送方的uid信息是由access_token参数决定的; |
− | * | + | *2、调用接口时,需要消息发送方有针对于消息接收方的消息配额;一般来说,如果消息接收方给消息发送方主动发送过消息,则在48小时内,消息发送方具备针对于消息接收方的主动配额99条; |
− | * | + | *3、对于使用长连接接入模式的开发者,message/reply接口的调用方式略有不同,详情请参考http://open.weibo.com/wiki/2/messages/reply 文档; |
+ | |||
此接口不得用于推广或引导用户使用任何与新浪微博有直接竞争关系的公司的服务,否则将永久关停指定应用或V用户使用资格。 | 此接口不得用于推广或引导用户使用任何与新浪微博有直接竞争关系的公司的服务,否则将永久关停指定应用或V用户使用资格。 | ||
第66行: | 第76行: | ||
|} | |} | ||
举例: | 举例: | ||
− | 当data对应json为{"text": "纯文本响应"} 时,则进行URLEncode后对应data参数值为:"% | + | 当data对应json为{"text": "纯文本响应"} 时,则进行URLEncode后对应data参数值为:"%7B%22text%22%3A%22%E7%BA%AF%E6%96%87%E6%9C%AC%E5%9B%9E%E5%A4%8D%22%7D"。 |
则对应的调用为: | 则对应的调用为: | ||
<pre> | <pre> | ||
− | curl | + | curl "https://m.api.weibo.com/2/messages/reply.json?access_token=ACCESS_TOKEN" -d 'receiver_id=RECEIVER_ID&type=text&data=%7B%22text%22%3A%22%E7%BA%AF%E6%96%87%E6%9C%AC%E5%9B%9E%E5%A4%8D%22%7D' -k |
</pre> | </pre> | ||
第151行: | 第161行: | ||
|纬度 | |纬度 | ||
|} | |} | ||
− | |||
==返回结果== | ==返回结果== |
2023年10月16日 (一) 17:43的最后版本
发送客服消息
当用户主动发消息给认证账号后,微博将会把消息数据推送给开发者,开发者可以调用客服消息接口一定次数。
用户没有主动发消息给认证账号,无法调此接口回复消息。
用户发送消息,关注/订阅事件,点击自定义菜单,扫描二维码事件后,目前修改为开发者在48小时内不限制发送次数。
用户取消关注后,开发者无法回复消息。
用户@事件,目前暂不开放,已有权限的开发者在48小时内可以回复一次。
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。 |
save_sender_box | false | int | 取值为0或1,不填则默认为1。取值为1时,通过本接口发送的消息会进入发送方的私信箱;取值为0时,通过本接口发送的消息不会进入发送方的私信箱。 |
- 注:Content-Type: application/x-www-form-urlencoded
注意事项
- 1、发送方的uid信息是由access_token参数决定的;
- 2、调用接口时,需要消息发送方有针对于消息接收方的消息配额;一般来说,如果消息接收方给消息发送方主动发送过消息,则在48小时内,消息发送方具备针对于消息接收方的主动配额99条;
- 3、对于使用长连接接入模式的开发者,message/reply接口的调用方式略有不同,详情请参考http://open.weibo.com/wiki/2/messages/reply 文档;
此接口不得用于推广或引导用户使用任何与新浪微博有直接竞争关系的公司的服务,否则将永久关停指定应用或V用户使用资格。
蓝V可回复的私信类型
当前支持蓝V回复的私信类型(type)中,data参数支持的参数:
1、纯文本类型私信消息:text
{ "text": "纯文本回复" }
data参数支持的参数 | |||
---|---|---|---|
参数名称 | 值的类型 | 是否必填 | 说明描述 |
text | string | true | 要回复的私信文本内容。文本大小必须小于300个汉字。 |
举例: 当data对应json为{"text": "纯文本响应"} 时,则进行URLEncode后对应data参数值为:"%7B%22text%22%3A%22%E7%BA%AF%E6%96%87%E6%9C%AC%E5%9B%9E%E5%A4%8D%22%7D"。
则对应的调用为:
curl "https://m.api.weibo.com/2/messages/reply.json?access_token=ACCESS_TOKEN" -d 'receiver_id=RECEIVER_ID&type=text&data=%7B%22text%22%3A%22%E7%BA%AF%E6%96%87%E6%9C%AC%E5%9B%9E%E5%A4%8D%22%7D' -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" }
文档更新时间: 2023-10-16