模板消息

跳转到: 导航, 搜索

模板消息

模板消息仅用于向用户发送重要的服务通知,只能用于符合其要求的服务场景中,如信用卡刷卡通知,商品购买成功通知等。不支持广告等营销类消息以及其它所有可能对用户造成骚扰的消息。


调用API接口发送模板消息之前,需要先在粉服管理后台申请模板ID;


说明:申请模板消息遇到问题可邮件 chujie@staff.sina.com.cn


URL

https://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 true string 用户模板的ID,utid。
data true string 要发给用户的数据,json格式,还需补充该json格式的说明文档
url false string 如果是发送纯文本格式的消息,则无需该字段
topcolor false string 消息顶部颜色,如果是发送纯文本格式的消息,则无需该字段

注意事项

  • 2、模板消息有两类;

一类是纯文本格式的模板消息,这类模板消息无需用到url和topcolor参数; 一类是卡片格式的模板消息,其格式如下:

返回结果

// 成功返回
{
    "result": true
}

// 失败返回
{
    "result": false,
    "error": "uid invalid",
    "error_code": "30006",
    "request":"/2/eps/template/send.json"
}



文档更新时间: 2022-11-17