模板消息
(以“楚杰好~”为内容创建页面) |
|||
第1行: | 第1行: | ||
− | + | =发送模板消息= | |
+ | |||
+ | 当用户主动发消息给认证账号后,微博将会把消息数据推送给开发者,开发者可以调用客服消息接口一定次数。 | ||
+ | |||
+ | 用户发送消息,关注/订阅事件,点击自定义菜单,扫描二维码事件后,目前修改为开发者在48小时内不限制发送次数; | ||
+ | |||
+ | 用户@事件,开发者在48小时内可以回复一次; | ||
+ | 说明:指定的认证用户需被授予接收“被@消息”权限,此接口才返回“被@消息”,申请可邮件 [mailto:mingjin@staff.sina.com.cn mingjin@staff.sina.com.cn] 。 | ||
+ | |||
+ | 用户取消关注后,开发者无法回复消息; | ||
+ | |||
+ | ==URL== | ||
+ | http://api.weibo.com/2/eps/template/send.json | ||
+ | |||
+ | ==HTTP请求方式== | ||
+ | POST | ||
+ | |||
+ | ==是否需要登录== | ||
+ | 是<br/> | ||
+ | 关于登录授权,参见 [[授权机制说明|如何登录授权]] | ||
+ | |||
+ | |||
+ | ==接口请求参数== | ||
+ | {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;" | ||
+ | |- | ||
+ | !width="10%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"| | ||
+ | !width="5%" 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"|说明 | ||
+ | {{api_args|access_token|true|string|在粉丝服务平台 - 高级功能 - 开发者模式页面中获取,或者OAuth2.0授权后获得, 详细参考 [[Messages_api/access_token|获取粉丝服务平台开发接口的access token]]。}} | ||
+ | {{api_args|receiver_id|true|long|消息接收方的ID。}} | ||
+ | {{api_args|template_id|false|string|用户模板的ID,utid。}} | ||
+ | {{api_args|data|true|string|要发给用户的数据,json格式。}} | ||
+ | |||
+ | |} | ||
+ | |||
+ | |||
+ | ==注意事项== | ||
+ | *1、请求示例: | ||
+ | http://api.weibo.com/2/eps/template/send.json?access_tocken=2.00DtpjEDBOC92Eecbf500fd5RdBZ8D&receiver_id=2662732725&template_id=9db1c3adf9a06fbd4bc94df2e2322a7484da0f7c7d1bfe24048b0babc707e301&data={"key1":"MockValue1","key2":"MockValue2","key3.":"MockValue3","key4":{"subkey0":"subMockValue0","subkey1":"subMockValue1"}} | ||
+ | |||
+ | *2、调用接口前,需要先申请到模板消息ID; | ||
+ | |||
+ | |||
+ | ==返回结果== | ||
+ | <pre> | ||
+ | // 成功返回 | ||
+ | { | ||
+ | "result": true | ||
+ | } | ||
+ | |||
+ | // 失败返回 | ||
+ | { | ||
+ | "result": false, | ||
+ | "error": "uid invalid", | ||
+ | "error_code": "30006", | ||
+ | "request":"/2/eps/template/send.json" | ||
+ | } | ||
+ | </pre> | ||
+ | |||
+ | |||
+ | |||
+ | __NOTOC__ |
2014年11月9日 (日) 13:40的版本
发送模板消息
当用户主动发消息给认证账号后,微博将会把消息数据推送给开发者,开发者可以调用客服消息接口一定次数。
用户发送消息,关注/订阅事件,点击自定义菜单,扫描二维码事件后,目前修改为开发者在48小时内不限制发送次数;
用户@事件,开发者在48小时内可以回复一次; 说明:指定的认证用户需被授予接收“被@消息”权限,此接口才返回“被@消息”,申请可邮件 mingjin@staff.sina.com.cn 。
用户取消关注后,开发者无法回复消息;
URL
http://api.weibo.com/2/eps/template/send.json
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
接口请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 在粉丝服务平台 - 高级功能 - 开发者模式页面中获取,或者OAuth2.0授权后获得, 详细参考 获取粉丝服务平台开发接口的access token。 |
receiver_id | true | long | 消息接收方的ID。 |
template_id | false | string | 用户模板的ID,utid。 |
data | true | string | 要发给用户的数据,json格式。 |
注意事项
- 1、请求示例:
http://api.weibo.com/2/eps/template/send.json?access_tocken=2.00DtpjEDBOC92Eecbf500fd5RdBZ8D&receiver_id=2662732725&template_id=9db1c3adf9a06fbd4bc94df2e2322a7484da0f7c7d1bfe24048b0babc707e301&data={"key1":"MockValue1","key2":"MockValue2","key3.":"MockValue3","key4":{"subkey0":"subMockValue0","subkey1":"subMockValue1"}}
- 2、调用接口前,需要先申请到模板消息ID;
返回结果
// 成功返回 { "result": true } // 失败返回 { "result": false, "error": "uid invalid", "error_code": "30006", "request":"/2/eps/template/send.json" }