api:tips_send

发送客户端tips

给指定的客户端弹出如下图样式的Tips。

真实的Tips展示样式

请求地址

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

请求方式

post

请求样例

请求频率

详见频率限制

请求参数

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

此请求还需要如下参数

字段名称 字段类型 字段说明
to_all int (非必填,缺省值0)是否发给全部员工:
0 否,只发给指定的receivers;
1 全员发送,忽略receivers
receivers string (to_all选0时,必填)消息接收人,逗号分隔的open_id列表
window_title string (必填,urlencode)Tips弹出窗口的标题,限长24字符
tips_title string (必填,urlencode)Tips的消息标题,限长42字符
tips_content string (必填,urlencode)Tips的正文内容,限长264字符
tips_url string (非必填,urlencode)如果有链接,使用此参数,url,限长1024字节,url相关资料请参考企业QQ带登录态跳转到第三方应用
display_time int (非必填)窗口显示的时间:
0 一直显示不会自动消失
大于0 显示相应时间后自动关闭(单位:秒),最大512秒
need_verify int (非必填)是否需要单点登录:
0 代表不需要,直接进入tips_url指示的网址,此时tips_url不能为纯数字
1 代表跳转过去的时候,传送company_id,open_id,hashskey等用于身份校验和识别的信息
url_type int (非必填)tips对应的url类型:
0 代表原生tips,点击查看跳转对应的url,默认是0
1 代表弹出的tips本身就是一个页面
对于内嵌页面的tips,必须设置need_verify为1

返回结果

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

返回

api/tips_send.txt · 最后更改: 2016/04/22 17:09 (外部编辑)