模板消息

跳转到: 导航, 搜索

发送模板消息

当用户主动发消息给认证账号后,微博将会把消息数据推送给开发者,开发者可以调用客服消息接口一定次数。

用户发送消息,关注/订阅事件,点击自定义菜单,扫描二维码事件后,目前修改为开发者在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"
}