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

# Ações de clique em mensagens no aplicativo

> Configure ações de clique em elementos de mensagens no aplicativo para abrir URLs, solicitar permissões de push ou localização, rastrear outcomes, adicionar tags a usuários ou acionar lógica personalizada.

As ações de clique são eventos interativos que você adiciona a elementos de uma mensagem no aplicativo — botões, imagens ou planos de fundo. Adicione-os usando o editor de arrastar e soltar ou o editor HTML via [API JavaScript de mensagens no aplicativo](./in-app-message-api).

<Frame caption="Fluxo de ação de clique mostrando prompts de permissão de localização e push no iOS">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/iam/a800e8b-Click_Action.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=3aa66c522aa9ed079e096e3386c2bff9" alt="Diagrama mostrando como as ações de clique em mensagens no aplicativo acionam prompts de permissão de localização e push no iOS" width="2574" height="1244" data-path="images/iam/a800e8b-Click_Action.png" />
</Frame>

## Tipos de ação de clique

### URL

Abre a URL especificada no navegador padrão do dispositivo. Mapeia para `openUrl` na [API JS de mensagens no aplicativo](./in-app-message-api). Para deep linking dentro do aplicativo, use um **Custom Action ID**.

### Push permission prompt

Exibe o prompt de permissão de push nativo do iOS ou Android. Se o dispositivo já estiver inscrito, a mensagem no aplicativo não será exibida. Se o dispositivo foi solicitado anteriormente e recusou, um alerta nativo pede ao usuário para habilitar notificações push nas configurações do aplicativo. Mapeia para `triggerPushPrompt` na [API JS de mensagens no aplicativo](./in-app-message-api).

### Location permission prompt

Exibe o prompt nativo do sistema operacional para solicitar permissão de rastreamento de localização. Seu aplicativo deve incluir [permissões de rastreamento de localização](./mobile-sdk-reference#location) — consulte [Location Opt-In Prompt](./location-opt-in-prompt) para configuração. Mapeia para `triggerLocationPrompt` na [API JS de mensagens no aplicativo](./in-app-message-api).

### Send outcome

Rastreia uma interação do usuário para fins de análise. Outcomes enviados por mensagens no aplicativo aparecem como "Unattributed" e definem uma [tag](./add-user-data-tags) no usuário no formato `outcome_name : true`. Consulte [Custom Outcomes](./custom-outcomes) para mais detalhes. Mapeia para `sendOutcome` na [API JS de mensagens no aplicativo](./in-app-message-api).

### Tag user

Adiciona uma [tag](./add-user-data-tags) ao usuário com base em sua resposta, que você pode usar para segmentá-lo em mensagens mais direcionadas. Mapeia para `tagUser` na [API JS de mensagens no aplicativo](./in-app-message-api).

### Custom action ID

Passa um valor personalizado que seu aplicativo lê através do [SDK IAM Click Listener](./mobile-sdk-reference#addclicklistener-in-app) quando o elemento é clicado. Use isso para:

* Enviar dados de interação para seu próprio servidor ou fornecedor de análise.
* [Deep linking dentro do aplicativo](./deep-linking) para navegar até telas específicas.

Mapeia para `addClickName` na [API JS de mensagens no aplicativo](./in-app-message-api).

#### Collecting custom click actions

Defina um **Custom Action ID** em qualquer bloco de imagem ou botão para identificar qual elemento foi clicado. Seu aplicativo detecta o clique através do [SDK IAM Click Listener](./mobile-sdk-reference#addclicklistener-in-app) e pode enviar os dados para seu servidor, banco de dados ou fornecedor de análise.

<Accordion title="Example: create a poll" icon="square-poll-vertical">
  Defina um Action ID único em cada botão de uma mensagem no aplicativo de múltipla escolha. Quando um usuário clica em uma opção, seu aplicativo a detecta através do [SDK IAM Click Listener](./mobile-sdk-reference#addclicklistener-in-app), envia a resposta ao seu servidor e pode exibir os resultados agregados ao usuário posteriormente.

  Em vez de um Action ID, você também pode usar uma **Tag** para identificar o elemento clicado e segmentar usuários com base em sua resposta.
</Accordion>

***

## Guias relacionados

<Columns cols={2}>
  <Card title="Deep Linking" icon="link" href="./deep-linking">
    Configure esquemas de URL personalizados e roteamento específico do aplicativo para mensagens push e no aplicativo.
  </Card>

  <Card title="In-app JavaScript API" icon="code" href="./in-app-message-api">
    Referência dos métodos de ação de clique no editor de mensagens no aplicativo em HTML.
  </Card>

  <Card title="App Store rating example" icon="star" href="./example-app-store-review">
    Tutorial passo a passo para solicitar avaliações da app store a partir de mensagens no aplicativo.
  </Card>

  <Card title="Target outdated app versions" icon="rotate" href="./app-version-update">
    Solicite que os usuários atualizem seu aplicativo.
  </Card>

  <Card title="Onboard users with banner in-app messages" icon="hand-wave" href="./example-create-a-tutorial">
    Oriente os usuários com mensagens no aplicativo contextuais de banner superior e inferior que não bloqueiam a interface do seu aplicativo.
  </Card>
</Columns>

***

## FAQ

### Posso adicionar múltiplas ações de clique a um único elemento?

Não. Cada elemento (botão, imagem ou plano de fundo) suporta uma ação de clique. Para acionar múltiplos comportamentos, use um **Custom Action ID** e gerencie a lógica no seu aplicativo através do [SDK IAM Click Listener](./mobile-sdk-reference#addclicklistener-in-app).

### Como faço deep link para uma tela no meu aplicativo?

Use a ação de clique **Custom Action ID** e gerencie o roteamento no seu aplicativo via [SDK IAM Click Listener](./mobile-sdk-reference#addclicklistener-in-app). A ação **URL** abre links no navegador, não dentro do aplicativo. Consulte [Deep Linking](./deep-linking) para a configuração completa.

### Por que o prompt de permissão de push não aparece?

Se o dispositivo já estiver inscrito em notificações push, a mensagem no aplicativo com uma ação de clique de prompt de permissão de push não será exibida. Verifique o status de inscrição de push do usuário no painel do OneSignal antes de testar.
