Se você está tendo problemas com seu site e nenhum aplicativo mobile, consulte nosso guia de Solução de Problemas de Web Push.
Passos para solução de problemas
1. Revise as instruções de configuração e atualize o SDK OneSignal
Nossas instruções de configuração do SDK Mobile são projetadas para ajudar a prevenir problemas comuns e testar a integração. Frequentemente lançamos atualizações com correções de bugs, melhorias e suporte para as últimas mudanças do sistema operacional. Se você está enfrentando problemas, primeiro certifique-se de que está usando nossa versão mais recente do SDK e seguiu as instruções de configuração.2. Guias comuns de solução de problemas
Notificações não exibidas ou atrasadas
Enviando notificações push e elas não são exibidas no dispositivo ou estão atrasadas.
Imagens de notificação não aparecem
Imagens de notificação não estão aparecendo na visualização expandida da notificação.
CTR de Notificação
Poucos ou nenhum clique em notificações.
Notificações duplicadas
Notificações estão sendo exibidas várias vezes.
Solução de problemas de mensagens in-app
Solucione problemas comuns com mensagens in-app.
3. Teste o projeto de exemplo para seu SDK
Verifique se o problema é reproduzível usando a build criada por nossa equipe de engenharia para cada SDK.- Projeto de exemplo iOS
- Projeto de exemplo Android
- Projeto de exemplo de variantes Cordova
- Projeto de exemplo React Native
- Projeto de exemplo Flutter
- Projeto de exemplo Unity
- Projeto de exemplo .NET Maui
4. Verifique os logs de erro
Antes de diagnosticar problemas, é importante coletar dados de log:- Siga nosso guia sobre captura de um log de debug.
- Procure por erros, avisos ou avisos de descontinuação que possam explicar o comportamento.
5. Entre em contato com o suporte
Se você ainda está tendo problemas:- Entre em contato com
support@onesignal.comcom:- Seu OneSignal App ID.
- Seu External ID e/ou Subscription ID do dispositivo no qual você está enfrentando o problema.
- O ID da notificação ou um link para a notificação no Painel do OneSignal, se aplicável.
- Um log de debug do dispositivo reproduzindo o problema, se possível.
Erros comuns
APNS Delegate never fired
Erros APNS como “Apns Delegate Never Fired” e “APNS 3000” são mensagens de timeout fornecidas pela Apple indicando que o dispositivo não conseguiu fazer uma conexão com os servidores APNS da Apple necessários para notificações push. Isso é mais comum quando:- Testando em ambientes de desenvolvimento APNS
- Se você usa múltiplas dependências de notificação push ou APIs push nativas do iOS com OneSignal
- Erro temporário que se resolve sozinho na próxima vez que o usuário inicia uma nova sessão (aplicativo fora de foco por 30+ segundos, depois aberto novamente).
- Remova quaisquer outras dependências de notificação push ou APIs push nativas do iOS e use apenas o OneSignal. Quando o erro for resolvido, você pode tentar adicionar o outro código de volta e entrar em contato com
support@onesignal.compara melhores práticas. - Verifique o log de debug do dispositivo para mais detalhes.
- Se o erro persistir, siga estes passos para entrar em contato com o suporte.
FAQ
O que acontece se eu mudar meu OneSignal App ID no meu aplicativo?
Mudar o OneSignal App ID no código de inicialização do seu aplicativo criará um usuário completamente novo e uma subscription push sob o novo App ID quando o usuário atualizar e abrir o aplicativo para a versão mais recente. Se seu iOS bundle ID e/ou Android package ID forem os mesmos, então o dispositivo continuará com o mesmo status de subscription push. Os dados do usuário serão completamente novos, ou seja, você precisará adicionar de volta seus aliases, tags, endereço de email, número de telefone no novo registro. Se o iOS bundle ID ou Android package ID forem diferentes, então este é um aplicativo completamente novo e deve ter diferentes certificados/chaves push.O OneSignal pode enviar notificações push em uma rede fechada on-premise?
Isso pode funcionar contanto que os computadores na sua rede fechada tenham acesso aos servidores de gateway push que você deseja suportar:- https://support.apple.com/en-us/HT203609
- https://firebase.google.com/docs/cloud-messaging/concept-options#messaging-ports-and-your-firewall