API di notifiche push

Notifiche push da cURL.
Lo script finisce, il telefono vibra.

Invia una notifica push al tuo iPhone o Android con una sola chiamata cURL. Incollala alla fine di un deploy, di un backup, di un job di CI o di un lungo addestramento, e l'avviso ti raggiunge ovunque tu sia.

Nessuna app da pubblicare, nessun progetto Firebase, nessun certificato APNs. Crea una casella in AgentsRoom, copia il suo endpoint e la sua chiave di solo invio, e ogni notifica resta anche in una cronologia ricercabile sul desktop e sul telefono.

deploy.sh

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

{"title":"Rilascio completato"}

202 Accepted

Il tuo telefonoora

Rilascio completato

api v2.4 è online in produzione

Una richiesta HTTPS da qualsiasi script, una notifica sul telefono, una copia conservata nella casella.

La maggior parte dei lavori lunghi finisce in silenzio. Il deploy è terminato venti minuti fa, il backup notturno è fallito alle 3 di notte, la migrazione ti sta ancora aspettando, e lo scopri solo quando vai a controllare. Una notifica push è il modo più economico per smettere di controllare, ma configurarla di solito richiede un'app mobile, un progetto Firebase e certificati da rinnovare.

AgentsRoom è già sul tuo telefono. L'API Push lo trasforma nel ricevitore: ogni casella ha il proprio endpoint HTTPS e una chiave di solo invio, e qualsiasi cosa sappia eseguire cURL ora può raggiungere la tua schermata di blocco. Uno script di shell, uno step di GitHub Actions, un job cron, un evento server nella tua app.

Ogni avviso viene anche salvato sul server, in una casella in cui puoi cercare dal desktop o dal telefono. Il computer può restare chiuso: endpoint, casella e consegna girano sui server di AgentsRoom.

Tutto ciò che serve a una notifica, niente da ospitare

Un body JSON, un header per la chiave e qualche garanzia che conta quando uno script gira senza supervisione.

Titolo, testo, link e immagine

Invia un titolo fino a 160 caratteri, un testo fino a 16.000, un link da aprire e un'immagine HTTPS pubblica. Il telefono mostra una breve anteprima, la casella conserva il testo completo.

Con suono o silenziosa

Ogni casella ha un suono predefinito e ogni richiesta può cambiarlo: il suono del dispositivo per un backup fallito, silenzio per un report di routine.

Nessun duplicato quando uno script riprova

Aggiungi un header Idempotency-Key e una richiesta ripetuta restituisce lo stesso messaggio invece di far vibrare il telefono due volte. Non viene conteggiata di nuovo nella tua quota.

Chiavi di solo invio revocabili

La chiave nel tuo script può solo inviare. Non può leggere la casella né modificarne le impostazioni. Rigenerala se trapela, o revocala per bloccare subito i nuovi messaggi.

Funziona a computer spento

Endpoint e casella girano sul server. Accedi all'app mobile di AgentsRoom con lo stesso account, consenti le notifiche e chiudi il portatile.

Privata, o condivisa di proposito

Una casella appartiene al tuo account o a un progetto. In un Team o in un gruppo Pro, scegli i colleghi che ricevono anche loro i suoi avvisi. Non vedono mai la chiave.

L'intera integrazione è una sola richiesta

Copiala dalle impostazioni della casella, con il tuo vero endpoint e la tua chiave già compilati.

Un avviso di deploy da uno script di shellPOST /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"}'

Una risposta 202 significa che il messaggio è salvato nella tua casella. La consegna al telefono dipende poi dal sistema operativo, dalle tue impostazioni di notifica e dal servizio push. Su Windows, il pulsante di copia ti fornisce una versione PowerShell che chiama curl.exe.

Da zero alla prima notifica

Tre passaggi, circa due minuti, nessun account su un altro servizio.

01

Apri Push e crea una casella

In un progetto, clicca su Push nel dock del progetto, oppure aprilo dalle impostazioni delle notifiche. Scegli il tuo account o il progetto corrente e parti da un modello come Nuova installazione o Rilascio completato.

02

Copia il comando cURL

Connessione e impostazioni mostra l'endpoint, la chiave di solo invio e una richiesta pronta da eseguire. Modifica titolo e testo, poi salva l'integrazione così lo stesso modello ti segue su ogni computer.

03

Eseguilo dal tuo script

Incolla il comando alla fine dello script di deploy, del job di CI o del task cron. Alla prossima esecuzione parte la notifica, e il messaggio compare nella scheda Push su desktop e mobile.

Cosa collegano per primo gli sviluppatori

Tutto ciò che finisce mentre non stai guardando è un buon candidato.

Deploy completato o fallito

Aggiungi una riga alla fine dello script di deploy o del job di CI, con un link alla release o ai log dell'errore.

Un nuovo utente o una nuova installazione

Chiama l'endpoint dal tuo backend quando qualcuno si registra, installa la tua app o passa a un piano superiore, e festeggia dal telefono.

Backup e job cron

Usa il suono del dispositivo quando un backup notturno fallisce e resta in silenzio quando va a buon fine. La cronologia mostra quali notti sono andate storte.

Build, importazioni e addestramenti lunghi

Smetti di controllare un terminale ogni dieci minuti. Il job ti avvisa quando ha finito, anche se ti sei allontanato dalla scrivania.

Fatta per vivere dentro i tuoi script

La chiave viaggia in un header Authorization, mai nell'URL, quindi non finisce nei log dei proxy. È lunga 192 bit, viene salvata come hash per la ricerca e mostrata solo al proprietario della casella.

Una chiave trapelata si disattiva con un clic: rigenerala e la vecchia viene rifiutata dalla richiesta successiva, oppure revocala perché la casella non accetti più nulla. I messaggi già ricevuti restano leggibili.

Considera ciò che arriva come contenuto non attendibile. Le immagini vengono caricate dal loro host pubblico quando apri un messaggio, e i link si aprono solo quando li tocchi.

MCP

Chiedi al tuo agente di configurarla

dev_inboxes_listdev_inbox_createdev_inbox_configuredev_inbox_membersdev_inbox_messagesdev_inbox_test

Di' «avvisami sul telefono quando qualcuno installa la mia app» e il tuo agente di coding AI può creare la casella, configurare il modello e aggiungere la chiamata al tuo codice con gli strumenti MCP di AgentsRoom. Ogni agente li riceve, qualunque sia la sua CLI: Claude Code, Codex, Antigravity e gli altri.

L'agente chiede prima di modificare un'impostazione o condividere una casella, e non fa mai commit di una chiave di invio nel tuo repository.

Scopri AgentsRoom MCP

Quota mensile di push

Conteggiata per mese solare, su tutte le tue caselle. L'email ha una quota propria e separata.

Ospite

10

al mese

Gratis

100

al mese

Plus

200

al mese

Pro

Illimitate

I posti Team includono Pro. I messaggi sono conservati per 90 giorni, ed eliminarne uno non restituisce la sua notifica.

I tuoi servizi inviano email invece di richieste HTTP? Dagli piuttosto un indirizzo dedicato.

Casella email per sviluppatori

Vuoi sapere quando un agente AI finisce il suo turno, e non quando finisce il tuo script? È una notifica separata, già integrata.

Notifiche degli agenti

API di notifiche push: domande

Come invio una notifica push al mio telefono da cURL?

Crea una casella Push in AgentsRoom, copia il suo endpoint e la chiave di solo invio da Connessione e impostazioni, ed esegui una richiesta POST con un body JSON che contenga almeno un titolo. Accedi all'app mobile di AgentsRoom con lo stesso account e consenti le notifiche per riceverla.

Il mio computer deve restare acceso?

No. Endpoint, casella e consegna girano sui server di AgentsRoom. Il portatile può restare chiuso: la notifica arriva comunque al telefono e il messaggio ti aspetta nella casella.

Funziona sia su iPhone sia su Android?

Sì. Le notifiche arrivano su ogni dispositivo connesso al tuo account nell'app mobile di AgentsRoom su iOS e Android. Toccandone una si apre il messaggio nella casella giusta.

Cosa può contenere una notifica?

Un titolo fino a 160 caratteri, un testo fino a 16.000, un'immagine HTTPS pubblica facoltativa, un link HTTPS facoltativo e il suono: quello predefinito del dispositivo o silenzioso. I file audio personalizzati non sono supportati.

Come evito notifiche duplicate quando il mio script riprova?

Invia un header Idempotency-Key con un valore univoco per l'evento, come il numero del deploy. Un nuovo tentativo con la stessa chiave restituisce il messaggio originale senza una seconda notifica e senza consumare di nuovo la tua quota.

Cosa succede se la mia chiave di invio trapela?

La chiave può solo inviare messaggi, mai leggerli. Rigenerala nelle impostazioni della casella e la vecchia viene rifiutata dalla richiesta successiva, oppure revocala per bloccare i nuovi messaggi finché non ne crei una nuova.

Quante notifiche posso inviare?

Per mese solare e su tutte le tue caselle: 10 come ospite, 100 con un account gratuito, 200 con Plus e illimitate con Pro. I posti Team includono Pro. L'email ha una quota propria.

I miei colleghi possono ricevere gli stessi avvisi?

Sì, in un Team o in un gruppo Pro. Il proprietario sceglie i colleghi che possono leggere la casella e riceverne le notifiche. Non vedono mai la chiave di invio e non possono modificare le impostazioni.

Funzionalità correlate

Lascia che i tuoi script ti battano sulla spalla

Scarica AgentsRoom, crea una casella Push e invia la tua prima notifica in due minuti.

GratisScarica AgentsRoom

App companion: monitora i tuoi agenti in movimento

Usa Claude, Codex, Antigravity CLI o un altro provider IA.

Installa l'estensione
Chrome Web Store

Invia bug e richieste direttamente nel tuo backlog pubblico.

Multi-progetto
Multi-provider
Multi-agente
Stato in tempo reale
Diff e commit
App mobile
Anteprima live
Team di agenti
Test browser
Dev guidata da backlog
Libreria di prompt
Libreria di skill
Vedi tutte le funzionalità