API de notificações push

Notificações push via cURL.
Seu script termina, seu celular vibra.

Envie uma notificação push para seu iPhone ou Android com uma única chamada cURL. Cole-a no fim de uma implantação, de um backup, de um job de CI ou de um longo treinamento de modelo, e o alerta chega até você onde você estiver.

Nenhum app para publicar, nenhum projeto Firebase, nenhum certificado APNs. Crie uma caixa de entrada no AgentsRoom, copie o endpoint e a chave só de envio, e cada notificação também fica em um histórico pesquisável no seu computador e no seu celular.

deploy.sh

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

{"title":"Implantação concluída"}

202 Accepted

Seu celularagora

Implantação concluída

api v2.4 está no ar em produção

Uma requisição HTTPS de qualquer script, uma notificação no seu celular, uma cópia guardada na caixa de entrada.

A maioria das tarefas longas termina em silêncio. A implantação terminou há vinte minutos, o backup noturno falhou às 3 da manhã, a migração ainda espera por você, e você só descobre quando vai conferir. Uma notificação push é o jeito mais barato de parar de conferir, mas configurar uma costuma exigir um app mobile, um projeto Firebase e certificados para renovar.

O AgentsRoom já está no seu celular. A API Push o transforma no receptor: cada caixa de entrada ganha seu próprio endpoint HTTPS e uma chave só de envio, e qualquer coisa que rode cURL agora chega à sua tela de bloqueio. Um script shell, uma etapa do GitHub Actions, um job cron, um evento de servidor no seu próprio app.

Cada alerta também é armazenado no servidor, em uma caixa de entrada que você pode pesquisar pelo computador ou pelo celular. Seu computador pode estar fechado: o endpoint, a caixa de entrada e a entrega rodam nos servidores do AgentsRoom.

Tudo o que uma notificação precisa, nada para hospedar

Um corpo JSON, um cabeçalho para a chave e algumas garantias que fazem diferença quando um script roda sem supervisão.

Título, corpo, link e imagem

Envie um título de até 160 caracteres, um corpo de até 16.000, um link para abrir e uma imagem HTTPS pública. O celular mostra uma prévia curta, a caixa de entrada guarda o texto completo.

Com som ou silenciosa

Cada caixa de entrada tem um som padrão, e cada requisição pode substituí-lo: o som do dispositivo para um backup que falhou, silencioso para um relatório de rotina.

Sem duplicatas quando um script tenta de novo

Adicione um cabeçalho Idempotency-Key e uma requisição repetida devolve a mesma mensagem em vez de fazer seu celular vibrar duas vezes. Ela não é descontada da sua cota de novo.

Chaves só de envio que você pode revogar

A chave no seu script só pode enviar. Ela não lê a caixa de entrada nem altera as configurações. Gere outra se ela vazar, ou revogue-a para bloquear novas mensagens na hora.

Funciona com o computador desligado

O endpoint e a caixa de entrada rodam no servidor. Entre no app mobile do AgentsRoom com a mesma conta, permita as notificações e feche o notebook.

Privada, ou compartilhada de propósito

Uma caixa de entrada pertence à sua conta ou a um projeto. Em um Team ou em um grupo Pro, escolha os colegas que também recebem os alertas. Eles nunca veem a chave.

A integração inteira é uma requisição

Copie-a das configurações da caixa de entrada, com seu endpoint e sua chave reais já preenchidos.

Um alerta de implantação a partir de um script 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"}'

Uma resposta 202 significa que a mensagem foi armazenada na sua caixa de entrada. A entrega no celular depende então do sistema operacional, das suas configurações de notificação e do serviço de push. No Windows, o botão de copiar fornece uma versão PowerShell que chama curl.exe.

Do zero à primeira notificação

Três etapas, cerca de dois minutos, nenhuma conta em outro serviço.

01

Abra o Push e crie uma caixa de entrada

Em um projeto, clique em Push na barra do projeto, ou abra pelas configurações de notificação. Escolha sua conta ou o projeto atual e comece por um modelo como Nova instalação ou Implantação concluída.

02

Copie o comando cURL

Conexão e configurações mostra o endpoint, a chave só de envio e uma requisição pronta para rodar. Edite o título e o corpo, depois salve a integração para que o mesmo modelo acompanhe você em todas as máquinas.

03

Rode no seu script

Cole o comando no fim do seu script de implantação, do seu job de CI ou da sua tarefa cron. A próxima execução envia a notificação, e a mensagem aparece na aba Push no computador e no celular.

O que os desenvolvedores conectam primeiro

Tudo o que termina enquanto você não está olhando é um bom candidato.

Implantação concluída ou com falha

Adicione uma linha no fim do script de implantação ou do job de CI, com um link para a release ou para os logs da falha.

Um novo usuário ou uma nova instalação

Chame o endpoint do seu backend quando alguém se cadastra, instala seu app ou faz upgrade, e comemore pelo celular.

Backups e jobs cron

Use o som do dispositivo quando um backup noturno falha e fique em silêncio quando dá certo. O histórico mostra quais noites deram errado.

Builds, importações e treinamentos longos

Pare de olhar um terminal a cada dez minutos. O job avisa quando termina, mesmo que você tenha saído da mesa.

Feito para viver dentro dos seus scripts

A chave viaja em um cabeçalho Authorization, nunca na URL, então não acaba em logs de proxy. Ela tem 192 bits, é armazenada como hash para consulta e só é mostrada ao dono da caixa de entrada.

Uma chave que vazou é cortada com um clique: gere outra e a antiga é recusada a partir da próxima requisição, ou revogue-a para que a caixa de entrada não aceite mais nada. As mensagens já recebidas continuam legíveis.

Trate o que chega como conteúdo não confiável. As imagens são carregadas do host público quando você abre uma mensagem, e os links só abrem quando você toca neles.

MCP

Peça ao seu agente para configurar

dev_inboxes_listdev_inbox_createdev_inbox_configuredev_inbox_membersdev_inbox_messagesdev_inbox_test

Diga “me avise no celular quando alguém instalar meu app” e seu agente de programação com IA pode criar a caixa de entrada, configurar o modelo e adicionar a chamada ao seu código com as ferramentas MCP do AgentsRoom. Todo agente as recebe, qualquer que seja a CLI: Claude Code, Codex, Antigravity e os outros.

O agente pergunta antes de alterar uma configuração ou compartilhar uma caixa de entrada, e nunca faz commit de uma chave de envio no seu repositório.

Conhecer o AgentsRoom MCP

Cota mensal de push

Contada por mês civil, somando todas as suas caixas de entrada. O e-mail tem sua própria cota separada.

Convidado

10

por mês

Gratuito

100

por mês

Plus

200

por mês

Pro

Ilimitado

Os assentos Team incluem o Pro. As mensagens ficam guardadas por 90 dias, e excluir uma não devolve a notificação à cota.

Seus serviços enviam e-mails em vez de requisições HTTP? Dê a eles um endereço dedicado.

Caixa de e-mail para desenvolvedores

Quer saber quando um agente de IA termina o turno, e não quando seu script termina? Isso é outra notificação, já integrada.

Notificações de agentes

API de notificações push: perguntas

Como envio uma notificação push para o meu celular via cURL?

Crie uma caixa de entrada Push no AgentsRoom, copie o endpoint e a chave só de envio em Conexão e configurações, e rode uma requisição POST com um corpo JSON contendo pelo menos um título. Entre no app mobile do AgentsRoom com a mesma conta e permita as notificações para recebê-la.

Meu computador precisa ficar ligado?

Não. O endpoint, a caixa de entrada e a entrega rodam nos servidores do AgentsRoom. Seu notebook pode estar fechado: a notificação chega ao celular mesmo assim e a mensagem espera na caixa de entrada.

Funciona no iPhone e no Android?

Sim. As notificações vão para todos os dispositivos conectados à sua conta no app mobile do AgentsRoom, no iOS e no Android. Tocar em uma abre a mensagem na caixa de entrada certa.

O que uma notificação pode conter?

Um título de até 160 caracteres, um corpo de até 16.000, uma imagem HTTPS pública opcional, um link HTTPS opcional e o som: o padrão do dispositivo ou silencioso. Arquivos de som personalizados não são suportados.

Como evito notificações duplicadas quando meu script tenta de novo?

Envie um cabeçalho Idempotency-Key com um valor único para o evento, como o número da implantação. Uma nova tentativa com a mesma chave devolve a mensagem original sem segunda notificação e sem consumir sua cota de novo.

O que acontece se minha chave de envio vazar?

A chave só pode enviar mensagens, nunca lê-las. Gere outra nas configurações da caixa de entrada e a antiga é recusada a partir da próxima requisição, ou revogue-a para bloquear novas mensagens até você criar uma nova.

Quantas notificações posso enviar?

Por mês civil e somando todas as suas caixas de entrada: 10 como convidado, 100 com uma conta gratuita, 200 com o Plus e ilimitadas com o Pro. Os assentos Team incluem o Pro. O e-mail tem sua própria cota.

Meus colegas podem receber os mesmos alertas?

Sim, em um Team ou em um grupo Pro. O dono escolhe os colegas que podem ler a caixa de entrada e receber as notificações. Eles nunca veem a chave de envio e não podem alterar as configurações.

Recursos relacionados

Deixe seus scripts darem um toque no seu ombro

Baixe o AgentsRoom, crie uma caixa de entrada Push e envie sua primeira notificação em dois minutos.

GrátisBaixar AgentsRoom

App complementar: acompanhe seus agentes em qualquer lugar

Use Claude, Codex, Antigravity CLI ou outro provedor de IA.

Instalar a extensão
Chrome Web Store

Envie bugs e pedidos direto para o seu backlog público.

Multi-projetos
Multi-provedor
Multi-agentes
Status ao vivo
Diff e commit
App mobile
Preview ao vivo
Equipes de agentes
Testes no navegador
Dev guiada por backlog
Biblioteca de prompts
Biblioteca de skills
Ver todas as funcionalidades