Plataforma de aplicativos

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

  1. Instale @pushengage/pushengage-react-native com npm ou yarn.
  2. 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.
  3. Para iOS, adicione Notificações Push e Modos de Segundo Plano no Xcode, e carregue seu certificado APNs na aba iOS SDK no PushEngage.
  4. Adicione uma Extensão de Serviço de Notificação ao projeto iOS. Uma Extensão de Conteúdo de Notificação é opcional.
  5. Adicione a capacidade de App Groups ao target principal do app e à extensão.
  6. 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.
  7. 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.