三种按钮,一个数组
一条只告诉你发生了什么的通知,最终还得你去别处处理。操作按钮正是为了填补这一空白。
直达目标
view 按钮可以直接打开 URL,例如失败的构建、订单或控制台,无需你再去翻找标签页。
后台执行请求
http 按钮会以你设定的方法、请求头和请求体发送请求。一键重启服务或确认事故。
轻松复制
copy 按钮可将一个值放入剪贴板。一次性验证码、事故 ID 和令牌,无需在手机上费力选中文本。
审批流程
两个分别标注为「批准」和「拒绝」的 http 按钮,能让一条推送变成一个单击即可操作的控制面板,适用于任何需要人工确认才能继续的流程。
横幅消失后仍可使用
按钮位于消息内部,而不仅限于横幅。即使你划掉了通知,之后依然可以找到并使用这些按钮。
来自 Webhook 的按钮
Webhook 模板会根据传入的负载填充按钮 URL,因此每条告警都会链接到其对应的问题、订单或构建。
从普通告警到一键操作
选择类型
先确定按钮的作用:打开 URL、调用端点,还是复制一个值。
添加到消息中
在消息中添加 actions 数组,最多三个条目,每个条目包含 type、label 和 value。
在手机上点击
发送消息。按钮会同时显示在通知上以及应用内的消息中。
操作按钮的工作原理
通过 API、Webhook 或 MCP 服务器发送的任何消息,都可以添加 actions 数组。每个条目包含 type、label 和 value,其中 value 的含义取决于类型:对于 view 是 URL,对于 http 是 JSON 格式的请求描述,对于 copy 是原始文本。
按钮会随推送一同送达,并由操作系统渲染。点击按钮时,应用在本地处理:http 和 copy 无需打开任何页面即可执行,而 view 会将浏览器切换到前台。
审批模式
最值得优先搭建的是两个 http 按钮,分别为「批准」和「拒绝」,指向你自己的两个端点。任何需要等待人工介入的场景都适用:例如被手动签核卡住的部署流水线、超过阈值的退款,或是不应在无人监督时操作生产环境的 AI 智能体。
由于请求直接从手机发送到你的端点,这些 URL 背后的一切都完全由你掌控,包括认证。
需要了解的限制
最多三个按钮。view 和 http 需要有效的 http(s) URL,否则将返回 400。使用 Pocket Alert 2.0.1 或更高版本时,无论应用处于打开、后台还是关闭状态,按钮都能在系统通知上使用;较旧的应用版本仅在消息内显示按钮。
常见问题解答
每条消息最多三个。按钮按你发送的顺序显示,iOS 和 Android 均是如此。即使横幅通知已被关闭,按钮仍保留在消息内,随时可以使用。
共三种类型。view 用于打开 URL,http 会在后台发送一个 HTTP 请求,你可以自定义方法、请求头和请求体,copy 则将一个值复制到剪贴板。只有 view 会把应用切换到前台。
请求直接从你的手机发送到你的端点。Pocket Alert 不会代理该请求,也从不查看响应体。你的端点需要的任何认证请求头都可以添加,并会随按钮一同发送。
会显示。iPhone 和 Android 都会显示你发送的确切标签,无论是在通知上还是消息内。如果 iOS 无法及时准备自定义按钮,则会按类型回退为通用标签(打开、执行或复制),按钮仍然可以正常使用。
可以。Webhook 可以携带一个操作模板,其中的 %path% 占位符会用传入负载中的数据填充,因此 Sentry 告警到达时就会带有一个指向该具体问题的「打开问题」按钮。替换的值会进行 JSON 转义,所以负载无法改写 URL。
点击两次会发送两次请求,重复请求不会被拦截,这是有意为之。如果重复触发的代价较高,请让端点具备幂等性。操作按钮属于付费功能,在免费套餐中会在服务端被移除,消息仍会送达,只是不带按钮。