模板消息
发送模板消息
当用户主动发消息给认证账号后,微博将会把消息数据推送给开发者,开发者可以调用客服消息接口一定次数。
用户发送消息,关注/订阅事件,点击自定义菜单,扫描二维码事件后,目前修改为开发者在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" }