> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Configuração de push mobile
> Lista de verificação completa para configurar notificações push mobile com OneSignal em iOS, Android, Huawei e Amazon.
As notificações push reengajam Usuários quando eles não estão usando ativamente seu aplicativo. Elas podem exibir texto e conteúdo rico como imagens, botões e sons.
Para push funcionar em mobile:
* Os Usuários devem ter seu aplicativo mobile instalado
* Você deve configurar as credenciais de plataforma corretas (FCM para Android, APNs para iOS, HMS para Huawei, ADM para Amazon)
* Os Usuários devem conceder permissão para receber notificações
Este guia percorre cada passo, desde a configuração do SDK até o envio de mensagens push personalizadas.
***
## Configuração do SDK e migração
Integre o SDK do OneSignal em seu aplicativo para registrar dispositivos e habilitar mensagens push. Se você está migrando de outro provedor, o OneSignal suporta migração do Firebase, Airship, Braze e outros.
Integre o SDK do OneSignal em seu aplicativo para registrar dispositivos e habilitar mensagens push.
Migre do Firebase, Airship, Braze ou outros provedores de push.
***
## Prompts de permissão push
Plataformas mobile exigem que os Usuários optem por receber notificações push antes de poder recebê-las. As [Diretrizes de Interface Humana](https://developer.apple.com/design/human-interface-guidelines/ios/system-capabilities/notifications) da Apple recomendam descrever os tipos de informação que você deseja enviar e dar aos Usuários uma maneira clara de aceitar ou recusar.
Você pode criar um prompt de pré-permissão usando as mensagens in-app do OneSignal para explicar o valor antes de acionar o prompt do sistema.
Crie um prompt de pré-permissão personalizado usando mensagens in-app.
Acione solicitações de permissão programaticamente no SDK.
Mostre notificações silenciosas no centro de notificações antes de solicitar.
***
## Usuários e Assinaturas
Uma vez que o SDK está ativo, o OneSignal cria automaticamente registros de Usuário e Assinatura à medida que as pessoas abrem seu aplicativo.
As Assinaturas mobile são criadas quando os Usuários:
* Abrem o aplicativo pela primeira vez em um dispositivo
* Desinstalam e reinstalam o aplicativo, depois abrem o aplicativo novamente
Cada dispositivo cria uma Assinatura separada. As Assinaturas permanecem anônimas até que você atribua a elas um [External ID](./users#external-id) via `OneSignal.login`.
Gerencie Usuários, atribua External IDs e entenda Usuários anônimos vs. identificados.
Como as Assinaturas são criadas e gerenciadas em dispositivos e canais.
Agrupe Usuários em segmentos dinâmicos para mensagens direcionadas.
***
## Projetar notificações push
Criar notificações push eficazes envolve mais do que escrever texto. Assista como fazer cada notificação push valer a pena e depois explore os elementos de design abaixo.
1. [Título](./push#title): Manchete que chama atenção (recomendado: menos de 50 caracteres)
2. [Mensagem](./push#message): Conteúdo principal da notificação (recomendado: menos de 120 caracteres)
3. [Ícones](./notification-icons): Ícone da sua marca ou imagem específica da notificação
4. [Imagem grande](./push#image): Conteúdo visual atraente
5. [Botões de ação](./action-buttons): Botões de call-to-action
6. Timestamp de quando o push foi recebido
7. [Nome do app](./push#app-name): O nome do seu aplicativo
Visão geral completa da criação de notificações push, opções e comportamento de entrega.
Economize tempo com templates reutilizáveis para mensagens consistentes.
### Personalização e localização
Assista como transformar notificações push genéricas em mensagens de alto desempenho e depois explore as opções de personalização abaixo.
Insira variáveis dinâmicas como nome ou preferências para adaptar mensagens.
Entregue automaticamente mensagens no idioma preferido de cada Usuário.
***
## Configurar comportamento push
Controle como as notificações se comportam após a entrega, incluindo timing, configurações de exibição e interações do Usuário.
### Configurações de entrega, exibição e descarte
Controle a velocidade de entrega de notificações para grandes audiências.
Defina limites para evitar o envio excessivo de notificações para o mesmo Usuário.
Defina por quanto tempo os serviços push retêm mensagens quando o dispositivo está offline.
Substitua mensagens anteriores por novas para reduzir o excesso de notificações.
Controle o nível de importância (banner, silencioso) e outros aspectos de exibição.
Controle o nível de prioridade (passivo, sensível ao tempo) para iOS.
Configure o áudio de notificação para cada plataforma.
Gerencie o comportamento do contador de badge do ícone do aplicativo no iOS.
### Notificações de dados e em segundo plano
Inclua dados personalizados nos payloads push que seu aplicativo pode processar sem exibir uma notificação visível.
Envie payloads personalizados sem uma notificação visual.
Anexe dados chave-valor aos payloads push para processamento in-app.
### Comportamento de clique e deep linking
Controle o que acontece quando um Usuário toca em uma notificação.
Direcione Usuários para conteúdo ou páginas relevantes usando deep links e URLs de rastreamento.
Detalhes de implementação de deep linking específicos por plataforma.
Permita que os Usuários tomem ações imediatas a partir de sua notificação.
Ouça eventos de clique e acione comportamento in-app com código personalizado.
***
## Análises e solução de problemas
Meça o desempenho das notificações e resolva problemas comuns de entrega.
Veja métricas de entrega, taxa de abertura e cliques para cada mensagem.
Explore métricas de engajamento e comportamento do Usuário em todos os canais.
Checklist de solução de problemas se as mensagens não estão aparecendo nos dispositivos.
Corrija problemas de renderização de imagem em todas as plataformas.
Solucione por que notificações duplicadas estão sendo exibidas.
***
## Próximos passos
Otimize mensagens com experimentos para descobrir o que impulsiona o engajamento.
Crie fluxos de mensagens automatizados de várias etapas acionados pelo comportamento do Usuário.
Adicione dados de nível de Usuário para personalização e direcionamento.
Alcance Usuários com mensagens ricas e interativas dentro do seu aplicativo.
***
## Perguntas frequentes
### Os Usuários precisam optar por receber notificações push?
Sim. Tanto iOS quanto Android exigem que os Usuários concedam permissão antes de poder receber notificações push. No iOS, você deve exibir o prompt do sistema. No Android 13+, a permissão `POST_NOTIFICATIONS` é necessária. Use um [prompt de pré-permissão](./prompt-for-push-permissions) para explicar o valor antes de acionar a caixa de diálogo do sistema.
### O que são FCM, APNs, HMS e ADM?
São serviços de entrega push específicos de cada plataforma. **FCM** (Firebase Cloud Messaging) entrega para Android e web. **APNs** (Apple Push Notification service) entrega para iOS e macOS. **HMS** (Huawei Mobile Services) entrega para dispositivos Huawei. **ADM** (Amazon Device Messaging) entrega para dispositivos Amazon Fire. Você configura as credenciais para cada um no painel do OneSignal durante a [configuração do SDK](./mobile-sdk-setup).
### Por que minhas notificações push não estão aparecendo?
As causas comuns incluem credenciais de plataforma ausentes ou expiradas, Usuários que não concederam permissão, ou configurações no nível do dispositivo como Não Perturbe ou Modos de Foco. Consulte [Notificações não exibidas ou atrasadas](./notifications-show-successful-but-are-not-being-shown) para uma lista de verificação completa de solução de problemas.
### Posso enviar notificações push sem uma notificação visível?
Sim. Use [notificações de dados e em segundo plano](./data-notifications) para enviar payloads personalizados que seu aplicativo processa silenciosamente. Eles são úteis para acionar sincronizações em segundo plano, atualizar dados locais ou atualizar conteúdo sem interromper o Usuário.
Para push funcionar em mobile:
* Os Usuários devem ter seu aplicativo mobile instalado
* Você deve configurar as credenciais de plataforma corretas (FCM para Android, APNs para iOS, HMS para Huawei, ADM para Amazon)
* Os Usuários devem conceder permissão para receber notificações
Este guia percorre cada passo, desde a configuração do SDK até o envio de mensagens push personalizadas.
***
## Configuração do SDK e migração
Integre o SDK do OneSignal em seu aplicativo para registrar dispositivos e habilitar mensagens push. Se você está migrando de outro provedor, o OneSignal suporta migração do Firebase, Airship, Braze e outros.
1. [Título](./push#title): Manchete que chama atenção (recomendado: menos de 50 caracteres)
2. [Mensagem](./push#message): Conteúdo principal da notificação (recomendado: menos de 120 caracteres)
3. [Ícones](./notification-icons): Ícone da sua marca ou imagem específica da notificação
4. [Imagem grande](./push#image): Conteúdo visual atraente
5. [Botões de ação](./action-buttons): Botões de call-to-action
6. Timestamp de quando o push foi recebido
7. [Nome do app](./push#app-name): O nome do seu aplicativo