Pular para o conteúdo principal
A personalização permite que você envie mensagens que incluem dados dinâmicos — como o nome do usuário, itens do carrinho, saldo da conta, detalhes de reserva ou uma senha de uso único. Este guia ajuda você a escolher o método de personalização correto com base em:
  • Onde seus dados estão armazenados
  • Se eles devem persistir
  • Como a mensagem é acionada

​
Como funciona a personalização

A personalização no OneSignal tem duas partes:
  1. Sintaxe Liquid – define como os valores são renderizados na sua mensagem
  2. Uma fonte de dados – determina de onde o valor vem
No momento do envio, o OneSignal resolve suas variáveis Liquid usando a fonte de dados selecionada.
Liquid controla a formatação e a lógica (variáveis, loops, condicionais). A fonte de dados determina quais valores estão disponíveis.
Exemplo:
Liquid
Hi {{ user.tags.first_name }},

Your verification code is {{ message.custom_data.otp }}.
  • user.tags.first_name é uma property armazenada
  • message.custom_data.otp é passado pelo campo custom_data da API

​
Comparação de fontes de dados

Se você precisa…
  • Reutilizar dados armazenados do usuário → Properties
  • Personalizar dentro de uma Journey com base em comportamento → Custom Events
  • Enviar valores de uso único ou sensíveis → API custom_data
  • Buscar dados em tempo real do backend na entrega → Data Feeds
  • Fazer upload de personalização em massa pelo painel → Dynamic Content CSV
Erros comuns a evitar
  • Usar Properties (Tags) para valores de uso único como OTPs ou códigos de verificação
  • Esperar que custom_data esteja disponível em Journeys ou mensagens futuras
  • Presumir que propriedades de Custom Events estão disponíveis fora da entrada de Journey acionada por evento ou de um passo Wait Until
  • Usar Data Feeds para dados estáticos que raramente mudam

​
Fontes de dados

​
Data feeds

Data Feeds chamam sua API no momento do envio e injetam a resposta na sua mensagem. Quando usar Data Feeds:
  • Você precisa do valor mais recente na entrega
  • Os dados estão no seu backend
  • O valor pode mudar entre envios

Data feeds

Obtenha dados em tempo real do backend nas mensagens no momento do envio.

​
Custom Events

Custom Events podem personalizar mensagens dentro de Journeys usando propriedades de eventos. Quando um evento inicia uma Journey ou corresponde a uma condição Wait Until, o OneSignal armazena esse evento para que suas propriedades possam ser referenciadas em templates de mensagem usando Liquid. Quando usar Custom Events:
  • Mensagens acionadas por eventos com Journeys
  • A mensagem deve refletir dados específicos do evento
Apenas eventos que acionam a entrada na Journey ou um passo Wait Until são armazenados para personalização. Eventos enviados fora desses momentos não estão disponíveis para mensagens de Journey.

Personalização com Custom Events

Guia completo para usar propriedades de eventos em Journeys.

​
Properties

Properties incluem tags de usuário, External ID, dados de subscription e campos no nível do app. Elas são: Use Properties quando:
  • O valor existe no OneSignal
  • O valor é persistente
  • Você o reutiliza em campanhas

Personalizar com Properties

Aprenda como referenciar dados persistentes armazenados como properties.

​
API custom_data

O campo custom_data na API Create Message permite que você envie valores específicos por mensagem a partir do seu backend. Esses dados:
  • Existem apenas para a requisição atual
  • Não são armazenados no OneSignal
  • Não estão disponíveis em Journeys
Use custom_data quando:
  • Enviar valores de uso único ou sensíveis (OTP, links seguros)
  • Passar arrays (itens do carrinho, linhas de pedido, pontuações de ranking)
  • Enviar mensagens transacionais ou acionadas por API

Personalizar com API custom_data

Aprenda como passar dados transitórios de personalização.

​
Dynamic Content CSV

Faça upload de um arquivo CSV no painel do OneSignal e referencie seus valores usando Liquid. Use CSV quando:
  • Personalizar diferentes seções de uma campanha em massa para cada destinatário
  • Traduções ou dados personalizados para cada destinatário são exportáveis para um arquivo CSV
  • Você não quer usar a API

Dynamic Content CSV

Personalize campanhas pelo painel usando uploads de CSV.

​
Guias detalhados

Use os guias abaixo para detalhes de implementação passo a passo e exemplos avançados.

Usando sintaxe Liquid

Aprenda como inserir dados dinâmicos em mensagens usando Liquid. Abrange variáveis, condicionais, loops, filtros, formatação e padrões comuns de personalização.

Data feeds

Obtenha dados em tempo real de suas próprias APIs no momento do envio. Use Data Feeds quando o conteúdo da mensagem depende de valores do backend em tempo real, como saldos, disponibilidade ou preços.

Personalização com Custom Events

Personalize mensagens de Journey usando propriedades de eventos capturadas quando os usuários entram ou avançam em uma Journey. Ideal para fluxos de trabalho comportamentais e orientados por eventos.

Properties & Tags

Use properties armazenadas de usuários, subscriptions, mensagens e apps para personalizar conteúdo em mensagens, templates, Journey webhooks e Event Streams.

API custom_data

Passe dados por mensagem e transitórios do seu backend usando a API Create Message. Ideal para OTPs, carrinhos, arrays e personalização transacional em massa.

Dynamic Content CSV

Faça upload de arquivos CSV no painel para personalizar campanhas em escala. Cada linha é mapeada para um destinatário e pode ser referenciada usando Liquid.

​
Tutoriais

Estes guias mostram como implementar personalização na prática.

Verificação, Magic Link e OTP

Envie mensagens de verificação seguras usando senhas de uso único, magic links ou URLs personalizadas com personalização orientada por API.

Journey de carrinho abandonado

Crie uma Journey automatizada que detecta atividade de carrinho, aguarda inatividade, envia um lembrete personalizado e finaliza a jornada do usuário imediatamente após a compra.

Confirmações de reserva

Envie mensagens de confirmação e recuperação de reservas usando Custom Events, Journeys e Data Feeds com base no status da reserva em tempo real.

Mensagens transacionais

Aprenda como enviar recibos, alertas, confirmações e outras mensagens transacionais em diversos canais usando APIs e automação.

Exemplos de personalização in-app

Veja exemplos práticos de uso de tags e properties para personalizar mensagens in-app para diferentes usuários e segmentos.