Push Bildirim API'si

cURL ile push bildirimleri.
Betiğin biter, telefonun titrer.

Tek bir cURL çağrısıyla iPhone ya da Android telefonuna push bildirimi gönder. Bir dağıtımın, yedeklemenin, CI işinin veya uzun bir model eğitiminin sonuna yapıştır, uyarı nerede olursan ol sana ulaşsın.

Yayınlanacak uygulama yok, Firebase projesi yok, APNs sertifikası yok. AgentsRoom'da bir gelen kutusu oluştur, uç noktasını ve yalnızca gönderim anahtarını kopyala; her bildirim ayrıca masaüstünde ve telefonunda aranabilir bir geçmişte saklanır.

deploy.sh

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

{"title":"Dağıtım tamamlandı"}

202 Accepted

Telefonunşimdi

Dağıtım tamamlandı

api v2.4 üretimde yayında

Herhangi bir betikten tek HTTPS isteği, telefonunda tek bildirim, gelen kutusunda saklanan bir kopya.

Uzun görevlerin çoğu sessizce biter. Dağıtım yirmi dakika önce tamamlandı, gece yedeklemesi saat 03:00'te başarısız oldu, taşıma hâlâ seni bekliyor ve bunu ancak gidip baktığında öğreniyorsun. Bakmayı bırakmanın en ucuz yolu bir push bildirimidir, ama bunu kurmak genellikle bir mobil uygulama, bir Firebase projesi ve yenilenmesi gereken sertifikalar demektir.

AgentsRoom zaten telefonunda. Push API onu bir alıcıya dönüştürür: her gelen kutusunun kendi HTTPS uç noktası ve yalnızca gönderim anahtarı vardır, cURL çalıştırabilen her şey artık kilit ekranına ulaşabilir. Bir shell betiği, bir GitHub Actions adımı, bir cron işi, kendi uygulamandaki bir sunucu olayı.

Her uyarı ayrıca sunucuda, masaüstünden veya telefonundan arayabileceğin bir gelen kutusunda saklanır. Bilgisayarın kapalı olabilir: uç nokta, gelen kutusu ve teslimat AgentsRoom sunucularında çalışır.

Bir bildirimin ihtiyacı olan her şey, barındıracak hiçbir şey yok

Tek bir JSON gövdesi, anahtar için tek bir başlık ve bir betik gözetimsiz çalıştığında önem kazanan birkaç güvence.

Başlık, metin, bağlantı ve görsel

En fazla 160 karakterlik bir başlık, en fazla 16.000 karakterlik bir metin, açılacak bir bağlantı ve herkese açık bir HTTPS görseli gönder. Telefon kısa bir önizleme gösterir, gelen kutusu tam metni saklar.

Sesli ya da sessiz

Her gelen kutusunun varsayılan bir sesi vardır ve her istek bunu geçersiz kılabilir: başarısız bir yedekleme için cihaz sesi, rutin bir rapor için sessiz.

Betik yeniden denediğinde mükerrer bildirim yok

Bir Idempotency-Key başlığı ekle; yeniden denenen istek telefonunu iki kez titretmek yerine aynı mesajı döndürür. Kotandan tekrar düşülmez.

İptal edebileceğin yalnızca gönderim anahtarları

Betiğindeki anahtar yalnızca gönderebilir. Gelen kutusunu okuyamaz, ayarlarını değiştiremez. Sızarsa yeniden oluştur ya da yeni mesajları anında durdurmak için iptal et.

Bilgisayarın kapalıyken de çalışır

Uç nokta ve gelen kutusu sunucuda çalışır. AgentsRoom mobil uygulamasına aynı hesapla giriş yap, bildirimlere izin ver ve dizüstü bilgisayarını kapat.

Özel ya da bilinçli olarak paylaşılan

Bir gelen kutusu hesabına veya tek bir projeye aittir. Team ya da Pro grubunda, uyarılarını seninle birlikte alacak ekip arkadaşlarını seç. Anahtarı asla görmezler.

Tüm entegrasyon tek bir istek

Gerçek uç noktan ve anahtarın önceden doldurulmuş olarak gelen kutusu ayarlarından kopyala.

Bir shell betiğinden dağıtım uyarısıPOST /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"}'

202 yanıtı, mesajın gelen kutunda saklandığı anlamına gelir. Telefona teslimat bundan sonra işletim sistemine, bildirim ayarlarına ve push hizmetine bağlıdır. Windows'ta kopyalama düğmesi sana curl.exe'yi çağıran bir PowerShell sürümü verir.

Sıfırdan ilk bildirimine

Üç adım, yaklaşık iki dakika, başka bir hizmette hesap gerekmez.

01

Anlık bildirimler'i aç ve bir gelen kutusu oluştur

Bir projede, proje dock'undaki Anlık bildirimler'e tıkla ya da bildirim ayarlarından aç. Hesabını veya mevcut projeyi seç ve Yeni kurulum ya da Dağıtım tamamlandı gibi bir şablonla başla.

02

cURL komutunu kopyala

Bağlantı ve ayarlar bölümü uç noktayı, yalnızca gönderim anahtarını ve çalıştırılmaya hazır bir isteği gösterir. Başlığı ve metni düzenle, ardından aynı şablonun her makinede seninle olması için entegrasyonu kaydet.

03

Betiğinden çalıştır

Komutu dağıtım betiğinin, CI işinin veya cron görevinin sonuna yapıştır. Bir sonraki çalıştırmada bildirim gönderilir ve mesaj masaüstünde ve mobilde Anlık bildirimler sekmesinde görünür.

Geliştiricilerin ilk bağladıkları

Sen bakmıyorken biten her şey iyi bir aday.

Dağıtım tamamlandı ya da başarısız oldu

Dağıtım betiğinin veya CI işinin sonuna, sürüme ya da hatalı loglara giden bir bağlantıyla tek bir satır ekle.

Yeni bir kullanıcı ya da yeni bir kurulum

Biri kaydolduğunda, uygulamanı kurduğunda veya planını yükselttiğinde arka ucundan uç noktayı çağır ve kutlamayı telefonundan yap.

Yedeklemeler ve cron işleri

Gece yedeklemesi başarısız olduğunda cihaz sesini kullan, başarılı olduğunda sessiz kal. Geçmiş, hangi gecelerin sorunlu geçtiğini gösterir.

Uzun derlemeler, içe aktarmalar ve model eğitimleri

Her on dakikada bir terminale bakmayı bırak. Masadan kalkmış olsan bile iş bittiğinde sana haber verir.

Betiklerinin içinde yaşamak için tasarlandı

Anahtar URL'de değil, Authorization başlığında taşınır; böylece proxy loglarına düşmez. 192 bit uzunluğundadır, arama için karma (hash) olarak saklanır ve yalnızca gelen kutusunun sahibine gösterilir.

Sızan bir anahtar tek tıkla devre dışı kalır: yeniden oluştur, eskisi bir sonraki istekten itibaren reddedilsin ya da gelen kutusunun hiçbir şey kabul etmemesi için iptal et. Daha önce alınan mesajlar okunabilir kalır.

Gelen içeriği güvenilmeyen içerik olarak değerlendir. Görseller, bir mesajı açtığında herkese açık sunucularından yüklenir; bağlantılar yalnızca dokunduğunda açılır.

MCP

Kurulumu ajanına yaptır

dev_inboxes_listdev_inbox_createdev_inbox_configuredev_inbox_membersdev_inbox_messagesdev_inbox_test

“Biri uygulamamı kurduğunda telefonuma bildirim gönder” de, AI kodlama ajanın AgentsRoom MCP araçlarıyla gelen kutusunu oluşturabilir, şablonu yapılandırabilir ve çağrıyı koduna ekleyebilir. CLI'ı ne olursa olsun her ajan bu araçlara sahiptir: Claude Code, Codex, Antigravity ve diğerleri.

Ajan bir ayarı değiştirmeden veya bir gelen kutusunu paylaşmadan önce sorar ve gönderim anahtarını asla depona commit etmez.

AgentsRoom MCP'yi keşfet

Aylık push kotası

Takvim ayı başına, tüm gelen kutuların genelinde sayılır. E-postanın kendi ayrı kotası vardır.

Misafir

10

aylık

Ücretsiz

100

aylık

Plus

200

aylık

Pro

Sınırsız

Team koltukları Pro'yu içerir. Mesajlar 90 gün saklanır ve bir mesajı silmek, harcanan bildirimi geri vermez.

Hizmetlerin HTTP isteği yerine e-posta mı gönderiyor? Onlara özel bir adres ver.

Geliştirici e-posta gelen kutusu

Betiğinin değil, bir AI ajanının turunu bitirdiğini mi öğrenmek istiyorsun? Bu, ayrı ve yerleşik bir bildirimdir.

Ajan bildirimleri

Push bildirim API'si: sorular

Bize başka bir şey sor
cURL ile telefonuma nasıl push bildirimi gönderirim?
AgentsRoom'da bir Anlık bildirimler gelen kutusu oluştur, Bağlantı ve ayarlar bölümünden uç noktasını ve yalnızca gönderim anahtarını kopyala ve en azından bir başlık içeren JSON gövdesiyle bir POST isteği çalıştır. Bildirimi almak için AgentsRoom mobil uygulamasına aynı hesapla giriş yap ve bildirimlere izin ver.
Bilgisayarımın açık kalması gerekiyor mu?
Hayır. Uç nokta, gelen kutusu ve teslimat AgentsRoom sunucularında çalışır. Dizüstü bilgisayarın kapalı olabilir: bildirim yine telefonuna ulaşır ve mesaj gelen kutusunda bekler.
Hem iPhone'da hem Android'de çalışıyor mu?
Evet. Bildirimler, iOS ve Android'deki AgentsRoom mobil uygulamasında hesabına giriş yapılmış her cihaza gider. Birine dokunmak, mesajı doğru gelen kutusunda açar.
Bir bildirim neler içerebilir?
En fazla 160 karakterlik bir başlık, en fazla 16.000 karakterlik bir metin, isteğe bağlı herkese açık bir HTTPS görseli, isteğe bağlı bir HTTPS bağlantısı ve ses: cihazın varsayılan sesi ya da sessiz. Özel ses dosyaları desteklenmez.
Betiğim yeniden denediğinde mükerrer bildirimleri nasıl önlerim?
Dağıtım numarası gibi olaya özgü bir değerle Idempotency-Key başlığı gönder. Aynı anahtarla yapılan yeniden deneme, ikinci bir bildirim göndermeden ve kotandan tekrar düşmeden ilk mesajı döndürür.
Gönderim anahtarım sızarsa ne olur?
Anahtar yalnızca mesaj gönderebilir, asla okuyamaz. Gelen kutusu ayarlarından yeniden oluştur, eski anahtar bir sonraki istekten itibaren reddedilsin ya da yenisini oluşturana kadar yeni mesajları durdurmak için iptal et.
Kaç bildirim gönderebilirim?
Takvim ayı başına ve tüm gelen kutuların genelinde: misafir olarak 10, ücretsiz hesapla 100, Plus ile 200 ve Pro ile sınırsız. Team koltukları Pro'yu içerir. E-postanın kendi kotası vardır.
Ekip arkadaşlarım aynı uyarıları alabilir mi?
Evet, Team ya da Pro grubunda. Sahip, gelen kutusunu okuyabilecek ve bildirimlerini alabilecek ekip arkadaşlarını seçer. Gönderim anahtarını asla görmezler ve ayarları değiştiremezler.

İlgili özellikler

Betiklerin omzuna dokunsun

AgentsRoom'u indir, bir Anlık bildirimler gelen kutusu oluştur ve ilk bildirimini iki dakikada gönder.

AgentsRoom'u İndirÜcretsiz

Yardımcı uygulama: hareket halindeyken ajanlarını izle

Claude, Codex, Antigravity CLI veya başka bir AI sağlayıcı kullan.

Hataları ve istekleri doğrudan genel backloguna gönder.