---
title: "Gatilhos de eventos"
slug: "campaign-events"
status: "new"
updated: 2026-06-11T13:11:35Z
published: 2026-06-12T10:31:00Z
canonical: "docs.xtremepush.com/campaign-events"
---

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

# Gatilhos de eventos

Ajuste como sua campanha será desencadeada por um evento

Esta página descreve como definir gatilhos para campanhas de uma ou várias etapas desencadeadas por eventos. Para ver como definir gatilhos para campanhas **no aplicativo / no local** , veja [Definir gatilhos para campanhas no aplicativo e no local](/documentation/docs/pt-br/set-triggers-for-in-app-and-on-site-campaigns).

A **aba Triggers** é onde você especifica as regras e o comportamento do gatilho do evento para sua campanha de uma ou várias etapas.

Os dados de eventos podem ser passados de:

- [Aplicativo Android](/documentation/docs/pt-br/android-integration)
- [Aplicação iOS](/documentation/docs/pt-br/ios-integration)
- [Site](/documentation/docs/pt-br/website-integration)
- [API externa](/ref:api-event)
- Vários eventos automáticos do [sistema](/documentation/docs/pt-br/system-events) disparados pela própria plataforma; por exemplo `application_install`, , `session_start`, `profile_create` e `preference_trigger`. Consulte o guia dedicado para detalhes completos e documentação da carga útil.

Saiba mais sobre [eventos em tempo real](/documentation/docs/pt-br/real-time-events) em nosso guia dedicado.

## Evento selecionado

Na seção **de Gatilhos** , você pode selecionar o evento que vai acionar a notificação. Eventos que foram criados manualmente anteriormente pelo **Data > Data Manager > Events** ou executados pelo seu site, aplicativo ou via API externa pelo menos uma vez aparecerão no menu suspenso.

## Limitar o gatilho em alguns eventos

Quando essa caixa de seleção é selecionada, as visitas ao evento selecionado só disparam a notificação quando condições adicionais de filtragem forem cumpridas.

Condições podem ser definidas em relação a valores de eventos ou propriedades de eventos aninhadas. Um valor de evento corresponde a uma string (um valor simples como `homepage`), então essa condição de filtragem poderá realizar avaliações em relação a esse valor (por exemplo, se algo é igual ou não igual a esse valor).

Uma propriedade de evento é um valor complexo, expresso com um objeto JSON, como mostrado no exemplo a seguir:

```json
{
   "order_no": "ABC123",
   "order_date": "2021-03-14",
   "price": 304.67,
   "quantity": 5
}
```

Filtrar com base nas **propriedades do evento** permite realizar avaliações em relação às informações contidas nesse objeto (por exemplo, que essa propriedade contém um valor específico).

## Envie com atraso

Selecione esta caixa se quiser enviar a mensagem com atraso após o evento ser atingido.

> [!TIP]
> A segmentação de campanha é avaliada quando a campanha é enviada, e não quando o evento é disparado. Quando um atraso é usado, isso significa que a segmentação é aplicada após o atraso ter passado, permitindo que as informações mais recentes e atualizadas disponíveis no sistema sejam utilizadas.

## Limites das mensagens

Esta seção permite estabelecer limites para o número de vezes que uma notificação será exibida.

- Número máximo de gatilhos: O limite de notificações de usuário/dispositivo é o número máximo de notificações que um *usuário* ou *dispositivo* pode receber, seja **por dia** ou **por campanha**. Se eles continuarem a visitar um evento, não receberão mais notificações do que o especificado.
- Número de eventos antes do primeiro gatilho: define o número de vezes **por dia** ou **por campanha** que um evento deve ser atingido antes que o *usuário* ou *dispositivo* receba uma notificação (no caso de campanhas de estágio único) ou inscreva um fluxo de trabalho (no caso de campanhas de múltiplas etapas).

> [!NOTE]
> Períodos de tempo dos limites
> 
> Limites de mensagens verificam o carimbo de data do envio anterior, não o dia do calendário, semana ou mês. Por exemplo, se você tem um limite de 5 mensagens por semana e envia todas as 5 em um domingo, não poderá enviar mais nenhuma na segunda-feira. Você precisará esperar até o domingo seguinte.

- Bloqueie a Reentrada durante a Jornada Ativa: Ative essa opção em campanhas multiestágio para evitar que perfis retornem à **jornada** enquanto ainda estão participando ativamente. Os usuários só podem reentrar após concluírem a jornada atual.

## Validação de Eventos no Lançamento da Campanha

Durante o lançamento da campanha, uma verificação de validação verifica se o evento de gatilho selecionado existe na plataforma Xtremepush.

Uma mensagem de aviso é exibida na janela de confirmação do lançamento, caso o evento, propriedade do evento ou valor de evento especificado não tenha sido registrado no Xtremepush no último ano. Isso ocorre por dois motivos:

- O nome do evento, propriedade do evento ou valor é escrito incorretamente. Para resolver isso, corrija o nome do evento na aba **Triggers** .
- O evento foi recentemente integrado ao seu aplicativo ou site e ainda não foi acionado por nenhum usuário. Nenhuma ação é necessária nesse caso, e você pode prosseguir com o lançamento da campanha.