用 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 和需求直接傳送到您的公開待辦清單。