API thông báo đẩy

Thông báo đẩy từ cURL.
Script chạy xong, điện thoại rung lên.

Gửi thông báo đẩy đến iPhone hoặc điện thoại Android chỉ với một lệnh cURL. Dán nó vào cuối một lần triển khai, một bản sao lưu, một job CI hay một lượt huấn luyện dài, và cảnh báo sẽ đến với bạn dù bạn ở đâu.

Không cần phát hành ứng dụng, không cần dự án Firebase, không cần chứng chỉ APNs. Tạo một hộp thư trong AgentsRoom, sao chép endpoint và khóa chỉ để gửi của nó, mọi thông báo cũng được lưu trong lịch sử có thể tìm kiếm trên máy tính và điện thoại của bạn.

deploy.sh

$ curl POST /api/dev-inboxes/…/push

{"title":"Triển khai hoàn tất"}

202 Accepted

Điện thoại của bạnbây giờ

Triển khai hoàn tất

api v2.4 đã chạy trên production

Một yêu cầu HTTPS từ bất kỳ script nào, một thông báo trên điện thoại, một bản sao được giữ trong hộp thư.

Phần lớn tác vụ dài kết thúc trong im lặng. Lần triển khai đã xong từ hai mươi phút trước, bản sao lưu đêm qua thất bại lúc 3 giờ sáng, đợt migration vẫn đang chờ bạn, và bạn chỉ biết khi tự vào kiểm tra. Thông báo đẩy là cách rẻ nhất để thôi phải kiểm tra, nhưng thiết lập nó thường đòi hỏi một ứng dụng di động, một dự án Firebase và chứng chỉ phải gia hạn.

AgentsRoom vốn đã có mặt trên điện thoại của bạn. Push API biến nó thành nơi nhận: mỗi hộp thư có endpoint HTTPS riêng và một khóa chỉ để gửi, nên bất cứ thứ gì chạy được cURL đều có thể chạm tới màn hình khóa của bạn. Một shell script, một bước GitHub Actions, một cron job, một sự kiện máy chủ trong chính ứng dụng của bạn.

Mỗi cảnh báo cũng được lưu trên máy chủ, trong một hộp thư bạn có thể tìm kiếm từ máy tính hoặc điện thoại. Máy tính của bạn có thể gập lại: endpoint, hộp thư và việc gửi đều chạy trên máy chủ của AgentsRoom.

Mọi thứ một thông báo cần, không phải tự host gì

Một body JSON, một header cho khóa và vài đảm bảo quan trọng khi script chạy mà không ai trông chừng.

Tiêu đề, nội dung, liên kết và hình ảnh

Gửi tiêu đề tối đa 160 ký tự, nội dung tối đa 16.000 ký tự, một liên kết để mở và một hình ảnh HTTPS công khai. Điện thoại hiển thị bản xem trước ngắn, hộp thư giữ toàn bộ văn bản.

Có âm thanh hoặc im lặng

Mỗi hộp thư có âm thanh mặc định và mỗi yêu cầu có thể ghi đè: âm thanh của thiết bị cho bản sao lưu thất bại, im lặng cho báo cáo định kỳ.

Không trùng lặp khi script thử lại

Thêm header Idempotency-Key và yêu cầu được thử lại sẽ trả về cùng một tin nhắn thay vì làm điện thoại rung hai lần. Nó cũng không bị trừ vào hạn mức của bạn thêm lần nữa.

Khóa chỉ để gửi, có thể thu hồi

Khóa trong script của bạn chỉ có thể gửi. Nó không thể đọc hộp thư hay thay đổi cài đặt. Tạo lại khóa nếu bị lộ, hoặc thu hồi để chặn ngay tin nhắn mới.

Vẫn chạy khi máy tính đã tắt

Endpoint và hộp thư chạy trên máy chủ. Đăng nhập ứng dụng di động AgentsRoom bằng cùng tài khoản, cho phép thông báo, rồi gập laptop lại.

Riêng tư, hoặc chia sẻ có chủ đích

Một hộp thư thuộc về tài khoản của bạn hoặc một dự án. Trong nhóm Team hoặc Pro, hãy chọn những đồng đội cùng nhận cảnh báo. Họ không bao giờ thấy khóa.

Toàn bộ phần tích hợp chỉ là một yêu cầu

Sao chép từ phần cài đặt hộp thư, endpoint và khóa thật của bạn đã được điền sẵn.

Cảnh báo triển khai từ một shell scriptPOST /push
curl -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"}'

Phản hồi 202 nghĩa là tin nhắn đã được lưu trong hộp thư của bạn. Việc gửi đến điện thoại sau đó phụ thuộc vào hệ điều hành, cài đặt thông báo của bạn và dịch vụ push. Trên Windows, nút sao chép cho bạn phiên bản PowerShell gọi curl.exe.

Từ con số không đến thông báo đầu tiên

Ba bước, khoảng hai phút, không cần tài khoản ở dịch vụ nào khác.

01

Mở Thông báo đẩy và tạo hộp thư

Trong một dự án, nhấn Thông báo đẩy trên thanh dock của dự án, hoặc mở từ phần cài đặt thông báo. Chọn tài khoản của bạn hoặc dự án hiện tại, rồi bắt đầu từ một mẫu như Lượt cài đặt mới hoặc Triển khai hoàn tất.

02

Sao chép lệnh cURL

Kết nối và cài đặt hiển thị endpoint, khóa chỉ để gửi và một yêu cầu sẵn sàng để chạy. Sửa tiêu đề và nội dung, rồi lưu phần tích hợp để cùng một mẫu theo bạn trên mọi máy.

03

Chạy từ script của bạn

Dán lệnh vào cuối script triển khai, job CI hoặc tác vụ cron. Lần chạy tiếp theo sẽ gửi thông báo, và tin nhắn xuất hiện trong tab Thông báo đẩy trên máy tính và di động.

Những thứ lập trình viên kết nối đầu tiên

Bất cứ việc gì kết thúc khi bạn không để mắt tới đều là ứng viên tốt.

Triển khai xong hoặc thất bại

Thêm một dòng vào cuối script triển khai hoặc job CI, kèm liên kết đến bản phát hành hoặc đến log bị lỗi.

Người dùng mới hoặc lượt cài đặt mới

Gọi endpoint từ backend khi có người đăng ký, cài ứng dụng của bạn hoặc nâng cấp, và ăn mừng ngay trên điện thoại.

Sao lưu và cron job

Dùng âm thanh của thiết bị khi bản sao lưu đêm thất bại và im lặng khi thành công. Lịch sử cho thấy đêm nào gặp sự cố.

Build, import và huấn luyện kéo dài

Thôi phải mười phút lại kiểm tra terminal một lần. Job sẽ báo cho bạn khi xong, kể cả khi bạn đã rời bàn làm việc.

Được thiết kế để nằm trong script của bạn

Khóa được truyền trong header Authorization, không bao giờ nằm trong URL, nên không lọt vào log của proxy. Khóa dài 192 bit, được lưu dưới dạng hash để tra cứu và chỉ hiển thị cho chủ sở hữu hộp thư.

Khóa bị lộ được cắt chỉ với một cú nhấp: tạo lại và khóa cũ bị từ chối ngay từ yêu cầu tiếp theo, hoặc thu hồi để hộp thư ngừng nhận mọi thứ. Tin nhắn đã nhận vẫn đọc được.

Hãy coi những gì gửi đến là nội dung không đáng tin cậy. Hình ảnh được tải từ máy chủ công khai của nó khi bạn mở tin nhắn, và liên kết chỉ mở khi bạn chạm vào.

MCP

Nhờ agent của bạn thiết lập

dev_inboxes_listdev_inbox_createdev_inbox_configuredev_inbox_membersdev_inbox_messagesdev_inbox_test

Hãy nói “báo cho tôi trên điện thoại khi có người cài ứng dụng của tôi” và agent lập trình AI của bạn có thể tạo hộp thư, cấu hình mẫu và thêm lệnh gọi vào mã của bạn bằng các công cụ MCP của AgentsRoom. Mọi agent đều có các công cụ này, dù dùng CLI nào: Claude Code, Codex, Antigravity và các CLI khác.

Agent sẽ hỏi trước khi thay đổi cài đặt hoặc chia sẻ hộp thư, và không bao giờ commit khóa gửi vào repository của bạn.

Khám phá MCP của AgentsRoom

Hạn mức push hằng tháng

Tính theo tháng dương lịch, cho tất cả hộp thư của bạn. Email có hạn mức riêng.

Khách

10

mỗi tháng

Miễn phí

100

mỗi tháng

Plus

200

mỗi tháng

Pro

Không giới hạn

Ghế Team bao gồm Pro. Tin nhắn được giữ trong 90 ngày, và xóa một tin nhắn không hoàn lại lượt thông báo của nó.

Dịch vụ của bạn gửi email thay vì yêu cầu HTTP? Hãy cấp cho chúng một địa chỉ riêng.

Hộp thư email cho nhà phát triển

Bạn muốn biết khi nào một agent AI xong lượt của nó, chứ không phải khi script chạy xong? Đó là một loại thông báo tích hợp sẵn, riêng biệt.

Thông báo của agent

API thông báo đẩy: câu hỏi thường gặp

Làm sao gửi thông báo đẩy đến điện thoại từ cURL?

Tạo một hộp thư Thông báo đẩy trong AgentsRoom, sao chép endpoint và khóa chỉ để gửi từ Kết nối và cài đặt, rồi chạy một yêu cầu POST với body JSON có ít nhất một tiêu đề. Đăng nhập ứng dụng di động AgentsRoom bằng cùng tài khoản và cho phép thông báo để nhận.

Máy tính của tôi có cần luôn bật không?

Không. Endpoint, hộp thư và việc gửi chạy trên máy chủ của AgentsRoom. Laptop của bạn có thể gập lại: thông báo vẫn đến điện thoại và tin nhắn chờ sẵn trong hộp thư.

Có hoạt động trên cả iPhone và Android không?

Có. Thông báo được gửi đến mọi thiết bị đăng nhập tài khoản của bạn trong ứng dụng di động AgentsRoom trên iOS và Android. Chạm vào thông báo sẽ mở tin nhắn trong đúng hộp thư.

Một thông báo có thể chứa những gì?

Tiêu đề tối đa 160 ký tự, nội dung tối đa 16.000 ký tự, một hình ảnh HTTPS công khai tùy chọn, một liên kết HTTPS tùy chọn và âm thanh: mặc định của thiết bị hoặc im lặng. Không hỗ trợ tệp âm thanh tùy chỉnh.

Làm sao tránh thông báo trùng lặp khi script thử lại?

Gửi header Idempotency-Key với một giá trị duy nhất cho sự kiện, chẳng hạn số thứ tự lần triển khai. Lần thử lại với cùng khóa sẽ trả về tin nhắn gốc mà không gửi thông báo thứ hai và không trừ thêm vào hạn mức của bạn.

Chuyện gì xảy ra nếu khóa gửi của tôi bị lộ?

Khóa này chỉ có thể gửi tin nhắn, không bao giờ đọc được chúng. Tạo lại khóa trong cài đặt hộp thư và khóa cũ bị từ chối ngay từ yêu cầu tiếp theo, hoặc thu hồi để chặn tin nhắn mới cho đến khi bạn tạo khóa mới.

Tôi có thể gửi bao nhiêu thông báo?

Theo tháng dương lịch và cho tất cả hộp thư của bạn: 10 khi là khách, 100 với tài khoản miễn phí, 200 với Plus và không giới hạn với Pro. Ghế Team bao gồm Pro. Email có hạn mức riêng.

Đồng đội của tôi có thể nhận cùng cảnh báo không?

Có, trong nhóm Team hoặc Pro. Chủ sở hữu chọn những đồng đội được đọc hộp thư và nhận thông báo của nó. Họ không bao giờ thấy khóa gửi và không thể thay đổi cài đặt.

Tính năng liên quan

Hộp thư email cho nhà phát triển

Cấp cho mỗi dự án một địa chỉ email nhận riêng. Cảnh báo dịch vụ, báo cáo cron và email ứng dụng về AgentsRoom, đọc được trên máy tính và di động, không vào hộp thư của bạn.

Thông Báo

Badge chưa đọc, thông báo desktop và số đếm trên dock cho bạn biết agent nào đã hoàn thành. Thông báo push di động mang theo ảnh đại diện của agent, nên bạn biết đó là ai trước khi mở khóa máy.

Bộ kích hoạt: chế độ webhook

Kích hoạt một agent AI lập trình từ một webhook thay vì từ đồng hồ. Dán một URL công khai vào GitHub, GitLab, Slack, Linear, Sentry hoặc bất kỳ dịch vụ nào biết gửi POST JSON, và AgentsRoom khởi chạy một agent ngay khi sự kiện đến: một pull request được mở, một bản build hỏng, một ticket được tạo, một cảnh báo bật lên. Chữ ký được kiểm tra, bộ lọc payload tùy chọn, giới hạn dồn dập, và payload trở thành các biến của prompt. Một agent phải thăm dò liên tục thì tốn token ở mỗi vòng lặp; một bộ kích hoạt webhook không tốn gì cho tới khi có chuyện xảy ra.

Trợ lý di động

Nhập prompt bằng giọng nói và đính kèm tệp từ điện thoại. Chia sẻ ảnh chụp màn hình trên iOS hoặc Android, chọn dự án rồi gửi đến agent hoặc lưu vào backlog của dự án.

Để script của bạn tự vỗ vai bạn

Tải AgentsRoom, tạo một hộp thư Thông báo đẩy và gửi thông báo đầu tiên trong hai phút.

Miễn phíTải AgentsRoom

Ứng dụng đồng hành: theo dõi agent khi đi đường

Sử dụng Claude, Codex, Antigravity CLI hoặc nhà cung cấp AI khác.

Tải tiện ích mở rộng
Chrome Web Store

Gửi lỗi và yêu cầu thẳng vào backlog công khai của bạn.

Nhiều dự án
Đa nhà cung cấp
Nhiều agent
Trạng thái trực tiếp
File diff & commit
Ứng dụng đồng hành mobile
Xem trước trực tiếp
Đội agent
Tự động hóa trình duyệt
Dev theo backlog
Thư viện prompt
Thư viện skill
Xem tất cả tính năng