用 cURL 发送推送通知。
脚本一结束，手机就响起。
只需一条 cURL 命令，即可向您的 iPhone 或 Android 手机发送推送通知。把它粘贴到部署、备份、CI 任务或长时间训练任务的末尾，无论您身在何处，提醒都会送达。
无需发布应用，无需 Firebase 项目，无需 APNs 证书。在 AgentsRoom 中创建一个收件箱，复制它的端点和仅限发送的密钥即可。每条通知还会保存在可搜索的历史记录中，桌面端和手机上都能查看。
$ curl POST /api/dev-inboxes/…/push
{"title":"部署完成"}
202 Accepted
部署完成
api v2.4 已在生产环境上线
任何脚本发出一个 HTTPS 请求，手机收到一条通知，收件箱里保留一份副本。
大多数耗时任务都在悄无声息中结束。部署二十分钟前就完成了，夜间备份在凌晨 3 点失败了，数据库迁移还在等您处理，而您只有主动去看时才会发现。推送通知是让您不必一直盯着的最省事的办法，但要接入它，通常需要一个移动应用、一个 Firebase 项目，还有需要续期的证书。
AgentsRoom 本来就在您的手机上。Push API 让它直接成为接收端：每个收件箱都有自己的 HTTPS 端点和仅限发送的密钥，任何能运行 cURL 的东西都能把消息送到您的锁屏上。无论是 shell 脚本、GitHub Actions 步骤、cron 任务，还是您自己应用中的服务器事件。
每条提醒也会存储在服务器上，放在一个您可以从桌面端或手机搜索的收件箱中。您的电脑可以关着：端点、收件箱和推送投递都运行在 AgentsRoom 的服务器上。
通知所需一应俱全，无需自行托管
一个 JSON 正文，一个放密钥的请求头，外加几项在脚本无人值守运行时至关重要的保障。
标题、正文、链接和图片
可发送最多 160 个字符的标题、最多 16,000 个字符的正文、一个要打开的链接和一张公开的 HTTPS 图片。手机上显示简短预览，收件箱保留完整内容。
有声或静音
每个收件箱都有默认提示音，每个请求都可以覆盖它：备份失败时用设备提示音，例行报告则静音。
脚本重试也不会重复
添加 Idempotency-Key 请求头后，重试的请求会返回同一条消息，手机不会响两次，也不会再次占用您的额度。
可撤销的仅限发送密钥
脚本中的密钥只能发送，无法读取收件箱，也无法更改其设置。密钥泄露时可以重新生成，撤销后会立即停止接收新消息。
电脑关机也能工作
端点和收件箱都运行在服务器上。用同一账户登录 AgentsRoom 移动应用，允许通知，然后就可以合上笔记本电脑了。
默认私密，按需共享
收件箱属于您的账户或某一个项目。在 Team 或 Pro 群组中，您可以选择同样接收提醒的队友。他们永远看不到密钥。
整个集成只需一个请求
从收件箱设置中复制，真实的端点和密钥已经填好。
POST /pushcurl -X POST https://agentsroom.dev/api/dev-inboxes/INBOX_ID/push \
-H 'Authorization: Bearer SENDING_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: deploy-2481' \
-d '{"title":"Deploy finished","body":"api v2.4 is live","sound":"default",
"linkUrl":"https://example.com/releases/2481"}'202 响应表示消息已存入您的收件箱。之后能否送达手机，取决于操作系统、您的通知设置和推送服务。在 Windows 上，复制按钮会提供一个调用 curl.exe 的 PowerShell 版本。
从零到第一条通知
三个步骤，大约两分钟，无需注册其他服务的账户。
打开推送并创建收件箱
在项目中，点击项目坞中的推送，或从通知设置中打开。选择您的账户或当前项目，然后从“新安装”或“部署完成”等模板开始。
复制 cURL 命令
“连接与设置”中会显示端点、仅限发送的密钥和一个可直接运行的请求。编辑标题和正文，然后保存集成，同一模板就会在您的每台设备上同步。
在脚本中运行
把命令粘贴到部署脚本、CI 任务或 cron 任务的末尾。下次运行时就会发送通知，消息会出现在桌面端和移动端的推送标签页中。
开发者最先接入的场景
凡是在您没盯着时结束的任务，都很适合。
部署完成或失败
在部署脚本或 CI 任务末尾加一行，附上发布页面或失败日志的链接。
新用户或新安装
当有人注册、安装或升级您的应用时，从后端调用端点，在手机上第一时间分享这份喜悦。
备份和 cron 任务
夜间备份失败时使用设备提示音，成功时保持静音。历史记录会告诉您哪几晚出了问题。
耗时的构建、导入和训练任务
不必再每十分钟查看一次终端。任务完成时会通知您，即使您已离开工位。
专为在脚本中使用而设计
密钥通过 Authorization 请求头传递，绝不放在 URL 中，因此不会出现在代理日志里。密钥长度为 192 位，以哈希形式存储用于查找，且只向收件箱所有者显示。
泄露的密钥一键即可切断：重新生成后，旧密钥从下一个请求起就会被拒绝；撤销后，收件箱将不再接受任何内容。已收到的消息仍可阅读。
请将收到的内容视为不可信内容。图片在您打开消息时从其公开主机加载，链接只有在您点击时才会打开。
让您的代理来完成接入
dev_inboxes_listdev_inbox_createdev_inbox_configuredev_inbox_membersdev_inbox_messagesdev_inbox_test只要说一句“有人安装我的应用时，在手机上通知我”，您的 AI 编程代理就能通过 AgentsRoom MCP 工具创建收件箱、配置模板，并在代码中加入调用。无论使用哪种 CLI，每个代理都能使用：Claude Code、Codex、Antigravity 等等。
代理在更改设置或共享收件箱之前会先征求您的同意，并且绝不会把发送密钥提交到您的代码仓库。
了解 AgentsRoom MCP每月推送额度
按自然月计算，所有收件箱合计。邮件有单独的额度。
访客
10
每月
免费
100
每月
Plus
200
每月
Pro
无限制
Team 席位包含 Pro。消息保留 90 天，删除消息不会返还其通知额度。
您的服务发送的是邮件而不是 HTTP 请求？那就为它们分配一个专属地址。
开发者邮件收件箱想在 AI 代理完成一轮任务时收到通知，而不是在脚本结束时？那是另一项内置的通知功能。
代理通知推送通知 API：常见问题
如何用 cURL 向手机发送推送通知？
在 AgentsRoom 中创建一个推送收件箱，从“连接与设置”中复制端点和仅限发送的密钥，然后发送一个 POST 请求，JSON 正文中至少包含标题。要接收通知，请用同一账户登录 AgentsRoom 移动应用并允许通知。
我的电脑需要一直开着吗？
不需要。端点、收件箱和投递都运行在 AgentsRoom 的服务器上。即使笔记本电脑合上，通知仍会送达您的手机，消息也会在收件箱中等着您。
iPhone 和 Android 都支持吗？
支持。通知会发送到在 iOS 和 Android 版 AgentsRoom 移动应用中登录了您账户的所有设备。点击通知即可在对应的收件箱中打开消息。
一条通知可以包含哪些内容？
最多 160 个字符的标题、最多 16,000 个字符的正文、可选的公开 HTTPS 图片、可选的 HTTPS 链接，以及提示音：设备默认提示音或静音。不支持自定义声音文件。
脚本重试时如何避免重复通知？
发送一个 Idempotency-Key 请求头，其值对该事件唯一，例如部署编号。使用相同密钥的重试会返回原始消息，不会发送第二条通知，也不会再次占用您的额度。
如果发送密钥泄露了怎么办？
该密钥只能发送消息，永远无法读取消息。在收件箱设置中重新生成它，旧密钥从下一个请求起就会被拒绝；或者撤销它，在您创建新密钥之前停止接收新消息。
我可以发送多少条通知？
按自然月计算，所有收件箱合计：访客 10 条，免费账户 100 条，Plus 200 条，Pro 无限制。Team 席位包含 Pro。邮件有单独的额度。
我的队友能收到同样的提醒吗？
可以，在 Team 或 Pro 群组中即可。所有者选择可以阅读该收件箱并接收其通知的队友。他们永远看不到发送密钥，也无法更改设置。
相关功能
开发者邮件收件箱
为每个项目分配一个专属的收信邮箱地址。服务告警、cron 报告和应用邮件都会进入 AgentsRoom，而不是您的个人邮箱，在桌面端和移动端都能阅读。
通知
未读徽章、桌面提醒和Dock计数会告诉你哪个代理已经完成。移动推送带上代理头像，解锁手机之前你就知道是谁。
触发器：webhook 模式
用 webhook 而不是时钟来触发 AI 编程代理。把一个公开 URL 粘贴进 GitHub、GitLab、Slack、Linear、Sentry 或任何能发送 POST JSON 的服务，事件一到，AgentsRoom 就启动一个代理：一个 pull request 被打开、一次构建失败、一个工单被创建、一条告警响起。签名会被校验，可选的 payload 过滤条件，突发上限，而 payload 会变成提示词变量。轮询式的代理每一轮都在烧 token；webhook 触发器在什么都没发生时不消耗任何东西。
移动伴侣
用手机口述提示词并附加文件。在 iOS 或 Android 上分享截图，选择项目，再发送给代理或保存到该项目的待办事项中。
让您的脚本主动提醒您
下载 AgentsRoom，创建一个推送收件箱，两分钟内发出您的第一条通知。
配套应用：随时随地监控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接发送到您的公开待办清单。