Pular para o conteúdo principal
Este guia ajuda você a solucionar problemas relacionados ao recebimento de notificações push duplicadas. Se você está vendo mensagens in-app duplicadas, consulte nosso guia Mensagens In-App Duplicadas.
• A Apple reconheceu um bug no iOS 17 que causou duplicatas. Isso foi corrigido no iOS 17.3. Leia mais. • Se você está usando versões 4.4.1 – 4.6.2 do SDK Android OneSignal, atualize para a versão mais recente para evitar problemas conhecidos.

​
Mesma mensagem enviada múltiplas vezes

A causa mais comum de notificações duplicadas é enviar o mesmo payload de notificação mais de uma vez através da API OneSignal.

​
Razões comuns:

  • Seu servidor tenta novamente as requisições sem verificar se a primeira foi bem-sucedida.
  • Duplicação acidental de lógica no seu pipeline de notificação backend.
  • Você está migrando para OneSignal mas ainda está enviando notificações de um provedor anterior. Evite enviar de ambos os sistemas simultaneamente.

​
Múltiplos SDKs de notificação push

Verifique se seu aplicativo inclui outro SDK de notificação push (por exemplo, Firebase, Urban Airship). Estes podem também processar e exibir notificações OneSignal.
  • OneSignal inclui lógica para evitar duplicação quando é o único SDK.
  • Outros SDKs podem não reconhecer e filtrar payloads do OneSignal, levando a múltiplas exibições.
Veja o FAQ abaixo para mais informações sobre interoperabilidade de SDK.

​
Múltiplas instâncias de app

  • Android
  • IOS
  • Web Push

​
Android

Notificações duplicadas podem ocorrer quando:
  • Você tem versões de produção e desenvolvimento do seu aplicativo instaladas.
  • Cada app tem um nome de pacote único e recebe seu próprio token push.
Pressione longamente uma notificação para confirmar de qual instância do app ela veio.

​
Dicas de diagnóstico

Para nos ajudar a depurar problemas de duplicação mais rapidamente, colete e envie:
  • Versão do SDK OneSignal
  • Versão do OS do dispositivo
  • Ambiente de build (Mac/Windows)
  • Logs do Xcode ou saídas de logcat
  • Lista de outras bibliotecas/plugins no seu app
  • Etapas detalhadas de reprodução

​
FAQ

  • Android: OneSignal só manipulará notificações contendo uma chave "custom" com um campo "i". Se seu SDK anterior não verifica esta chave, ele também pode manipular e mostrar a mesma notificação.
  • iOS: Todas as notificações aparecem na bandeja do sistema. Se ambos os SDKs enviam a mesma mensagem, o usuário a verá duas vezes. Recomendação: Para manipulação de cliques iOS, verifique o payload "custom" antes de processar ou use suas próprias chaves de payload para evitar manipulação duplicada.
  • Android: Remova o código de manipulação de notificação do SDK antigo ao integrar OneSignal e lançar o app. À medida que os usuários atualizam, eles param de receber push do provedor antigo.
  • iOS: Você pode continuar enviando do provedor antigo temporariamente enquanto os usuários atualizam. Uma vez totalmente transitado, envie apenas do OneSignal para evitar duplicatas.