--- title: "Guia rápido de início de mensagens no aplicativo" slug: "quick-start-inapp" updated: 2026-06-12T10:30:57Z published: 2026-06-12T10:30:57Z canonical: "docs.xtremepush.com/quick-start-inapp" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt > Use this file to discover all available pages before exploring further. # Guia rápido de início de mensagens no aplicativo Tudo o que você precisa saber antes de começar a enviar mensagens dentro do app Mensagens dentro do app são entregues aos usuários que navegam no seu app em resposta a um gatilho de evento. Opt-in não é obrigatório para esse tipo de mensagem. Tanto eventos do SDK quanto do servidor podem ser usados para acionar mensagens dentro do app. ## Pré-requisitos: integração do SDK Mensagens dentro do app exigem que você configure seu app no seu projeto Xtremepush e que complete a integração do SDK Xtremepush. Veja detalhes de como fazer isso para [Android](/documentation/docs/pt-br/android-integration) e [iOS](/documentation/docs/pt-br/ios-integration). Se seu app não for totalmente nativo, mas construído com um framework móvel, você precisará dos pré-requisitos para iOS e Android mencionados acima, mas suas alterações no código estarão relacionadas ao framework móvel específico que você está usando. Damos suporte a uma variedade de frameworks móveis populares, incluindo: - [PhoneGap](/documentation/docs/pt-br/phonegap) - [Titânio](/documentation/docs/pt-br/unity) - [Xamarin](/documentation/docs/pt-br/xamarin) - [Unidade](/documentation/docs/pt-br/unity) - [Aplicativos híbridos](/documentation/docs/pt-br/hybrid-apps) Depois de integrar o SDK no seu app, será necessário ativar a mensagem dentro do app usando o seguinte método: **Java (Android)** ```java .setEnableInApp(true) ``` **Objetivo C (iOS)** ```objectivec [XPush setInAppMessageEnabled: YES]; ``` **Swift (iOS)** ```swift XPush.setInAppMessageEnabled(true) ``` ## Adicionar eventos para disparar mensagens Mensagens dentro do app são acionadas por eventos do SDK, eventos do servidor ou no início da sessão (um evento do sistema que precisa ser implantado no seu app). ### Eventos SDK Depois que o SDK for implantado, você pode adicionar esses eventos facilmente chamando um método simples no seu app iOS ou Android. Eventos de gatilho são adicionados ao seu app usando o `eventHit` método do Xtremepush SDK. **Java (Android)** ```java mPushConnector.hitEvent("EVENT_NAME"); ``` **Objetivo C (iOS)** ```objectivec [XPush hitEvent: @"EVENT_NAME"]; ``` **Swift (iOS)** ```swift XPush.hitEvent("EVENT_NAME") ``` Esses eventos podem ser acionados quando seções do app são abertas, botões são pressionados ou eventos mais complexos ocorrem, como compras ou o cumprimento de objetivos. Você deve selecionar um evento que acione a mensagem para ser enviada enquanto o aplicativo estiver aberto. > [!TIP] > Tempo real vs. enfileira > > Você só pode configurar mensagens em tempo real no app especificando gatilhos de eventos do SDK em campanhas independentes In-App / On-site, que são criadas a **partir de Campanhas > Criar uma campanha > In-App/On-site**. Eventos SDK também podem ser usados em campanhas multicanal dentro do App, mas a mensagem será recuperada usando um mecanismo de pesquisa. Para mais detalhes sobre eventos, incluindo envio de valores únicos ou pares chave/valor junto com eventos, confira a documentação [do iOS](/documentation/docs/pt-br/ios-events) e [Android](/documentation/docs/pt-br/android-events) . ### Eventos do servidor Eventos do servidor podem incluir qualquer evento backend ou externo que possa ser acionado por integrações ou por meio de API externa usando o método de evento hit. Ao usar esses eventos, as mensagens enviadas aos seus usuários serão enfileiradas e entregues apenas após abrirem seu aplicativo. Para mais informações, leia nosso [guia](https://docs.xtremepush.com/v2025.4/docs/trigger-server-events) dedicado. > [!TIP] > Eventos no servidor só podem ser usados quando você cria uma campanha independente **no aplicativo / no local** . Para criar uma campanha autônoma no local, navegue até **Campanhas > Criar uma campanha > In-app/On-site**. ## Ativar o canal dentro do aplicativo Para poder usar o canal dentro do app, ele deve ser ativado primeiro por um usuário do Projeto ou Administrador da Empresa, a **partir de Configurações > Apps e Sites >** clicar no aplicativo correspondente alternando o controle **deslizante Dentro do app** e clicando em **Ativar**. Não é necessária nenhuma configuração adicional. Depois de ativar o canal dentro do app, você poderá ver **Mensagens In-app / On-site** como um canal disponível na página do construtor de campanhas. > [!TIP] > Testando... > > É recomendado realizar testes antes de começar a enviar campanhas dentro do aplicativo para seus clientes. Você encontrará detalhes sobre como fazer o teste abaixo. ## Mensagens de teste dentro do aplicativo Mensagens dentro do aplicativo podem ser usadas como campanhas independentes ou como parte de campanhas de estágio único. Para criar campanhas independentes, acesse **Campanhas > Criar Campanha > Dentro do Aplicativo / On-Site**. Criar campanhas independentes permite usar SDK e eventos de backend como gatilhos de campanha. Para mais informações, [veja Definir Gatilhos para Campanhas In-App / On-Site](/documentation/docs/pt-br/set-triggers-for-in-app-and-on-site-campaigns). Para adicionar mensagens In-App a campanhas multicanal de estágio único, vá em **Campanhas > Criar campanha > Evento de > de etapa única acionado** e, em seguida, selecione o canal In-App na aba **Configuração** da sua campanha. Você pode consultar mais detalhes sobre como configurar uma campanha dentro do aplicativo [neste guia](/documentation/docs/pt-br/campaign-in-app) e também conferir [nosso guia de diretrizes criativas](/documentation/docs/pt-br/in-app-message-creative-guidelines) para obter os melhores resultados. Para iniciar uma campanha de teste, você pode disparar manualmente um evento do seu app, usando o método de eventos do SDK. **Java (Android)** ```java mPushConnector.hitEvent("EVENT_NAME"); ``` **Objetivo C (iOS)** ```objectivec [XPush hitEvent: @"EVENT_NAME"]; ``` **Swift (iOS)** ```swift XPush.hitEvent("EVENT_NAME") ``` > [!NOTE] > Um evento é criado no seu projeto quando você o executa pela primeira vez pelo seu app, ou você também pode criá-lo manualmente navegando para **o Gerenciador de Dados > evento Eventos > Criar**. Depois de iniciar ou criar esse evento, você poderá selecioná-lo digitando o nome do evento na aba **Eventos** . Configure todas as outras opções seguindo nosso [guia](/documentation/docs/pt-br/campaign-events). Navegue até a [**aba Segmento**](/documentation/docs/pt-br/campaign-segment) para especificar os destinatários da campanha. Se você tiver mais de um app integrado, precisa especificar qual deseja direcionar, caso contrário, o conteúdo aparecerá em todos eles. Se você tem vários usuários e quer direcionar um específico, pode fazer isso selecionando **Criar Segmento Personalizado > identificador > ID de usuário igual** e fornecendo o ID de usuário que deseja direcionar. Isso só funcionará se você já [tiver definido seu ID de usuário](/documentation/docs/pt-br/set-user-id) no [Segmentation Engine](/documentation/docs/pt-br/segmentation). Alternativamente, você pode direcionar por ID de dispositivo selecionando **identificador > ID de dispositivo é igual**. > [!TIP] > Como obter o ID do seu dispositivo? > > Confira nosso [guia dedicado](/documentation/docs/pt-br/debug-get-device-id) para saber como obter o ID do seu dispositivo. > [!TIP] > Conte os destinatários antes de iniciar a campanha > > Ao lançar uma campanha, é uma boa prática usar o recurso **Calcular destinatários** para contar os destinatários e garantir que o público-alvo dessa campanha seja o que você espera. Depois de iniciar a campanha, e para testá-la, você precisará voltar ao seu app e iniciar o evento novamente. A mensagem dentro do app deve aparecer imediatamente após você iniciar o evento. > [!NOTE] > Solução de problemas: Logs de depuração > > Você pode usar logs de depuração para revisar problemas. Veja nosso [guia](/documentation/docs/pt-br/debug-logs) dedicado para instruções sobre como habilitar logs de depuração.