Pushmelding-API

Pushmeldingen via cURL.
Je script is klaar, je telefoon trilt.

Stuur een pushmelding naar je iPhone of Android-telefoon met één cURL-aanroep. Plak hem aan het eind van een uitrol, een back-up, een CI-job of een lange trainingsrun, en de melding bereikt je waar je ook bent.

Geen app om te publiceren, geen Firebase-project, geen APNs-certificaat. Maak een postvak aan in AgentsRoom, kopieer het endpoint en de verzendsleutel, en elke melding blijft ook bewaard in een doorzoekbare geschiedenis op je computer en je telefoon.

deploy.sh

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

{"title":"Uitrol voltooid"}

202 Accepted

Je telefoonnu

Uitrol voltooid

api v2.4 staat live in productie

Eén HTTPS-verzoek vanuit elk script, één melding op je telefoon, een kopie in het postvak.

De meeste lange taken eindigen in stilte. De uitrol was twintig minuten geleden klaar, de nachtelijke back-up mislukte om 3 uur ’s nachts, de migratie wacht nog op je, en je komt er pas achter als je gaat kijken. Een pushmelding is de goedkoopste manier om niet meer te hoeven kijken, maar er een opzetten betekent meestal een mobiele app, een Firebase-project en certificaten die je moet vernieuwen.

AgentsRoom staat al op je telefoon. De Push-API maakt er de ontvanger van: elk postvak krijgt een eigen HTTPS-endpoint en een verzendsleutel, en alles wat cURL kan uitvoeren, bereikt nu je vergrendelscherm. Een shellscript, een stap in GitHub Actions, een cronjob, een servergebeurtenis in je eigen app.

Elke melding wordt ook op de server opgeslagen, in een postvak dat je vanaf je computer of je telefoon kunt doorzoeken. Je computer mag dicht zijn: het endpoint, het postvak en de bezorging draaien op de servers van AgentsRoom.

Alles wat een melding nodig heeft, niets om te hosten

Eén JSON-body, één header voor de sleutel en een paar garanties die ertoe doen zodra een script zonder toezicht draait.

Titel, tekst, link en afbeelding

Stuur een titel van maximaal 160 tekens, een tekst van maximaal 16.000, een link om te openen en een openbare HTTPS-afbeelding. De telefoon toont een korte preview, het postvak bewaart de volledige tekst.

Met geluid of stil

Elk postvak heeft een standaardgeluid en elk verzoek kan dat overschrijven: het apparaatgeluid voor een mislukte back-up, stil voor een routinerapport.

Geen dubbele meldingen als een script het opnieuw probeert

Voeg een Idempotency-Key-header toe en een herhaald verzoek geeft hetzelfde bericht terug, in plaats van je telefoon twee keer te laten trillen. Het telt niet opnieuw mee voor je tegoed.

Verzendsleutels die je kunt intrekken

De sleutel in je script kan alleen verzenden. Hij kan het postvak niet lezen en de instellingen niet wijzigen. Genereer een nieuwe als hij uitlekt, of trek hem in om nieuwe berichten meteen te stoppen.

Werkt als je computer uit staat

Het endpoint en het postvak draaien op de server. Log in op de mobiele app van AgentsRoom met hetzelfde account, sta meldingen toe en klap je laptop dicht.

Privé, of bewust gedeeld

Een postvak hoort bij je account of bij één project. In een Team of een Pro-groep kies je de teamgenoten die de meldingen ook ontvangen. Zij zien de sleutel nooit.

De hele integratie is één verzoek

Kopieer het uit de instellingen van het postvak, met je echte endpoint en sleutel al ingevuld.

Een uitrolmelding vanuit een shellscriptPOST /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"}'

Een 202-antwoord betekent dat het bericht in je postvak is opgeslagen. De bezorging op de telefoon hangt daarna af van het besturingssysteem, je meldingsinstellingen en de pushdienst. Op Windows geeft de kopieerknop je een PowerShell-versie die curl.exe aanroept.

Van nul naar je eerste melding

Drie stappen, ongeveer twee minuten, geen account bij een andere dienst.

01

Open Push en maak een postvak aan

Klik in een project op Push in het projectdock, of open het via de meldingsinstellingen. Kies je account of het huidige project en begin met een sjabloon zoals Nieuwe installatie of Uitrol voltooid.

02

Kopieer het cURL-commando

Verbinding en instellingen toont het endpoint, de verzendsleutel en een verzoek dat klaar is om uit te voeren. Pas de titel en de tekst aan en sla de integratie op, zodat hetzelfde sjabloon je op elke machine volgt.

03

Voer het uit vanuit je script

Plak het commando aan het eind van je uitrolscript, je CI-job of je crontaak. De volgende run verstuurt de melding en het bericht verschijnt in het tabblad Push op desktop en mobiel.

Wat ontwikkelaars als eerste koppelen

Alles wat klaar is terwijl je niet kijkt, is een goede kandidaat.

Uitrol voltooid of mislukt

Voeg één regel toe aan het eind van het uitrolscript of de CI-job, met een link naar de release of naar de logs van de fout.

Een nieuwe gebruiker of een nieuwe installatie

Roep het endpoint aan vanuit je backend als iemand zich aanmeldt, je app installeert of upgradet, en vier het vanaf je telefoon.

Back-ups en cronjobs

Gebruik het apparaatgeluid als een nachtelijke back-up mislukt en blijf stil als hij slaagt. De geschiedenis laat zien welke nachten misgingen.

Lange builds, imports en trainingsruns

Stop met elke tien minuten een terminal checken. De job laat je weten wanneer hij klaar is, ook als je al van je bureau weg bent.

Gemaakt om in je scripts te leven

De sleutel reist mee in een Authorization-header, nooit in de URL, dus hij komt niet in proxylogs terecht. Hij is 192 bits lang, wordt gehasht opgeslagen om op te zoeken en wordt alleen getoond aan de eigenaar van het postvak.

Een uitgelekte sleutel schakel je met één klik uit: genereer een nieuwe en de oude wordt vanaf het volgende verzoek geweigerd, of trek hem in zodat het postvak niets meer accepteert. Berichten die al zijn ontvangen, blijven leesbaar.

Behandel wat binnenkomt als onbetrouwbare inhoud. Afbeeldingen worden van hun openbare host geladen als je een bericht opent, en links openen pas als je erop tikt.

MCP

Laat je agent het koppelen

dev_inboxes_listdev_inbox_createdev_inbox_configuredev_inbox_membersdev_inbox_messagesdev_inbox_test

Zeg “stuur me een melding op mijn telefoon als iemand mijn app installeert” en je AI-codeeragent kan het postvak aanmaken, het sjabloon instellen en de aanroep aan je code toevoegen met de MCP-tools van AgentsRoom. Elke agent krijgt ze, ongeacht de CLI: Claude Code, Codex, Antigravity en de rest.

De agent vraagt het eerst voordat hij een instelling wijzigt of een postvak deelt, en commit nooit een verzendsleutel in je repository.

Ontdek AgentsRoom MCP

Maandelijks pushtegoed

Geteld per kalendermaand, over al je postvakken samen. E-mail heeft een eigen, apart tegoed.

Gast

10

per maand

Gratis

100

per maand

Plus

200

per maand

Pro

Onbeperkt

Team-plaatsen bevatten Pro. Berichten worden 90 dagen bewaard, en een bericht verwijderen geeft die melding niet terug aan je tegoed.

Sturen je diensten e-mails in plaats van HTTP-verzoeken? Geef ze dan een eigen adres.

E-mailpostvak voor ontwikkelaars

Wil je weten wanneer een AI-agent zijn beurt afrondt, in plaats van wanneer je script klaar is? Dat is een aparte, ingebouwde melding.

Agentmeldingen

Pushmelding-API: vragen

Hoe stuur ik met cURL een pushmelding naar mijn telefoon?

Maak een Push-postvak aan in AgentsRoom, kopieer het endpoint en de verzendsleutel via Verbinding en instellingen, en voer een POST-verzoek uit met een JSON-body die minstens een titel bevat. Log in op de mobiele app van AgentsRoom met hetzelfde account en sta meldingen toe om hem te ontvangen.

Moet mijn computer aan blijven?

Nee. Het endpoint, het postvak en de bezorging draaien op de servers van AgentsRoom. Je laptop mag dicht zijn: de melding bereikt je telefoon toch en het bericht wacht in het postvak.

Werkt het op zowel iPhone als Android?

Ja. Meldingen gaan naar elk apparaat dat met je account is ingelogd in de mobiele app van AgentsRoom op iOS en Android. Tik op een melding en het bericht opent in het juiste postvak.

Wat kan een melding bevatten?

Een titel van maximaal 160 tekens, een tekst van maximaal 16.000, een optionele openbare HTTPS-afbeelding, een optionele HTTPS-link en het geluid: het standaardgeluid van het apparaat of stil. Eigen geluidsbestanden worden niet ondersteund.

Hoe voorkom ik dubbele meldingen als mijn script het opnieuw probeert?

Stuur een Idempotency-Key-header mee met een waarde die uniek is voor de gebeurtenis, zoals het uitrolnummer. Een nieuwe poging met dezelfde sleutel geeft het oorspronkelijke bericht terug, zonder tweede melding en zonder je tegoed opnieuw te gebruiken.

Wat gebeurt er als mijn verzendsleutel uitlekt?

De sleutel kan alleen berichten verzenden, nooit lezen. Genereer een nieuwe in de instellingen van het postvak en de oude wordt vanaf het volgende verzoek geweigerd, of trek hem in om nieuwe berichten te stoppen tot je een nieuwe aanmaakt.

Hoeveel meldingen kan ik versturen?

Per kalendermaand en over al je postvakken samen: 10 als gast, 100 met een gratis account, 200 met Plus en onbeperkt met Pro. Team-plaatsen bevatten Pro. E-mail heeft een eigen tegoed.

Kunnen mijn teamgenoten dezelfde meldingen ontvangen?

Ja, in een Team of een Pro-groep. De eigenaar kiest de teamgenoten die het postvak kunnen lezen en de meldingen ontvangen. Zij zien de verzendsleutel nooit en kunnen de instellingen niet wijzigen.

Gerelateerde functies

Laat je scripts je op de schouder tikken

Download AgentsRoom, maak een Push-postvak aan en stuur binnen twee minuten je eerste melding.

GratisDownload AgentsRoom

Companion-app: houd je agents onderweg in de gaten

Breng je eigen: Claude, Codex, Antigravity CLI of andere AI-provider.

Download de extensie
Chrome Web Store

Stuur bugs en verzoeken direct naar je openbare backlog.

Meerdere projecten
Multi-provider
Meerdere agenten
Live status
Bestandsverschil & commit
Mobiele metgezel
Live voorbeeld
Agententeams
Browserautomatisering
Backlog-gedreven ontwikkeling
Promptbibliotheek
Vaardighedenbibliotheek
Bekijk alle functies