# Como funcionam as notificações push: APNs e FCM explicados

> Toda notificação push para iPhone passa pelo APNs da Apple, e quase toda notificação push para Android passa pelo FCM do Google. Tokens de dispositivo, autenticação do provedor, a requisição em si, o que acontece quando o celular está offline e como a prioridade funciona de verdade em cada plataforma.

*05.10.2026*

<!-- source: https://pocketalert.app/pt/blog/how-push-notifications-work-apns-fcm -->

Uma notificação push parece simples de fora: algo acontece em um servidor e, um segundo depois, um celular acende. No meio do caminho existem duas redes de entrega, operadas pela Apple e pelo Google, e nenhuma notificação chega a um celular sem passar por uma delas.

- **APNs**, o Apple Push Notification service, entrega toda notificação push para iPhone, iPad, Mac e Apple Watch.
- **FCM**, Firebase Cloud Messaging, entrega para dispositivos Android com os serviços do Google Play, e também pode enviar para iOS repassando as mensagens ao APNs.

Este guia acompanha uma notificação desde o seu servidor até a tela de bloqueio nas duas plataformas, com os detalhes que só aparecem quando você roda isso em produção. Nós operamos os dois pipelines por trás do [Pocket Alert](/), então os exemplos vêm do que realmente colocamos no ar.

## As quatro partes

1. **Seu servidor**, que a Apple chama de provedor. Ele decide que algo deve ser enviado.
2. **O serviço de push**, APNs ou FCM. Ele aceita a requisição e a encaminha.
3. **O dispositivo.** O sistema operacional mantém uma conexão criptografada e de longa duração com a Apple ou o Google, e recebe as notificações de todos os apps por ela.
4. **O app.** Ele se registrou para notificações e é dono do token para o qual o push é endereçado.

O terceiro ponto explica por que o push gasta pouca bateria. O celular nunca consulta o seu servidor. Uma única conexão, compartilhada por todos os apps, fica aberta, e o serviço de push envia por ela quando há algo para entregar.

## Passo 1: o dispositivo recebe um token

Quando um app se registra para notificações remotas, o sistema operacional lhe entrega um token: um endereço opaco para "este app neste dispositivo". O app envia o token para o seu servidor, e o seu servidor o armazena.

- Um **token de dispositivo do APNs** é único para o app e o dispositivo. A Apple recomenda não guardá-lo em cache no app: ele muda quando o usuário restaura um backup, troca de dispositivo ou reinstala o sistema.
- Um **token de registro do FCM** cumpre o mesmo papel no Android, e o FCM o renova por conta própria.

Tokens ficam desatualizados o tempo todo. Manter os tokens armazenados atualizados é uma parte grande de operar push.

## Passo 2: seu servidor comprova quem é

### APNs

O APNs usa HTTP/2 sobre TLS 1.2 ou superior, em `api.push.apple.com` para produção e `api.sandbox.push.apple.com` para builds de desenvolvimento, nas portas 443 ou 2197. Há duas formas de autenticação:

- **Baseada em token.** Você cria uma chave de assinatura `.p8` na sua conta de desenvolvedor Apple e assina um JWT curto com ES256, contendo o seu Team ID e o ID da chave. A Apple quer que esse JWT seja renovado no máximo a cada 20 minutos e no mínimo a cada 60. Se você enviar um antigo, recebe `403 ExpiredProviderToken`; se renovar com frequência demais, recebe `429 TooManyProviderTokenUpdates`.
- **Baseada em certificado.** Um certificado de cliente TLS por app, válido por um ano, que depois precisa ser renovado.

Use a autenticação por token. Uma única chave cobre todos os seus apps e não expira todo ano.

### FCM

A API HTTP v1 do FCM recebe um token de acesso OAuth 2.0 de curta duração, obtido com uma conta de serviço do Google e o escopo `firebase.messaging`. A API "legacy" mais antiga, com uma chave de servidor estática, foi descontinuada em 2023 e desligada a partir de julho de 2024, então código que ainda envia `Authorization: key=...` não funciona mais.

## Passo 3: a requisição

### Enviando para o APNs

Cada push é um POST HTTP/2 para `/3/device/<device token>`, com alguns cabeçalhos que mudam a forma como ele é tratado:

```bash
curl --http2 \
  -H "authorization: bearer $APNS_JWT" \
  -H "apns-topic: com.example.alerts" \
  -H "apns-push-type: alert" \
  -H "apns-priority: 10" \
  -d '{"aps": {"alert": {"title": "Backup failed", "body": "db-01: pg_dump exited with code 1"}, "sound": "default", "interruption-level": "time-sensitive"}}' \
  "https://api.push.apple.com/3/device/$DEVICE_TOKEN"
```

- `apns-topic` é o bundle ID do seu app.
- `apns-push-type` indica que tipo de push é este: `alert` para uma notificação visível, `background` para um push de dados silencioso, e alguns outros.
- `apns-priority` é `10` para entregar agora, `5` para deixar que o estado de energia do dispositivo decida, ou `1` para priorizar a economia de energia e não acordar o dispositivo.
- `apns-expiration` define por quanto tempo o APNs deve continuar tentando. `0` significa uma única tentativa e nenhum armazenamento.
- `apns-collapse-id` permite que uma notificação mais nova substitua uma mais antiga com o mesmo id.

O payload é JSON com um dicionário `aps`, e tem limite de **4 KB** (5 KB para VoIP).

### Enviando para o FCM

O FCM aceita uma mensagem JSON por requisição:

```bash
curl -X POST "https://fcm.googleapis.com/v1/projects/$PROJECT_ID/messages:send" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "message": {
      "token": "DEVICE_REGISTRATION_TOKEN",
      "notification": { "title": "Backup failed", "body": "db-01: pg_dump exited with code 1" },
      "android": { "priority": "high", "notification": { "channel_id": "alerts_high" } }
    }
  }'
```

Uma mensagem `notification` é exibida pelo sistema quando o app está em segundo plano. Uma mensagem `data` é entregue ao app para que ele a trate. Em ambos os casos, o limite do payload é de **4.096 bytes**.

## Passo 4: a entrega, ou a espera por ela

Se o celular estiver online, o push segue pela conexão aberta e aparece em instantes. Se não estiver:

- O **APNs** armazena a notificação por até 30 dias, dependendo de `apns-expiration`, mas guarda **apenas uma notificação por app e por dispositivo**. Envie cinco enquanto o celular está no modo avião e, normalmente, ele receberá só a última. A Apple nem garante que seja a mais recente.
- O **FCM** mantém as mensagens pelo tempo de vida delas (time to live), quatro semanas por padrão e no máximo 28 dias. Mensagens recolhíveis substituem umas às outras, com até quatro chaves de colapso por dispositivo.

A prioridade também afeta o tempo de entrega. No iOS, pushes com prioridade `5` e `1` podem ser agrupados, limitados ou descartados. No Android, mensagens com prioridade `normal` podem esperar até o dispositivo sair do Doze, enquanto as de prioridade `high` são entregues imediatamente. O FCM também fiscaliza o uso desse privilégio: mensagens de alta prioridade que não resultam em uma notificação visível podem ser rebaixadas silenciosamente para normal com o tempo.

## Quão alto ela toca: níveis de interrupção e canais

Entregar é uma coisa. Saber se o celular emite som é outra, e as duas plataformas tratam isso de formas diferentes.

**iOS** (15 ou superior) atribui a cada notificação um nível de interrupção:

- `passive` a adiciona à lista sem acender a tela nem tocar som.
- `active` é o padrão.
- `time-sensitive` pode furar o Foco e o resumo de notificações. O usuário pode desativar isso por app.
- `critical` sempre toca, mesmo em Não perturbe e com a chave de silencioso ativada. Exige uma permissão (entitlement) que a Apple concede sob solicitação, após análise.

**Android** (8 ou superior) coloca cada notificação em um **canal**, e é o canal que define a importância: som, vibração, exibição flutuante, comportamento em Não perturbe. O app cria os canais, mas, depois que um canal existe, o comportamento dele passa a pertencer ao usuário. O app não consegue alterá-lo depois.

Essa última regra tem consequências reais. Quando fizemos os alertas críticos do Pocket Alert tocarem mesmo no modo silencioso, o canal crítico existente não podia ser trocado para áudio de alarme depois do fato. A solução foi um segundo canal com um novo id, e o servidor só o escolhe para as versões do app que o criam, porque enviar para um canal que o app nunca criou faz com que a notificação simplesmente não seja exibida.

No Android 13 ou superior há mais uma barreira: o app precisa da permissão em tempo de execução `POST_NOTIFICATIONS`, e em uma instalação nova as notificações ficam desligadas até o usuário concedê-la.

## O que quebra em produção

- **Tokens desatualizados.** O APNs responde `410 Unregistered` para um token que não é mais válido. Pare de enviar para ele e remova-o.
- **Ambiente errado.** O token de uma build de desenvolvimento enviado ao host de produção falha com `400 BadDeviceToken`.
- **Payloads grandes demais.** `413 PayloadTooLarge` quando você ultrapassa 4 KB. Linhas longas de log no corpo de um alerta são a causa mais comum.
- **Prioridade rebaixada.** Mensagens Android de alta prioridade que nunca exibem nada perdem a prioridade.
- **Notificações desativadas.** O push é entregue e o usuário nunca o vê, porque a permissão foi negada ou o canal foi silenciado.

## O atalho

Vale construir tudo isso quando o app é o seu produto e você envia para os usuários dele. Para alertas para você mesmo ou para a sua equipe, é muita infraestrutura: uma conta de desenvolvedor em cada plataforma, chaves de assinatura, armazenamento de tokens, dois formatos de requisição e dois modelos de prioridade.

Um serviço de notificações push executa os dois pipelines por você. Com o Pocket Alert, você envia uma requisição, sem tokens ou certificados próprios:

```bash
curl -X POST https://api.pocketalert.app/v1/messages \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"title": "Backup failed", "message": "db-01: pg_dump exited with code 1", "level": "high"}'
```

O campo `level` é traduzido para cada plataforma:

- `silent` é uma notificação passiva sem som no iPhone, e vai para um canal silencioso no Android.
- `low` é passiva no iPhone e de importância baixa no Android.
- `default` é uma notificação normal nas duas plataformas.
- `high` é time-sensitive no iPhone e de alta prioridade no Android.
- `critical` ignora o Não perturbe no Android. No iPhone chega como time-sensitive, e o som completo de alerta crítico está sendo liberado conforme a Apple concede a permissão.

Saiba mais em [alertas críticos](/use-cases/critical-alerts), e sobre a própria API em [o que é uma API de notificações push](/blog/what-is-a-push-notification-api).

## FAQ

### O APNs garante a entrega?

Não. APNs e FCM são ambos de melhor esforço. O APNs guarda apenas a notificação mais recente para um dispositivo offline, e nenhum dos dois serviços garante quando a mensagem chega. A documentação do Google vai além e diz que o FCM não deve ser usado para alertas de emergência com risco de vida. Para acionamento de plantão, trate o push como o canal mais rápido, não como o único.

### Por que preciso de APNs e FCM?

iPhones aceitam pushes apenas pelo APNs. Dispositivos Android com os serviços do Google Play os recebem pelo FCM. Se seus usuários estiverem nas duas plataformas, seu servidor conversa com ambos, diretamente ou pelo FCM, que pode encaminhar para o APNs por você.

### O FCM consegue enviar notificações para um iPhone?

Sim. Você envia a sua chave de autenticação do APNs para o Firebase, e o FCM entrega para iOS repassando a mensagem ao APNs. Mensagens de dados para dispositivos Apple precisam ser enviadas com prioridade normal.

### Qual é o tamanho máximo de uma notificação push?

4 KB para um payload do APNs (5 KB para pushes VoIP), e 4.096 bytes para uma mensagem do FCM. Textos longos devem ficar no seu app ou em um link, não no push.

### O que é um token de dispositivo?

Um endereço para um app em um dispositivo, emitido pela Apple ou pelo Google. O seu servidor envia pushes para ele. Ele pode mudar a qualquer momento, então os servidores precisam aceitar tokens atualizados e descartar os que o APNs ou o FCM informarem como inválidos.

[Crie uma conta gratuita no Pocket Alert](/signup) para dispensar chaves e tokens, ou veja como outros serviços se comparam nas [alternativas](/alternatives).
