PushEngage para React Native
Adicione notificações push e mensagens in-app a um aplicativo React Native no Android e iOS com o SDK PushEngage React Native. Um pacote npm com suporte a TypeScript e JavaScript cobre ambas as plataformas, e as campanhas são executadas no painel PushEngage.
O que você pode fazer com React Native
Um pacote para Android e iOS
Uma única API JavaScript fica sobre o código nativo Swift e Kotlin, entregando através do Firebase Cloud Messaging no Android e do Apple Push Notification service no iOS.
Deep links e toques na inicialização a frio
Um listener recebe o deep link e os dados da notificação quando uma notificação é tocada, e uma chamada separada retorna a notificação que iniciou o aplicativo.
Permissão e inscrição em uma única chamada
Solicitar permissão de notificação também inscreve o usuário quando ele a permite, portanto, não há uma etapa de inscrição separada.
Segmentos, atributos e campanhas acionadas
Adicione assinantes a segmentos estáticos ou dinâmicos, defina atributos personalizados e envie eventos de gatilho, metas e alertas de queda de preço ou inventário do JavaScript.
Mensagens in-app
Exiba banners, modais e mensagens de tela cheia projetados no painel. Nenhuma configuração do lado do JavaScript é necessária depois que o SDK tiver seu App ID.
Fluxo de trabalho bare e builds de desenvolvimento Expo
Projetos React Native bare são totalmente suportados. Projetos Expo funcionam através de um build de desenvolvimento, abordado na página Expo deste diretório.
Como configurar
- Instale @pushengage/pushengage-react-native com npm ou yarn.
- Para Android, configure o Firebase Cloud Messaging e insira seu Sender ID e Service Account JSON no PushEngage em Configurações do Site > Instalação > SDK Android.
- Para iOS, adicione Notificações Push e Modos de Segundo Plano no Xcode, e carregue seu certificado APNs na aba iOS SDK no PushEngage.
- Adicione uma Extensão de Serviço de Notificação ao projeto iOS. Uma Extensão de Conteúdo de Notificação é opcional.
- Adicione a capacidade de App Groups ao target principal do app e à extensão.
- Inicialize o SDK com seu App ID no índice root.js antes que o aplicativo seja registrado, e adicione as linhas PushEngage ao AppDelegate.mm para iOS.
- Execute em um dispositivo físico e envie um teste de Campanha > Transmissões Push.
Guia completo: Quickstart do React Native
Bom saber
- Push de aplicativo e este SDK estão listados em todos os planos PushEngage, incluindo o plano gratuito. Rastreamento de metas, campanhas acionadas personalizadas e mensagens no aplicativo exigem um plano pago.
- O SDK atual precisa do React Native 0.78 ou posterior com a Nova Arquitetura (Turbo Modules). As docs apontam versões mais antigas do React Native para uma versão anterior do SDK.
- Android precisa de um projeto Firebase, e iOS precisa de uma conta Apple Developer com um App ID e um certificado APNs.
- O SDK inclui código nativo, portanto, não roda no Expo Go. Use um projeto bare ou um build de desenvolvimento Expo.
- A configuração nativa ainda é necessária em ambos os lados: Gradle e Firebase para Android, capacidades Xcode e uma Extensão de Serviço de Notificação para iOS.
- Se o build do iOS falhar em @import com módulos C++ desativados, adicione -fcxx-modules a Outras Flags C++ no Xcode.
Sobre esta conexão
- PushEngage constrói e mantém este SDK. Não é uma parceria com a Meta ou o projeto React Native.
- O código fonte está público no GitHub no repositório awesomemotive/pushengage-react-native sob a licença MIT.
- O pacote é publicado no npm sob o escopo @pushengage.
- PushEngage também publica Agent Skills de código aberto, para que um agente de codificação de IA como Claude Code ou Cursor possa executar a integração e diagnosticar uma configuração com defeito.
Diretório de Parceiros PushEngage
Pronto para adicionar notificações push ao seu aplicativo React Native? Comece com o guia de configuração.
O PushEngage tem um plano gratuito, então você pode instalá-lo e enviar sua primeira campanha antes de pagar qualquer coisa.