Para notificações Android Web Push, o badge se refere ao pequeno ícone mostrado nas notificações—não no ícone do aplicativo—e pode ser personalizado. Veja Web Push Badges.
Badges do Android
O comportamento de badge do ícone de aplicativo Android pode ser gerenciado através de categorias de notificação do Android. Você pode controlar se uma categoria (canal) exibe um badge e definir o comportamento do badge por categoria.Badges Huawei
Em dispositivos Huawei, um badge pode ser exibido como um número ou um ponto no ícone do aplicativo, dependendo das configurações do dispositivo do usuário. Badges ajudam a indicar mensagens não lidas ou ações pendentes, encorajando os usuários a abrir o aplicativo. O OneSignal permite que você controle as contagens de badges Huawei diretamente através do painel ou API.Como os badges Huawei funcionam
O badge é exibido no ícone do aplicativo como uma contagem numérica ou um ponto, dependendo das configurações do dispositivo do usuário (Configurações > Notificações > Badges de ícone de aplicativo). Sua chamada de API controla a contagem subjacente; o dispositivo decide o estilo visual.Parâmetros
| Parâmetro | Tipo | Intervalo | Descrição |
|---|---|---|---|
huawei_badge_class | string | — | (Obrigatório) Nome de classe totalmente qualificado da Activity de lançamento do seu aplicativo (ex.: com.example.myapp.MainActivity). Informa ao sistema Huawei em qual ícone de aplicativo exibir o badge. |
huawei_badge_set_num | integer | 0–99 | Define o badge para um número exato. 0 limpa o badge. |
huawei_badge_add_num | integer | 1–99 | Incrementa a contagem de badge existente por esta quantidade. |
Regras de comportamento
huawei_badge_classé obrigatório para qualquer operação de badge.- Se
huawei_badge_set_numehuawei_badge_add_numforem fornecidos,huawei_badge_set_numtem prioridade. - Se nenhum for fornecido (mas
huawei_badge_classestiver definido), a contagem de badge incrementa em 1 por padrão.
Enviar push Huawei com badges
- Dashboard
- API
- Vá para Messages > Push ou Templates
- Em Platform Settings > Send to Huawei Android > Badge
- Escolha uma das seguintes opções:
- Não definir — o badge não é afetado por esta notificação
- Definir para — define o badge para um número específico (0-99)
- Aumentar em — incrementa a contagem de badge existente (1-99)
Limpando badges
A Huawei não limpa automaticamente o badge quando um usuário abre o aplicativo ou toca em uma notificação. Para limpar o badge, você tem duas opções:- Via API ou painel: Envie uma notificação com
huawei_badge_set_numdefinido como0(ou use Definir para > 0 no painel). Pode ser uma notificação de dados/em segundo plano se você não quiser que uma notificação visível apareça. - Via código do lado do cliente: Seu aplicativo pode limpar o badge localmente usando a API de badge da Huawei. Isso requer a permissão
com.huawei.android.launcher.permission.CHANGE_BADGEem seuAndroidManifest.xml. Consulte o guia de desenvolvimento de badges da Huawei para detalhes de implementação.
O parâmetro
huawei_badge_set_num requer EMUI 10.0.0 ou posterior e Push SDK 10.1.0 ou posterior. Em dispositivos mais antigos, apenas huawei_badge_add_num é suportado.Badges do iOS
Para garantir que as contagens de badge incrementem corretamente no iOS, você deve configurar:- O
OneSignalNotificationServiceExtension - App Groups
- Limpar o badge do ícone do aplicativo quando o aplicativo é aberto.
- Remover notificações da Central de Notificações.
- Redefinir badge quando o aplicativo é iniciado ou retomado
- Incrementar badge quando uma notificação é recebida em primeiro plano
- Decrementar quando uma mensagem é lida ou descartada
- Sincronizar estado de badge entre dispositivos ou extensões de aplicativo via App Groups ou seu backend
Desabilitar notificação automática e limpeza de badge
Noinfo.plist do seu aplicativo, adicione a chave: OneSignal_disable_badge_clearing com tipo Boolean para o valor YES

Gerenciamento nativo de badge do iOS
Se você desabilitar a limpeza automática de badge do OneSignal, você pode usar as APIs nativas da Apple para controlar o comportamento do badge. Definir contagem de badge Para definir o badge no ícone do aplicativo para um valor específico:UserDefaults, o modelo de dados do seu aplicativo ou sincronizando com seu backend).
Enviar push do iOS com badges
Você pode definir a contagem de badge no painel do OneSignal ou usando a API.- Dashboard
- API
- Vá para Messages > Push ou Templates.
- Em Platform Settings > Send to Apple iOS > Badges.
- Escolha:
- Definir para um número específico.
- Aumentar por uma quantidade relativa.

FAQ
Por que a contagem de badge não está incrementando no iOS?
Certifique-se de ter configurado oOneSignalNotificationServiceExtension e os App Groups. Sem esses, as contagens de badge não podem incrementar corretamente. Veja Configuração do SDK móvel para instruções completas.
Como limpar badges no Huawei?
Envie uma notificação comhuawei_badge_set_num definido como 0, ou use Definir para > 0 no painel. Você também pode usar uma notificação de dados/em segundo plano para limpar badges sem mostrar uma notificação visível. Alternativamente, limpe o badge do lado do cliente usando a API de badge da Huawei.
Posso definir badges para web push?
Não. Badges de ícone de aplicativo são suportados apenas no iOS, Android e Huawei. Para Android web push, o “badge” se refere ao pequeno ícone exibido na própria notificação — veja Web Push Badges.Páginas relacionadas
Categorias de notificação do Android
Controle a exibição e o comportamento de badges por canal de notificação no Android.
Autorização Huawei
Configure o envio de mensagens push Huawei com o OneSignal.
Visão geral de push
Referência completa para recursos de notificação push, incluindo badges de web push.
Configuração do SDK móvel
Configure o SDK do OneSignal incluindo pré-requisitos de badge para iOS.