Mostre a contagem de não lidos no ícone do seu app
O badge é a menor coisa que você pode dizer ao usuário, e ler não custa nada a ele. Defina, incremente ou zere o badge na mesma campanha e Jornada de tudo o que você já envia.
Mais de 80.000 empresas confiam na Pushwoosh para escalar o engajamento
O recurso, por completo
Um badge é um único número inteiro, e é exatamente aí que está a graça. Ele não ocupa banner nem toca som, não gasta nada da permissão que você suou para conseguir e continua funcionando com o usuário que dispensou seu push três horas atrás. Há três coisas que você pode fazer com esse número pelo editor ou pela API, mais uma ressalva sobre onde ele de fato aparece.
Uma contagem exata
ios_badges: 5 coloca um 5 no ícone, seja qual for o valor anterior. O valor que você envia é o que o usuário vê — ideal quando seu servidor já sabe o total real.
+1 e -1
Mudanças relativas sobem ou descem a contagem sem que você precise acompanhá-la. O SDK devolve o valor do dispositivo pelo endpoint interno /setBadge, então o contador da Pushwoosh fica alinhado com o ícone real.
0 zera o badge
Envie 0 e o badge sai do ícone. Zerar ao abrir o app é a diferença entre uma contagem em que o usuário confia e uma bolinha vermelha que ele aprende a ignorar.
iOS uniforme, Android depende do launcher
No iOS o badge é um valor padrão aps.badge, e todo dispositivo o desenha igual. No Android não existe API nativa de badge, então a exibição depende do launcher — e a Pushwoosh deixa isso claro em vez de prometer uma cobertura que não pode entregar.
O que você controla
| O que você envia | O que acontece com a contagem | Onde fica |
|---|---|---|
Um inteiro, 5 | Define o badge exatamente com esse valor | ios_badges / android_badges, ou o campo Badges |
+1, +3 | Incrementa a contagem atual | O mesmo campo. Também +n nos presets Android |
-1 | Decrementa a contagem atual | O mesmo campo, para uma leitura ou dispensa registrada no servidor |
0 | Remove o badge do ícone | O mesmo campo, ou o próprio app ao abrir |
| Uma chamada do SDK | Define ou zera o badge a partir de um evento no app | setApplicationIconBadgeNumber no iOS, PushwooshBadge no Android |
| Nada | O SDK aplica o badge que chegou com o push | Sem código no app para o caso básico do iOS |
| Uma extensão | Altera a contagem antes de a notificação ser exibida | PWNotificationExtensionManager com App Groups |
5ios_badges / android_badges, ou o campo Badges+1, +3+n nos presets Android-10setApplicationIconBadgeNumber no iOS, PushwooshBadge no AndroidPWNotificationExtensionManager com App GroupsOnde você configura
Um campo Badges no editor
O formulário Send-Push e os presets de push aceitam um número, +n, -n ou 0. Mudar o que uma campanha faz com a contagem não exige release nem desenvolvedor.
Uma chave na API
ios_badges e android_badges em /createMessage. No iOS o valor vai para o campo aps.badge do payload que a Apple já transporta.
Aplicado e sincronizado pelo SDK
O SDK aplica o valor recebido sem código no app e mantém atualizado o badge registrado no servidor via /setBadge, para que o +1 conte a partir do número certo.
O trabalho que ele faz, dentro de uma jornada
Uma contagem, várias fontes
O badge é um atributo de uma mensagem que você já envia, então não precisa de integração própria. A mesma Jornada do Cliente e o mesmo perfil de cliente que decidem quem recebe o push também decidem qual será a contagem.
A única pergunta em aberto é o que alimenta o número. O total de não lidos de uma Message Inbox pode ser a contagem em si, um push silencioso pode alterá-la sem alerta nenhum, e um push mobile visível pode levá-la junto. Um passo no objetivo da jornada volta tudo para 0.
Três recompensas se acumulam enquanto o jogador está fora
Cada recompensa concedida dispara um evento, e cada evento envia um push silencioso que soma +1. Nada toca, nada acende a tela de bloqueio, e à noite o ícone mostra discretamente um 3.
Quando o evento ao vivo abre, a mesma Jornada envia um push visível que vale a interrupção. Seja qual for o motivo que traz o jogador de volta, o SDK zera o badge ao abrir o app, e a contagem de amanhã começa de um número verdadeiro.
Para que usar
O badge rende na proporção da densidade de contagem: se o seu app tem um número real e crescente de itens não lidos ou pendentes que vale mostrar no ícone. Apps construídos em torno de um contador ganham um empurrão de reengajamento de graça; apps sem nada para contar ganham uma bolinha vermelha que ensina o usuário a ignorar bolinhas vermelhas.
| Momento | O que o número significa | Por que o badge funciona |
|---|---|---|
| E-commerce e marketplaces: itens no carrinho, ofertas não lidas | 2 itens no seu carrinho | Um lembrete discreto que não custa nenhuma atenção ao comprador |
| Fintech: extratos, alertas, ações pendentes | 1 ação pendente | Existe uma contagem real de documentos não lidos, e o ícone a mostra sem expor detalhes na tela de bloqueio |
| Jogos mobile: recompensas, vidas recarregadas, entradas em eventos | 3 itens para coletar | A contagem já faz parte do ciclo de retenção, e coletar é toda a motivação |
| Apps de criadores e assinatura: lançamentos, DMs, comentários | 12 não lidas | Um feed social já mantém esse número internamente; o ícone só precisa mostrá-lo |
| Mídia e notícias: matérias não lidas, novos episódios | 5 matérias não lidas | O caso clássico, e o que traz o leitor de volta para uma sessão com mais consistência |
| Trading e apostas: alertas disparados, apostas liquidadas | 4 alertas disparados | Os alertas se acumulam num número que de fato significa algo para o usuário |
| Saúde e telemedicina: resultados, mensagens seguras | Seus resultados chegaram | A contagem vai para a tela inicial enquanto o conteúdo fica atrás da autenticação |
| EdTech: aulas não vistas, sequências, tarefas | 2 aulas esperando | Uma sequência ou uma fila de aulas é exatamente o tipo de número que as pessoas gostam de zerar |
Quando o badge é a ferramenta errada
O badge informa uma quantidade. Tudo sobre o que está esperando, e com que urgência, pertence a outra superfície.
- O usuário precisa saber o que chegou: isso é um push mobile, um push com rich media ou uma mensagem in-app.
- O momento não pode esperar. O badge é passivo por natureza, então urgência pertence a um nível de interrupção.
- O estado é contínuo, não contado: um pedido a caminho, um placar ao vivo. Isso é uma Live Activity.
- O app não tem uma contagem que cresce naturalmente. Seguros, hotéis, contas de consumo e ferramentas de sessão única geram uma fatura ou uma reserva, e o badge ali é ruído.
- Sua audiência é majoritariamente Android — como acontece com boa parte dos apps no Brasil — e o badge seria uma mecânica principal. Trate-o como melhor esforço lá e desenhe o fluxo para funcionar sem ele.
Cobertura de plataformas e técnica
O iOS tem um único badge, e todo iPhone o desenha do mesmo jeito. O Android não tem API universal de badge, então o que aparece na tela inicial depende do launcher que o usuário estiver usando. A última coluna mostra quem de fato desenha o número, porque, para este recurso, é lá que está a resposta honesta.
| Recurso | iOS | Android | Web | Entregue por |
|---|---|---|---|---|
| Valor exato do badge | Sim, aps.badge padrão | Melhor esforço, depende do launcher | – | O payload do push, aplicado pelo SDK |
+1 e -1 relativos | Sim, Pushwoosh SDK 6.4.0+ | +n nos presets, depende do launcher | – | O push, com /setBadge mantendo o contador sincronizado |
Zerar para 0 | Sim | Depende do launcher | – | O payload do push, ou o app ao abrir |
| Campo Badges sem código | Sim, no editor e nos presets | Sim, um valor de badge nos presets | – | Pushwoosh Control Panel |
| Definir ou zerar pelo código do app | setApplicationIconBadgeNumber | PushwooshBadge | – | Seu app, pelo Pushwoosh SDK |
| Alterar a contagem antes da exibição | Sim, numa Notification Service Extension | – | – | PWNotificationExtensionManager com App Groups |
| Atualizar o badge sem alerta | Sim | Melhor esforço | – | Um push silencioso, mesma audiência e Jornada |
| Cobertura de launchers e dispositivos | Todo iPhone, de forma idêntica | Sony, Samsung, LG, HTC, ASUS, ADW, APEX, NOVA, Huawei, ZUK, OPPO | – | com.pushwoosh:pushwoosh-badge com permissões de launcher |
| Pixel e launchers sem suporte | n/a | – | – | Não existe API nativa de badge no Android, então nada aparece |
| Ler a contagem atual do SO | – | – | – | O iOS não expõe API de leitura, então a contagem fica no seu app ou no servidor |
| Badge no ícone do app | Sim | Depende do launcher | – | Navegadores não têm superfície equivalente para web push |
aps.badge padrão+1 e -1 relativos+n nos presets, depende do launcher/setBadge mantendo o contador sincronizado0setApplicationIconBadgeNumberPushwooshBadgePWNotificationExtensionManager com App Groupscom.pushwoosh:pushwoosh-badge com permissões de launcherSegurança e hospedagem
A Pushwoosh roda em hardware próprio nos EUA e na Alemanha, em conformidade com GDPR.
Como funciona
Definir um badge é sem código e gratuito em todos os planos. O tempo de engenharia fica em dois pontos específicos, e nenhum deles é o caso básico do iOS.
-
Monte a contagem (sem código)
Digite um número,
+n,-nou0no campo Badges do formulário Send-Push ou de um preset, ou envieios_badgeseandroid_badgespela Messages API. No iOS o caso básico não exige nada do seu app: o SDK aplica o valor na chegada. -
Configure os dois pontos que precisam (desenvolvedor)
O Android precisa da biblioteca
com.pushwoosh:pushwoosh-badgee das permissões específicas de cada launcher no manifest. Zerar ao abrir o push ou o app é uma chamada do SDK, e uma Notification Service Extension com App Groups só é necessária para contagens que precisam mudar antes da exibição. -
Orquestre (sem código)
Alimente o número com o total de não lidos da sua Message Inbox, altere-o com um push silencioso que não mostra alerta e zere-o no objetivo da mesma Jornada do Cliente que roda seu push, in-app e email.
Limites que vale conhecer
Explore produtos relacionados
Notificações push móveis da Pushwoosh: alcance total (iOS, Android, Huawei), conteúdo rico, segmentação precisa e jornadas omnichannel — 99% de uptime.
Uma central de notificações no seu app e site. A entrega silenciosa alcança todos os usuários, até quem recusou push, e as mensagens ficam salvas.
Mapeie e otimize suas campanhas com uma única ferramenta visual. Comunique, engaje, retenha, converta, segmente e experimente usando o Construtor de Jornada do Cliente da Pushwoosh.
Mensagens in-app da Pushwoosh: faça onboarding, upsell, avisos e colete feedback bem na hora em que o usuário está com atenção total no seu app. Editor sem código, layouts nativos via SDK, analytics por elemento. Conformidade com GDPR. Comece grátis.
Defina o nível de interrupção iOS do push que você já envia para que um alerta de fraude ou o entregador na porta passe pelo Foco e pelo Resumo Agendado.
Plataforma de notificações push móveis para aplicativos de jogos. Envie alertas personalizados, ofertas especiais e lembretes de eventos para manter os jogadores retornando.