模板消息
(以“楚杰好~”为内容创建页面) |
|||
| 第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"
}
