# 推送通知 你可以直接操作的 。

> 用 Pocket Alert 为推送通知添加操作按钮：直接在锁屏上打开 URL、发起 HTTP 请求或复制文本。为部署和 AI 智能体搭建一键审批流程。

<!-- source: https://pocketalert.app/zh/features/action-buttons -->

最后更新：2026-10-25

为任意推送添加最多三个按钮。无需解锁手机或打开电脑，即可打开链接、发送 HTTP 请求或复制一个值。

文档：https://info.pocketalert.app/features/action-buttons.html

## 从普通告警到一键操作

1. **选择类型** — 先确定按钮的作用：打开 URL、调用端点，还是复制一个值。
2. **添加到消息中** — 在消息中添加 actions 数组，最多三个条目，每个条目包含 type、label 和 value。
3. **在手机上点击** — 发送消息。按钮会同时显示在通知上以及应用内的消息中。

## 三种按钮，一个数组

一条只告诉你发生了什么的通知，最终还得你去别处处理。操作按钮正是为了填补这一空白。

- **直达目标** — view 按钮可以直接打开 URL，例如失败的构建、订单或控制台，无需你再去翻找标签页。
- **后台执行请求** — http 按钮会以你设定的方法、请求头和请求体发送请求。一键重启服务或确认事故。
- **轻松复制** — copy 按钮可将一个值放入剪贴板。一次性验证码、事故 ID 和令牌，无需在手机上费力选中文本。
- **审批流程** — 两个分别标注为「批准」和「拒绝」的 http 按钮，能让一条推送变成一个单击即可操作的控制面板，适用于任何需要人工确认才能继续的流程。
- **横幅消失后仍可使用** — 按钮位于消息内部，而不仅限于横幅。即使你划掉了通知，之后依然可以找到并使用这些按钮。
- **来自 Webhook 的按钮** — Webhook 模板会根据传入的负载填充按钮 URL，因此每条告警都会链接到其对应的问题、订单或构建。

## 操作按钮的工作原理

    
通过 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` 会把应用切换到前台。

### HTTP 按钮的请求会发送到哪里？

请求直接从你的手机发送到你的端点。Pocket Alert 不会代理该请求，也从不查看响应体。你的端点需要的任何认证请求头都可以添加，并会随按钮一同发送。

### 按钮标签会在 iPhone 上显示吗？

会显示。iPhone 和 Android 都会显示你发送的确切标签，无论是在通知上还是消息内。如果 iOS 无法及时准备自定义按钮，则会按类型回退为通用标签（打开、执行或复制），按钮仍然可以正常使用。

### Webhook 能自动添加按钮吗？

可以。Webhook 可以携带一个操作模板，其中的 `%path%` 占位符会用传入负载中的数据填充，因此 Sentry 告警到达时就会带有一个指向该具体问题的「打开问题」按钮。替换的值会进行 JSON 转义，所以负载无法改写 URL。

### 如果我连续点击两次按钮会怎样？

点击两次会发送两次请求，重复请求不会被拦截，这是有意为之。如果重复触发的代价较高，请让端点具备幂等性。操作按钮属于付费功能，在免费套餐中会在服务端被移除，消息仍会送达，只是不带按钮。
