墙板卡片

一个呼叫中心墙板,从楼层远处可读:等待通话数、最长等待时间、服务水平与目标对比、坐席状态、接听和放弃通话数。

保持呼叫等待状态,并在整个呼叫中心楼层显示最长等待时间。比较服务水平与目标,并显示按状态、接听呼叫和放弃呼叫的代理。

直播卡片

此卡由浏览器绘制,使用与播放器相同的代码,带示例数据。

类别:运营。标签:排队和等待,数字和指标,警报和状态,办公室和工作场所。

布局

此全屏卡在横屏或竖屏时填满整个屏幕,不作为角落、芯片或条带放置。

布局:全屏。表单:横向,纵向。

卡片布局、主题和发布。浏览卡片。

数据与隐私

此卡使用其配置的属性和实时卡数据。

属性

有关主题、背景、强调色和位置,请参见通用属性。

创建卡片时,在卡片的params中设置静态属性。其数据文档仅包含动态属性。嵌套行描述其父属性的内容。

静态属性

名称类型默认数值和限制描述
titlestring"Contact centre"maxLength:40
serviceLevelTargetnumber80最小值:1;最大值:100服务水平目标,百分比。
serviceLevelSecondsinteger20最小值:1;最大值:3600目标测量的响应时间,单位秒。
waitingWarninteger3最小值:1;最大值:100000呼叫等待数达到时,图块变为琥珀色。
waitingAlertinteger8最小值:1;最大值:100000呼叫等待数达到时,图块变为红色。
longestWarnSecondsinteger60最小值:1;最大值:86400方块变为琥珀色的最长等待时间。
longestAlertSecondsinteger180最小值:1;最大值:86400方块变为红色的最长等待时间。
abandonWarnPercentnumber5最小值:0;最大值:100瓦片变为琥珀色的放弃率。
abandonAlertPercentnumber10最小值:0;最大值:100瓦片变为红色的放弃率。
staleMinutesinteger5最小值:1;最大值:1440早于此时间的数字显示为“# 分钟前更新”。
backgroundColor字符串,空值null模式:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"用纯色 CSS 顺序覆盖卡片背景和底板。#RRGGBBAA 提供透明度。背景无则优先。
textColor字符串,空值null模式:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"覆盖主文本和次要文本颜色。强调色和语义状态色保持原有功能。

动态属性

名称类型默认数值和限制描述
waiting整数,空值null最小值:0;最大值:10000000当前排队等待的呼叫数。
longestWaitSeconds整数,空值null最小值:0;最大值:10000000当前队列中最长等待时间,单位秒。
serviceLevel数字,空值null最小值:0;最大值:100迄今为止的服务水平,百分比。未包含的为answeredInTarget超过应答加放弃的部分。
answeredInTarget整数,空值null最小值:0;最大值:10000000今日在目标时间内接听的呼叫。
answered整数,空值null最小值:0;最大值:10000000今日接听的呼叫。
abandoned整数,空值null最小值:0;最大值:10000000今日放弃的呼叫。
agents对象,空值nulladditionalProperties:false按状态分类的智能体。
agents.availableinteger0最小值:0;最大值:100000准备接听电话的智能体。
agents.onCallinteger0最小值:0;最大值:100000通话中的智能体。
agents.wrapUpinteger0最小值:0;最大值:100000处于通话后工作状态的智能体。
agents.awayinteger0最小值:0;最大值:100000休息或其他离开的智能体。
updatedAtstring""maxLength:40数字被采集的 ISO 8601 时间点;驱动“# 分钟前更新”提示。

画布示例

将静态属性保存为 params.json 并创建卡片。结果中包含它的 crd_ ID。

{
  "theme": "neomustard"
}
screenrig card create --type wallboard --major 1 --file params.json

将此项目添加到播放列表页面的primitives中,并用该 ID 替换示例中的 ID。发布播放列表并分配屏幕。

{
  "id": "wallboard",
  "primitive": "card",
  "card": "crd_01EXAMPLECARD000000000",
  "layout": "full",
  "content_fit": "fill"
}

写入实时数据

创建卡片后向其写入文档,之后替换该文档即可更新屏幕,无需重新发布。卡片会按其动态属性检查每次写入,并拒绝它不接受的文档。请使用与播放列表相同的项目。

将文档保存为card-data.json。CLI直接读取文档,无需包装:

{
  "waiting": null,
  "longestWaitSeconds": null,
  "serviceLevel": null,
  "answeredInTarget": null,
  "answered": null,
  "abandoned": null,
  "agents": null,
  "updatedAt": ""
}
screenrig card data put crd_01EXAMPLECARD000000000 --file card-data.json

或直接调用 API。API 将相同文档包装在 document 字段中。智能体令牌已指定其项目,因此不发送项目头;若发送 ScreenRig-Project,必须与令牌项目匹配。通过环境提供 API 授权;详见 API 认证。

curl --request PUT "https://api.screenrig.ai/api/cards/crd_01EXAMPLECARD000000000/data" \
  --header "Authorization: Bearer $SCREENRIG_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"document":{"waiting":null,"longestWaitSeconds":null,"serviceLevel":null,"answeredInTarget":null,"answered":null,"abandoned":null,"agents":null,"updatedAt":""}}'