--- title: "Configurar Primer de Empurrar" slug: "configure-push-primer" updated: 2026-06-12T10:30:51Z published: 2026-06-12T10:30:51Z canonical: "docs.xtremepush.com/configure-push-primer" --- > ## 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. # Configurar Primer de Empurrar Configure os primeiros lançamentos usando campanhas independentes dentro do app. ## O que são Primers de Pressão Quando um usuário abre seu aplicativo pela primeira vez, recebe uma notificação push com permissão pedindo para permitir ou negar notificações. ![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/f7079b49f4cdaaada7bc4e10c4dd4cafa4831af596225ab10176144ee4bca83c-image_7.png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A59Z&se=2026-11-04T10%3A28%3A59Z&sr=c&sp=r&sig=wYSmCM%2FK97SL2vxkKqhl7f4sFRDCbQSihfnj9zhH4Ws%3D) Um push primer é uma mensagem personalizada dentro do app que aparece antes desse diálogo de notificações push, dando a você a oportunidade de explicar o valor das notificações para seus usuários. ![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/69529d3034b81dda17ce9f5d9b3d1715c459ff27c892063912e9cf76e86af458-Screenshot_2026-04-29_at_12.18.13.png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A59Z&se=2026-11-04T10%3A28%3A59Z&sr=c&sp=r&sig=wYSmCM%2FK97SL2vxkKqhl7f4sFRDCbQSihfnj9zhH4Ws%3D) > [!TIP] > Por que usar Primers de Pressão > > - Um push manual permite que você informe aos usuários o que eles receberão com notificações como promoções, atualizações de pedidos, placar ao vivo, antes que apareça o diálogo de permissão push. > - iOS e Android permitem cada um apenas um pedido nativo de permissão de notificação push por instalação de app. Se um usuário recusar, ele não poderá se inscrever nas notificações a menos que mude as configurações do dispositivo. ## Configure uma Campanha de Introdução ao Push > [!NOTE] > Montagem de Primeiros Personalizados para Empurrar > > Esta seção aborda como construir primers push sem escrever nenhum código. Se você quer controle total sobre o design do seu push primer, pode construir um usando uma campanha **HTML personalizada** dentro do app. Veja *Solicitar permissão de notificação push* em [Criar conteúdo HTML personalizado para campanhas dentro do](/documentation/docs/pt-br/in-app-custom-html) aplicativo para mais detalhes. Com o Xtremepush, você pode criar primários de push usando campanhas independentes dentro do app. Na campanha, você cria sua mensagem push primer e especifica o evento SDK que a desencadeia. Essas campanhas podem ser configuradas nos seguintes formatos de mensagem: - **Modal**: O primer de pressão é configurado em um botão dentro da mensagem. - **Banner**: O push primer fica definido no nível da mensagem, e ao tocar em qualquer lugar do banner, o diálogo de permissão push é ativado. - **Tela cheia**: O primer de pressão pode ser ajustado no nível da mensagem, em um botão ou em ambos. Para mais informações sobre como configurar campanhas Modais, Banners e Tela Cheia, veja [Modal In-App](/documentation/docs/pt-br/in-app-modal), [Banner In-App](/documentation/docs/pt-br/in-app-banner) e [Tela Cheia In-App](/documentation/docs/pt-br/in-app-full-screen). > [!TIP] > Você não precisa configurar uma opção de recuso no push primer, pois os usuários podem fechar a mensagem dentro do aplicativo. ## Configuração da Campanha Para configurar uma campanha push primer, faça o seguinte: 1. Clique **em Criar Campanha** e depois selecione **In-App / Onsite**. 2. Na aba **Configuração** , selecione o canal **In-App** . 3. Na aba **Conteúdo** , selecione o **Tipo** de mensagem no app e crie o conteúdo para o seu push introductor: - **Modal**: O primer de pressão pode ser adicionado como um botão. Quando um usuário clica nesse botão, a janela de permissão para empurrar é exibida. Configure este botão na aba **Formulário** : 1. No menu **suspenso de Ação** , selecione **Solicitar Permissão de Empurramento**. 2. Insira o rótulo do botão no campo **Texto** . 3. Deixe os menu suspensos **de Salvar** e **Disparar** como **Nenhum**. 4. Selecione a caixa de seleção do botão para visualizar o botão. O exemplo abaixo mostra um botão *Habilitar Notificações* adicionado a uma campanha modal. Quando um usuário clica, o diálogo de permissão push é exibido. ![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/a95d00a0f906a7fc6bb612b475436636c995365d9a7930238006875eef52a7e7-Screenshot_2026-04-30_at_10.05.23.png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A59Z&se=2026-11-04T10%3A28%3A59Z&sr=c&sp=r&sig=wYSmCM%2FK97SL2vxkKqhl7f4sFRDCbQSihfnj9zhH4Ws%3D) Exemplo de Primer de Empurrar Modal - **Banner**: Tocar em qualquer lugar do banner ativa o diálogo de permissão para empurrar. Para configurar isso, na aba **Retrato** , selecione **Solicitar Permissão de Push** no menu **suspenso de Ação** . ![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/44feaedfe111924a3a098a0e5faeb5e1e2c507df2c3a7f3e94003d61b055f4b8-Screenshot_2026-04-30_at_10.12.31.png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A59Z&se=2026-11-04T10%3A28%3A59Z&sr=c&sp=r&sig=wYSmCM%2FK97SL2vxkKqhl7f4sFRDCbQSihfnj9zhH4Ws%3D) Exemplo de Guia de Push de Banner - **Tela cheia**: Você pode configurar a ação de permissão push no nível da mensagem, em um botão, ou em ambos: - Nível da Mensagem: Tocar em qualquer lugar da mensagem em tela cheia ativa o diálogo de permissão para o push. Para configurar isso, na aba **Retrato** , selecione **Solicitar Permissão de Push** no menu **suspenso de Ação** . ![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/7d5826f3a83aebdb1e7aa6d041e59f6efd8253e1a51defd7799d1e7565538fb8-Screenshot_2026-04-30_at_10.26.44.png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A59Z&se=2026-11-04T10%3A28%3A59Z&sr=c&sp=r&sig=wYSmCM%2FK97SL2vxkKqhl7f4sFRDCbQSihfnj9zhH4Ws%3D) Exemplo de Primer de Push em tela cheia (Nível de Mensagem) - Botão: Tocar em um botão na mensagem em tela cheia ativa o diálogo de permissão por empurrão. Para configurar isso: 1. Na **aba Retrato** , clique **no botão Adicionar** 2. No menu **suspenso de Ação** , selecione **Solicitar Permissão de Empurramento**. ![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/1aa7771ee40e7f609ea272a6b3eab4f3d628ee9117d04c7431d91e0f6f813bb3-Screenshot_2026-04-30_at_10.28.06.png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A59Z&se=2026-11-04T10%3A28%3A59Z&sr=c&sp=r&sig=wYSmCM%2FK97SL2vxkKqhl7f4sFRDCbQSihfnj9zhH4Ws%3D) Exemplo de Primer de Pressão em Tela Inteira (Botão) 1. Insira o rótulo do botão no campo **Texto** 2. Deixe os menu suspensos **de Salvar** e **Disparar** como **Nenhum**. O exemplo a seguir mostra um botão configurado para solicitar permissão de inserção em uma campanha em tela cheia. 4. Na **aba Trigger** , selecione o evento do SDK que vai acionar a mensagem push primer. 5. Antes de iniciar sua campanha, veja [abaixo Desencadear o Evento Push Primer](/docs/pt-br/configure-push-primer#triggering-thepush-primer-event) . Uma vez que sua campanha está ativa, quando um usuário aciona o evento SDK, aparece a mensagem push principal. Usuários que já concederam permissão para notificação push não verão o manual. ## Acionando o Evento de Primer de Empurrar Antes de enviar o evento que aciona sua campanha push primer, verifique se os usuários são elegíveis para receber o prompt de notificação. Você pode fazer isso usando `canRequestNotificationPermission`. Se esse método retornar `true`, você pode prosseguir para enviar o evento e o push primer é exibido. Isso garante que o evento só seja enviado quando o diálogo de permissão de notificação push for exibido ao usuário. **Java** ```java // Check if the user is eligible to receive the notification prompt. if (mPushConnector.canRequestNotificationPermission(this)) {    // Trigger the in-app campaign.    mPushConnector.hitEvent("inapp-primer", ""); } ``` **Objective-C** ```objectivec // Before showing your in-app push primer, check whether iOS will allow a permission prompt. // If permission has already been granted/denied, iOS will not show the system prompt again. [XPush canRequestNotificationPermission:^(BOOL canRequest) {    if (canRequest) {        // Trigger your Xtremepush in-app campaign via an event.        [XPush hitEvent:@"inapp-primer"];    } }]; ``` **Swift** ```swift XPush.canRequestNotificationPermission { canRequest in    if canRequest {        // Trigger your in-app "push primer" campaign via an event        XPush.hitEvent("inapp-primer")    } } ``` > [!TIP] > O nome do evento "inapp-primer" usado nos exemplos pode ser qualquer string, só precisa corresponder ao evento de gatilho configurado na etapa 4 da configuração da campanha acima.