---
title: "Eventos do sistema"
slug: "system-events"
updated: 2026-06-12T10:30:57Z
published: 2026-06-12T10:30:57Z
canonical: "docs.xtremepush.com/system-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.

# Eventos do sistema

Eventos automáticos na plataforma que podem acionar campanhas sem integração personalizada

Eventos do sistema são eventos automáticos disparados pela plataforma Xtremepush, sem nenhum código personalizado de rastreamento de eventos no seu app ou site. Eles podem ser usados como gatilhos de campanha da mesma forma que eventos personalizados.

## application_install

Esse evento dispara a primeira vez que um perfil é criado como resultado da instalação e lançamento do seu aplicativo móvel por um dispositivo.

**Disponível para:** Campanhas de aplicativos móveis (iOS e Android)

**Casos de uso:**

- Notificação push de boas-vindas no primeiro lançamento
- Inscrição em campanhas de integração

> [!NOTE]
> Esse evento acontece uma vez por perfil, na primeira instalação. Reinstalações no mesmo dispositivo vinculadas a um perfil existente não reiniciam esse evento.

## session_start

Esse evento é ativado toda vez que um usuário abre seu aplicativo móvel e inicia uma nova sessão.

**Disponível para:** Campanhas dentro do aplicativo (apenas iOS e Android, não presencialmente)

**Casos de uso:**

- Campanha de reengajamento desencadeada após um período de inatividade
- Mensagem contextual dentro do app mostrada na abertura do app

> [!NOTE]
> `session_start` está disponível como um evento nomeado do sistema no seletor de gatilhos da campanha. Quando selecionado, ele contorna a verificação padrão de validação de eventos (que exige que o evento tenha sido registrado no último ano), já que nenhum registro de evento é armazenado no histórico de eventos para o início da sessão.

## profile_create

Esse evento é ativado quando um novo registro de perfil é criado no Xtremepush, normalmente via importação de perfil (CSV ou importação de API).

**Casos de uso:**

- E-mail ou SMS de boas-vindas acionados no momento da criação do perfil durante uma importação de dados
- Segmentação inicial ou campanha de entrada no ciclo de vida

> [!WARNING]
> `profile_create` é acionado por importações de perfil, não pela instalação de um aplicativo de dispositivo. Para o comportamento de instalação de aplicativos, use `application_install`. Nem todos os caminhos de criação de perfis ativam esse evento — ele está especificamente associado ao pipeline de importação.

## preference_trigger

Esse evento é ativado quando a [preferência de consentimento](/documentation/docs/pt-br/consent-preferences) de um perfil muda, por exemplo, quando um usuário opta por entrar ou não em uma preferência de marketing nomeada.

Este evento está disponível apenas em projetos que tenham as funções **de Preferências de Assinatura** e **Eventos de Preferência de Campanha por Consentimento** ativadas.

**Casos de uso:**

- Mensagem de confirmação quando um usuário opta por uma categoria específica de marketing
- Lógica de supressão ou reengajamento impulsionada por mudanças de preferência
- Fluxo de confirmação com duplo opt-in

### Carga útil de eventos

Diferentemente de outros eventos do sistema, `preference_trigger` carrega uma carga útil estruturada que pode ser usada para condições de filtro de eventos:

```json
{
  "user_id": "u123",
  "customer_id": "c456",
  "preferences": {
    "marketing": [
      {
        "preference_id": 1,
        "name": "marketing",
        "display_name": "Marketing Emails",
        "channel": "email",
        "status": 1,
        "timestamp": 1713100000,
        "source": "manual",
        "metadata": { "channel": "branch" }
      }
    ]
  }
}
```

| Campo | Descrição |
| --- | --- |
| `user_id` | O ID de usuário do perfil |
| `customer_id` | O ID do cliente do perfil (presente apenas se ativado no projeto) |
| `preferences` | Objeto chaveado pelo nome da preferência. Cada tecla mapeia para um array de registros de mudança de preferência |
| `preferences[name][].preference_id` | ID da definição de preferência por assinatura |
| `preferences[name][].name` | Nome de preferência (corresponde à tonalidade externa) |
| `preferences[name][].display_name` | Rótulo de preferência legível para humanos |
| `preferences[name][].channel` | Canalizar a preferência aplicada, por exemplo, `email`, `sms` |
| `preferences[name][].status` | `1` = participou, `0` = desistiu |
| `preferences[name][].timestamp` | Carimbo de data e hora do Unix de quando a mudança ocorreu |
| `preferences[name][].source` | Como a mudança foi feita: `manual`, `api`, `import`, etc. |
| `preferences[name][].metadata` | Metadados arbitrários opcionais anexados ao registro de preferência |

### Filtragem sobre carga útil de preferência

Quando o **disparo de Limite em alguns eventos** é ativado para uma `preference_trigger` campanha, as condições são avaliadas em relação às propriedades de preferência listadas acima. Por exemplo, você só pode acionar uma campanha quando `source` é `manual`igual a , ou somente quando `channel` é `email`igual a .

> [!NOTE]
> Múltiplas mudanças de preferência para o mesmo perfil são agrupadas em um único evento disparando com um pequeno atraso. Portanto, o `preferences` objeto pode conter mais de uma entrada de preferência por evento. Quando as condições de filtro de eventos são aplicadas, apenas as entradas de preferência que correspondem às condições são incluídas na carga útil passada para a campanha.

### Direcionar uma preferência específica

Uma `preference_trigger` campanha pode ser direcionada para uma preferência nomeada definindo o campo **do evento Trigger** para o nome da preferência. Configurá-lo como `0` (ou deixá-lo desconfigurado para "qualquer") acionará mudanças em qualquer preferência.