O que é uma API de notificações push, e quando você precisa de uma?

Uma API de notificações push é um serviço web que coloca uma mensagem na tela de bloqueio do celular quando o seu código pede. Você envia uma requisição HTTP com um título e um corpo, o serviço entrega isso à Apple ou ao Google, e o celular mostra a mensagem em segundos, esteja ou não algum aplicativo aberto.
Essa é a ideia central. Os detalhes estão em quem recebe a notificação e em quanto da cadeia de entrega você quer controlar.
Dois produtos diferentes compartilham o nome
Pesquise por "API de notificações push" e você vai encontrar dois tipos de produto que quase não se sobrepõem.
Plataformas que enviam para os seus usuários. Firebase Cloud Messaging, Apple Push Notification service, OneSignal e similares. Você cria um aplicativo móvel, publica na App Store e no Google Play, coleta um token de dispositivo de cada instalação e envia notificações de produto ou de marketing para milhares de pessoas. A API é o último passo de um projeto longo.
Serviços que enviam para você. Pocket Alert, Pushover, ntfy e outros. O aplicativo já existe: você instala no seu próprio celular, obtém uma chave de API e envia alertas a partir de scripts, servidores e outros serviços. Não há nada para publicar nem tokens para coletar. Um deploy terminou, um backup falhou, um pagamento entrou.
Este guia trata do segundo tipo. Se você está criando um aplicativo de consumo e precisa alcançar os usuários dele, precisa do primeiro tipo, e a maior parte do que segue não se aplicará.
O que acontece quando você envia uma notificação
Quatro etapas, a maioria invisível:
- Seu código envia uma requisição HTTPS ao serviço com um título, uma mensagem e sua chave de API.
- O serviço verifica a chave, armazena a mensagem e decide para onde ela vai: quais dos seus dispositivos e com qual prioridade.
- Ele entrega a notificação à rede de push da própria plataforma: APNs para iPhone e Firebase Cloud Messaging para Android.
- A Apple ou o Google entregam a notificação pela conexão que todo celular já mantém aberta com eles, e o celular a exibe.
As etapas 3 e 4 são o motivo de o push funcionar com o aplicativo fechado e sem drenar a bateria: o celular nunca consulta ninguém. O caminho completo está em Como funcionam as notificações push: APNs e FCM.
Por que não falar diretamente com a Apple e o Google?
Você pode, se tiver um aplicativo próprio nas duas lojas. Para enviar ao seu próprio celular sem nenhum intermediário, você precisaria de:
- Uma assinatura do Apple Developer Program e um aplicativo iOS com a permissão de push, além de um projeto no Firebase e um aplicativo Android para a outra metade.
- Uma chave de assinatura do APNs e uma conta de serviço do Firebase, além de código que assine as requisições para cada uma.
- Uma forma de coletar os tokens de dispositivo do aplicativo e mantê-los atualizados sempre que mudarem.
- Dois formatos de requisição, dois modelos de prioridade e dois conjuntos de códigos de erro.
É um projeto razoável quando o aplicativo é o seu produto. Mas é muita estrutura para "me avise quando a tarefa cron falhar". Um serviço de notificações push já fez tudo isso uma vez, para todo mundo.
Como é uma requisição
Com o Pocket Alert, enviar uma notificação é um único POST autenticado:
curl -X POST https://api.pocketalert.app/v1/messages \
-H 'Token: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"title": "Deploy finished", "message": "api v2.4.1 is live"}'
A resposta é 201 Created com a mensagem armazenada e a prioridade com que ela foi enviada. A mesma requisição funciona em qualquer linguagem com um cliente HTTP, e Envie notificações push com curl traz mais receitas para o terminal.
Só title e message são obrigatórios. Os campos opcionais que mais importam para alertas:
leveldefine o quão alto a notificação chega:silent,low,default,highoucritical.actionsadiciona até três botões à notificação: abrir uma URL, disparar uma requisição HTTP ou copiar um valor.send_atoudelayentrega a notificação depois, em vez de agora (planos pagos).application_idedevice_idindicam a qual projeto ela pertence e qual celular a recebe.
Três formas de entrada, não só a API
Uma API de notificações push é mais útil quando você não precisa escrever código para cada origem.
- A API HTTP para seus scripts, tarefas e aplicativos.
- URLs de webhook para serviços que já enviam webhooks. GitHub, Stripe, Grafana ou Sentry enviam o próprio JSON para um webhook do Pocket Alert, e placeholders como
%repository.name%extraem campos dele para a notificação, sem código no meio. Crie sua primeira URL de webhook mostra o passo a passo. - A CLI e o servidor MCP para o terminal e para agentes de IA:
pocketalert send "Build done" "All tests passed"a partir de um shell (CLI), ou uma ferramentacreate_messageque o Claude ou o Cursor chama quando uma tarefa longa termina (MCP).
Onde você usaria
A maioria dos alertas se encaixa em alguns grupos:
- Algo quebrou. Um servidor parou de responder, uma tarefa cron terminou com erro, um backup não rodou. Veja alertas de tarefas cron e monitoramento de servidores.
- Algo terminou. Um deploy, um build longo, uma impressão 3D de 12 horas, a tarefa de um agente de IA. Veja alertas de deploy.
- Algo aconteceu que você precisa saber. Um pagamento, um cadastro, o envio de um formulário. Veja alertas de pagamento e alertas de cadastro.
- Algo está prestes a acontecer. Um certificado que expira em 14 dias. Veja alertas de expiração de SSL.
O fio condutor é um evento que alguém deve conhecer agora, e não na próxima vez que abrir um painel ou uma caixa de entrada.
O que verificar antes de escolher
Todo serviço deste segmento envia um push a partir de uma requisição HTTP. As diferenças estão em tudo que cerca isso:
- Plataformas. Alguns são só para iPhone (Bark, The Notification App), e o único aplicativo oficial do Gotify é para Android. Se quem precisa do alerta usa o outro celular, isso já decide.
- Níveis de prioridade. Uma falha de backup pode soar diferente de um novo cadastro? Um alerta crítico consegue passar pelo modo Não perturbe?
- Webhooks de entrada. Um serviço consegue enviar o próprio JSON, ou cada origem precisa de um script para reformatá-lo?
- Histórico e logs. Quando um alerta não chegou, existe um registro da chamada e do que aconteceu com ela?
- Limites e preços. Por dia, por mês ou vitalício, e o que acontece quando você atinge o limite.
- Quem opera. Um serviço hospedado ou um servidor que você mesmo mantém.
Comparamos o Pocket Alert com Pushover, ntfy, Pushbullet, Bark, Gotify e outros exatamente nesses pontos em Alternativas, incluindo os casos em que cada um deles é a melhor escolha.
Perguntas frequentes
Uma API de notificações push é o mesmo que o Firebase Cloud Messaging?
O FCM é uma API de notificações push: a que o Google oferece para aplicativos que você cria e publica. Serviços como o Pocket Alert ficam em cima do FCM e do APNs e cuidam do aplicativo, das chaves e dos tokens de dispositivo, de modo que você só precisa fazer a requisição HTTP.
Preciso criar um aplicativo móvel?
Não, para alertas para você ou para a sua equipe. Você instala um aplicativo existente, como o Pocket Alert para iPhone ou Android, e envia para ele. Só precisa de um aplicativo próprio para enviar notificações aos seus próprios usuários.
É gratuito?
Muitos serviços têm um plano gratuito. O do Pocket Alert permite 50 mensagens por dia sem cartão, o que cobre a maior parte dos alertas pessoais, e os planos pagos começam em US$ 6 por mês para 1.000 por dia. Detalhes na página de preços.
Quão rápida é a entrega?
Normalmente alguns segundos entre a requisição e a tela de bloqueio. A Apple e o Google, porém, não garantem o tempo: um celular sem sinal ou em modo de economia de bateria agressivo recebe a notificação quando se reconecta.
Push, SMS ou e-mail?
Push para coisas que precisam de atenção agora, e-mail para resumos e registros, SMS quando a pessoa não tem nenhum aplicativo no smartphone. As vantagens e desvantagens estão em Notificações push vs SMS e Notificações push vs alertas por e-mail.
Crie uma conta gratuita, copie sua chave de API, e o comando curl acima será seu primeiro push.