Pular para o conteúdo principal
Templates são modelos reutilizáveis para notificações push, emails e mensagens SMS. Eles garantem mensagens consistentes e centralizam métricas de desempenho em todos os envios. Templates são especialmente úteis para mensagens enviadas frequentemente, acionadas por eventos ou transacionais.

Template analytics

Revise estatísticas de entrega, métricas de engajamento e atividade por destinatário para cada template.

​
Criar templates

Templates podem ser criados de múltiplas formas:

Dashboard

Vá para Messages > Templates e clique em New Template.

API

Crie templates programaticamente usando a API Create Template.

Email Template Forwarding

Migre templates de email de outra plataforma de email.

Copiar entre apps

Copie templates entre apps OneSignal (cópia única, não uma sincronização ao vivo).

​
Diretrizes de design

Templates suportam sintaxe Liquid para personalização avançada, permitindo que você insira conteúdo dinâmico e específico do usuário. Para melhores práticas específicas por canal, veja:

Push Notification Design

Design, recursos e opções de plataforma para notificações push.

SMS Messaging

Design, recursos e requisitos de conformidade para SMS.

Email HTML Design

Construa emails com controle total de HTML e CSS.

Email Drag and Drop Design

Construa emails visualmente com o editor de arrastar e soltar.

​
Enviar mensagens usando templates

Você pode enviar um template de múltiplas formas:
  • Da Tela de Composição: Ao criar uma nova mensagem no Dashboard, escolha começar de um template.
  • Da Página Templates: Vá para Messages > Templates, selecione Options (3 pontos) > New Message.
  • API: Inclua o template_id na sua solicitação de envio.

​
Template ID

Each template has a unique OneSignal-generated template_id (UUID v4). You can find it:
  • Using the View Templates API
  • In the OneSignal Dashboard under Messages > Templates > Options > Copy Template ID
Copy Template ID in OneSignal Dashboard

​
Rastrear desempenho

A página Templates mostra desempenho agregado ao longo da vida útil em todos os envios usando o template.
ColunaDescrição
NameO nome do template.
LabelsLabels usados para agrupar e filtrar templates.
TypePush, Email ou SMS.
Last SentA última data e hora em que o template foi usado em uma mensagem enviada.
DeliveredTotal de entregas bem-sucedidas (para servidores push, caixas de entrada dos destinatários, ou operadoras SMS, dependendo do canal).
OpenedTotal de aberturas de email (incluindo aberturas repetidas). Não aplicável para push ou SMS.
ClickedTotal de cliques na notificação ou em links dentro do email/SMS.
CTR(Clicked ÷ Delivered) × 100%.
Para estatísticas de entrega por envio, análises de engajamento e atividade de público:

Template analytics

Relatórios detalhados por template com métricas específicas por canal e dados de público exportáveis.

​
Atualizar templates

Você pode atualizar templates via: Atualizar um template não reseta suas estatísticas de desempenho. Novos links são rastreados e agregados junto com os dados existentes. Os campos do template podem ser substituídos por mensagem. Você pode usar um template como ponto de partida e atualizar o conteúdo antes de enviar. Por exemplo, se seu template push tem uma mensagem definida e você usa a API Create push com novo content, isso substituirá a mensagem do template apenas para aquele envio.

​
Deletar templates

Você pode deletar templates via:
Uma vez que o template é deletado, todos os dados associados a ele são deletados e não podem ser recuperados.Você não pode deletar templates usados dentro de um Journey. Delete o Journey ou remova o template do Journey.

​
FAQ

​
Por quanto tempo os dados de template são armazenados?

O conteúdo do template é armazenado durante toda a vida útil do template — até que você o delete. As análises agregadas na página Templates também são dados de vida útil. Análises individuais de nível de envio seguem a política de retenção do seu plano. Consulte Template analytics para detalhes.

​
Posso duplicar templates entre apps?

Sim. Use a API Copy Template to Another App para qualquer tipo de template. Para email especificamente, você também pode usar Email Template Forwarding.

​
Atualizar um template afeta mensagens passadas?

Não. Mensagens passadas retêm o conteúdo com que foram enviadas. Apenas envios futuros usam o template atualizado. Estatísticas de desempenho não são resetadas.

​
Posso usar o mesmo template para múltiplos canais?

Não. Cada template é vinculado a um único canal — push, email ou SMS. Crie templates separados para cada canal.

​
Posso substituir o conteúdo do template ao enviar via API?

Sim. Inclua campos como contents, headings ou email_body na sua solicitação Create message junto com o template_id. Os campos da API substituem os campos correspondentes do template apenas para aquele envio.

​
Páginas relacionadas

Personalização de mensagens

Personalize templates com tags, sintaxe Liquid e propriedades de eventos personalizados.

Sintaxe Liquid

Referência completa para templates Liquid em mensagens OneSignal.

Journeys

Use templates em fluxos de mensagens multicanal automatizados.

Labels

Organize e filtre templates com labels personalizados.