> ## 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.

# Solicitar permissões de localização com mensagens in-app

> Oriente usuários a habilitar rastreamento de localização em seu aplicativo mobile usando um soft pre-prompt no OneSignal antes de acionar a solicitação de permissão de localização nativa do Android ou iOS.

Solicite facilmente acesso à localização dos usuários usando uma mensagem in-app do OneSignal como um soft pre-prompt antes de mostrar o diálogo de permissão de localização nativo do sistema. Isso melhora as taxas de adesão e dá mais controle sobre quando e como perguntar. Alternativamente, você pode acionar diretamente o prompt do sistema usando nossos [métodos de localização do SDK Mobile](./mobile-sdk-reference#location).

***

## Requisitos

Antes de criar sua mensagem in-app:

* Adicione permissões de rastreamento de localização ao seu aplicativo (para Android e iOS).
  * Consulte nossa [referência de localização do SDK Mobile](./mobile-sdk-reference#location) para instruções de configuração específicas da plataforma.
* Habilite o compartilhamento de localização com o OneSignal no código do seu aplicativo.

***

## Criar sua mensagem

<Steps>
  <Step title="Criar sua mensagem">
    No painel do OneSignal, vá para: **Messages > In-App > New In-App**
  </Step>

  <Step title="Público">
    * Se todos os usuários devem ver o prompt, selecione **Show to all users**.
    * Caso contrário, direcione um Segmento específico.
  </Step>

  <Step title="Design da mensagem">
    * Explique claramente por que o acesso à localização beneficia o usuário. Por exemplo, "Habilite a localização para receber atualizações locais relevantes."
    * Seja conciso mas específico para aumentar a probabilidade de adesão.

    <Frame caption="Imagem mostrando blocos in-app e capacidade de adicionar ações de clique junto com visualização">
      <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/d79589d-iam-setup.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=dfc599957a14fae1da44feaca697cc8d" width="1922" height="1650" data-path="images/docs/d79589d-iam-setup.png" />
    </Frame>
  </Step>
</Steps>

***

## Adicionar a Ação de Clique de Prompt de Permissão de Localização

<Steps>
  <Step title="Adicionar um botão ou imagem">
    Adicione um botão ou imagem com uma chamada para ação clara (por exemplo, "Habilitar Localização").
  </Step>

  <Step title="Adicionar uma ação de clique">
    Nas opções:

    * Clique em **Add Click Action**
    * Selecione **Location Permission Prompt**

    Quando clicado, o OneSignal acionará o prompt de localização nativo do sistema.

    **Se a localização já estiver habilitada, a mensagem não será mostrada para evitar prompts desnecessários.**

    <Info>
      Tanto Android quanto iOS limitam a frequência com que prompts do sistema podem aparecer. Usar este soft pre-prompt ajuda a evitar essas limitações e permite tentativas repetidas se necessário.
    </Info>

    <Frame caption="Imagem mostrando blocos in-app e capacidade de adicionar ações de clique">
      <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/3ee94da-iam-setup-add-buttons.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=bea5041690d177a6b2c74b970bac178d" width="561" height="767" data-path="images/docs/3ee94da-iam-setup-add-buttons.png" />
    </Frame>
  </Step>
</Steps>

***

## Acionar a mensagem in-app

Você pode controlar quando e como o prompt é mostrado.

### Opção 1: Acionadores baseados em tempo

Mostre a mensagem depois que um usuário esteve no aplicativo por um período definido (por exemplo, após 30 segundos).

<Frame caption="Imagem mostrando acionador in-app de sessão.">
  <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/fb26c9cc44f0ff633869613177c204987850f8a45de908f153387b6c18211e3d-Screenshot_2025-04-03_at_6.34.31_PM.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=aa5c748b14350c0c35165194daf0b567" width="1566" height="688" data-path="images/docs/fb26c9cc44f0ff633869613177c204987850f8a45de908f153387b6c18211e3d-Screenshot_2025-04-03_at_6.34.31_PM.png" />
</Frame>

### Opção 2: Acionadores programáticos

Controle exatamente quando o prompt aparece via SDK:

<Steps>
  <Step title="Adicionar o código de acionador ao aplicativo.">
    Use o [método `addTrigger`](./mobile-sdk-reference#in-app-messages) do nosso SDK para definir uma chave como `location_prompt` e valor como `true`. Então chame isso quando quiser dentro do seu aplicativo.
  </Step>

  <Step title="Adicionar o acionador à mensagem">
    Defina a mesma chave de acionador (`location_prompt`) e valor (`true`) nas configurações da sua mensagem in-app.

    <Frame caption="Imagem mostrando acionador In-app programático.">
      <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/a1073246e17c826da317ef34f1fb4b4171e924a2de9f199cef9c154a0470c9aa-Screenshot_2025-04-03_at_6.35.33_PM.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=aa22c76661dc1cbf6ddac693fd471a1a" width="1566" height="742" data-path="images/docs/a1073246e17c826da317ef34f1fb4b4171e924a2de9f199cef9c154a0470c9aa-Screenshot_2025-04-03_at_6.35.33_PM.png" />
    </Frame>
  </Step>
</Steps>

***

## Definir a frequência da mensagem

Para evitar enviar spam aos usuários:

* Escolha **Multiple times**
* Defina um número de vezes para mostrar a mensagem
* Defina um intervalo entre cada tentativa

Exemplo de configuração: mostrar até 5 vezes, com um intervalo de 4 semanas entre cada tentativa

Isso permite lembretes mensais por até 5 meses, alcançando um equilíbrio entre persistência e experiência do usuário.

<Frame caption="Exemplo de configuração de agendamento para prompts repetidos.">
  <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/9e87626b6069826d65baa160acf278f9ada4724ea1a4155b63a2bd3be9e1fc64-Screenshot_2025-04-03_at_7.02.24_PM.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=00f77c150cdb1f667aef561d09cd5998" width="1566" height="722" data-path="images/docs/9e87626b6069826d65baa160acf278f9ada4724ea1a4155b63a2bd3be9e1fc64-Screenshot_2025-04-03_at_7.02.24_PM.png" />
</Frame>

***

## Melhores Práticas

* Sempre explique o benefício do acesso à localização aos usuários.
* Use segmentação ou acionadores para evitar perguntar em um momento ruim.
* Pre-prompts aumentam as taxas de adesão e evitam limites do sistema operacional.
* Garanta que as permissões de localização estejam configuradas corretamente em seu aplicativo antes de acionar a mensagem in-app.

***

<Check>
  Você começará a ver pontos de localização sendo rastreados em suas páginas de Usuários e Assinaturas.

  Crie [mensagens acionadas por localização](./location-triggered-event).
</Check>

***