api:broadcast_send

发送客户端广播

给客户端发送一个广播消息,样式如图所示。

 广播的样式示意图

请求地址

https://openapi.b.qq.com/api/broadcast/send

请求方式

post

请求样例

请求频率

详见频率限制

请求参数

所有向企业QQ发起的请求均包含该公共参数

此请求还需要如下参数

字段名称 字段类型 字段说明 是否必选
title string (urlencode)消息标题,限长31字符 必选
content string (urlencode)消息内容,纯文本限长450字符,富文本20000字节
注意,计算单位是不同的
必选
is_online bool 0 离线也发送 1 只发送在线
recv_dept_ids string 组织列表,用英文逗号”,”分隔 两者至少有一个要填
recv_open_ids string 用户open id列表,用英文逗号”,”分隔(以上两参数不能为空)
open_id string 这是公共参数中的一个,该参数表示发送广播的人的身份
is_rich int 是否采用富文本形式发送,是的话填1,否的话填0,缺省是0

返回结果

{
  "ret": 0,
  "msg": "调用成功"
}
字段名称 字段类型 字段说明
ret int 返回码:0 正常, >0 异常
msg string 如果ret不为0,会有相应的错误信息提示,UTF-8编码。

附录:富文本允许使用的HTML标签和属性列表

HTML标签

<blockquote></blockquote>
<strong></strong>
<div></div>
<span></span>
<sup></sup>
<sub></sub>
<ol></ol>
<ul></ul>
<li></li>
<p></p>
<hr />
<br />
<h1></h1>
<h2></h2>
<h3></h3>
<h4></h4>
<table></table>
<thead></thead>
<tbody></tbody>
<tfoot></tfoot>
<tr></tr>
<th></th>
<td></td>
<img />
<a></a>
<b></b>
<em></em>
<u></u>
<s></s>

允许使用的HTML属性和值

align="left" (center、right) <-- 属性值请使用双引号,单引号,或者没有,都是非法的
width="240" (30%)
height="108" (30%)
rowspan="2"
colspan="2"
border="1"
bordercolor="#000000"
cellpadding="2"
cellspacing="0"
href="http://www.qq.com"  (必须有 http:// 或者 https://)
src="http://www.qq.com/logo.gif"
alt="腾讯"
title="腾讯"
target="_blank" (self)

style="" 属性包括以下:
  width:55px; (30%)
  height:55px; (30%)
  font-family:SimSun; (SimSun、NSimSun、FangSong_GB2312、KaiTi_GB2312、SimHei、Microsoft YaHei、Arial、Arial Black、Times New Roman、Courier New、Tahoma、Verdana)
  font-size:14px;
  font-weight:700; (blod、normal、bolder、lighter、100 至 900)
  color:#E56600;
  line-height:1.5; (1.5、120%、14px)
  text-align:left; (center、right)
  vertical-align:baseline; (baseline、top、middle、bottom)
  background-color:#64451D;

返回

api/broadcast_send.txt · 最后更改: 2016/04/22 16:55 (外部编辑)