Categorias de notificação Android

As categorias de notificação Android (também conhecidas como canais de notificação) foram introduzidas no Android 8.0 (Oreo) para dar aos usuários maior controle sobre como recebem notificações do seu aplicativo. Isso permite que você categorize suas notificações e defina diferentes experiências, como comportamento de exibição, som, vibração, badges e visibilidade da tela de bloqueio. Por exemplo, se você tem notificações de últimas notícias, pode criar uma categoria para elas e definir importância “Urgente” e um som personalizado para garantir que sejam exibidas de forma proeminente, em contraste com notificações menos importantes que podem ser silenciadas ou ter um som padrão. O OneSignal facilita a criação e gerenciamento dessas categorias diretamente no painel. Alternativamente, você pode definir categorias programaticamente em seu aplicativo. Veja o guia do Android para criar canais de notificação.

---

​

Categorias de notificação padrão

O OneSignal cria automaticamente duas categorias padrão:

​

Diversos

Usado quando nenhuma categoria é definida.

• Importância: Alta
• Som: Padrão
• Vibração: Padrão
• Badges: Habilitado
• Tela de bloqueio: Privado

​

Restauradas

Usado quando o aplicativo é forçadamente fechado e reaberto. Se o aplicativo tiver notificações push no Centro de Notificações quando for forçadamente fechado, elas serão removidas do dispositivo. Reabrir o aplicativo recria (restaura) essas notificações. Nosso SDK definirá automaticamente a categoria como “Restauradas” com as seguintes configurações para evitar comportamento indesejado e potencial frustração do cliente ao receber múltiplas notificações do seu aplicativo com sons e pop-ups.

• Importância: Baixa
• Som: Desligado
• Vibração: Desligado
• Badges: Desabilitado
• Tela de bloqueio: Privado

​

Comportamento específico da Huawei

Em dispositivos Huawei, o OneSignal não define uma categoria padrão. Se você não incluir uma, a Huawei aplicará importância Alta por padrão.

---

​

Criar categorias de notificação Android no OneSignal

1. Vá para Configurações > Push & No Aplicativo > Canais de Notificação Android no Painel OneSignal.
2. Clique em Adicionar Grupo para organizar suas categorias (por exemplo, “Atualizações de Notícias”, “Atividade Social”).
3. Clique em Adicionar Canal dentro do grupo para criar uma nova categoria.

Você será solicitado a definir o seguinte:

​

Nome

Visível ao usuário. Mantenha claro e descritivo.

​

Descrição

Visível ao usuário. Explique brevemente o tipo de notificações que esta categoria irá lidar.

​

Importância

Controla o quão visível e interruptiva a notificação é:

• Baixa: Silenciosa, sem alertas
• Média: Sem som/vibração, interrupção visual mínima
• Alta: Toca som ou vibra, sem pop-up na tela
• Urgente: Toca som e aparece como uma notificação heads-up ou estilo banner

​

Som

• Desligado: Sem som
• Padrão: Tom de notificação padrão do dispositivo
• Personalizado: Carregue e referencie um som personalizado (sem extensão de arquivo). Exemplo: alert_beep (não alert_beep.wav) Veja Sons de Notificação para instruções de configuração.

​

Vibração

• Desligado: Sem vibração
• Padrão: Usa o padrão de vibração do dispositivo
• Personalizado: Defina o seu próprio usando um padrão (em ms). Exemplo: 0, 300, 500, 300 → Aguarde 0ms, vibre 300ms, pause 500ms, vibre 300ms.

​

Cor do LED

Alguns dispositivos Android suportam indicadores LED:

• Desligado: Sem LED
• Padrão: Padrão do dispositivo
• Personalizado: Valor hexadecimal ARGB (por exemplo, FF0000FF para azul)

​

Badges

Mostra contagem de badge no ícone do aplicativo:

• Habilitado: Badge é mostrado
• Desabilitado: Nenhum badge exibido

​

Visibilidade da tela de bloqueio

• Pública: Conteúdo completo mostrado
• Privada: Apenas nome do aplicativo, oculta conteúdo
• Secreta: Nenhuma notificação visível na tela de bloqueio

---

​

Atualizar categorias

Depois que um dispositivo recebe uma notificação de uma categoria, o Android bloqueia o comportamento dessa categoria. Alterações na importância, som, vibração ou outras configurações não serão aplicadas retroativamente. Por exemplo, se você enviar uma notificação push com uma categoria usando importância “Alta” e som, depois alterar a importância para “Urgente” e usar um arquivo de som diferente, a próxima notificação push para o mesmo dispositivo com a mesma categoria não terá importância “Urgente” ou o novo som. Opções:

• Para atualizar comportamento: Crie uma nova categoria.
• Para testar alterações: Limpe os dados do aplicativo ou desinstale e reinstale o aplicativo.

Você pode atualizar:

• Nome do canal
• Nome do grupo de canais

Estes serão atualizados nas configurações de notificação do Android quando a próxima notificação for recebida usando aquele canal atualizado.

---

​

Excluir categorias

Para remover uma categoria excluída do dispositivo do usuário:

1. Exclua a categoria do painel OneSignal.
2. Certifique-se de que todas as notificações sejam limpas do Centro de Notificações.
3. Peça ao usuário para:
   • Colocar o aplicativo em segundo plano por 60+ segundos
   • Abri-lo novamente (aciona sincronização do SDK)

O SDK será re-sincronizado e removerá a categoria excluída das configurações do Android.

---

​

Adicionando categorias às notificações

Dependendo de como você criou a Categoria Android e como está enviando a mensagem, estas são as formas de referenciar a categoria em suas notificações push.

​

Enviando do Painel OneSignal

1. Dentro do seu Template ou Compositor de Mensagem Push, navegue até as configurações do Android.
2. Em Category, selecione sua categoria se criada no painel OneSignal ou selecione (Created in App) se criada programaticamente em seu aplicativo.
   • Se criada programaticamente, também defina o campo Existing Channel para o nome definido em seu código.

​

Enviando com a API REST

Se você criou a categoria no painel OneSignal, use o android_channel_id na solicitação da API Create message. Você pode encontrar o ID do Canal na tela de configuração de Categoria Android. Se estiver usando seus próprios canais Android criados programaticamente, use o parâmetro existing_android_channel_id na solicitação da API Create message e defina o nome conforme definido em seu código.

---

​

FAQ e solução de problemas

​

As categorias podem tocar sons no modo Não Perturbe (DND)?

Não. O OneSignal não define setBypassDnd nas categorias. Para substituir o DND, crie seu próprio canal programaticamente e habilite esta configuração. Veja setBypassDnd.

​

Posso localizar nomes ou descrições de categorias?

Não. O OneSignal não suporta múltiplos idiomas para categorias. Para suportar localização, defina seus próprios canais Android e referencie-os via existing_android_channel_id em suas solicitações de API push.

​

Por que minha categoria Android não está funcionando?

Existem várias razões pelas quais sua categoria Android pode não estar funcionando como esperado. Para solucionar problemas, verifique o seguinte:

• O que não está funcionando?
  • O arquivo de som não está tocando?
  • Não está sendo exibido no dispositivo?
  • Você não vê a categoria nas Configurações de Notificação Android?
• Como a categoria foi criada?
  • Se criada no painel OneSignal, certifique-se de que as configurações estão definidas como você espera.
  • Se criada programaticamente em seu aplicativo, revise seu código. Veja o guia do Android para criar canais de notificação.
• Revise as configurações da categoria:
  • Certifique-se de que as configurações estão definidas como você espera.
  • O arquivo de som está sendo referenciado corretamente? Veja a seção Som acima.
  • O nome ou ID da categoria está sendo referenciado corretamente ao enviar a mensagem?
• Você atualizou as configurações após enviar uma notificação?
  • Se você atualizou as configurações após enviar uma notificação, o Android não aplicará essas atualizações ao seu dispositivo. Veja Atualizar categorias acima.
• Verifique a inicialização do SDK OneSignal:
  • Certifique-se de que o OneSignal seja inicializado na classe Application, não em uma Activity. Veja Configuração do SDK Android.

---