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

# Templates

> Crie, envie e rastreie templates reutilizáveis para push notifications, email e SMS no OneSignal com personalização Liquid e métricas de desempenho agregadas.

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

<Card title="Template analytics" icon="chart-bar" href="./template-analytics">
  Revise estatísticas de entrega, métricas de engajamento e atividade por destinatário para cada template.
</Card>

***

## Criar templates

Templates podem ser criados de múltiplas formas:

<Columns cols={2}>
  <Card title="Dashboard" icon="browser">
    Vá para **Messages > Templates** e clique em **New Template**.
  </Card>

  <Card title="API" icon="code" href="/reference/create-template">
    Crie templates programaticamente usando a API Create Template.
  </Card>

  <Card title="Email Template Forwarding" icon="envelope" href="./email-template-forwarding">
    Migre templates de email de outra plataforma de email.
  </Card>

  <Card title="Copiar entre apps" icon="copy" href="/reference/copy-template-to-another-app">
    Copie templates entre apps OneSignal (cópia única, não uma sincronização ao vivo).
  </Card>
</Columns>

### Diretrizes de design

Templates suportam [sintaxe Liquid](./using-liquid-syntax) para [personalização avançada](./message-personalization), permitindo que você insira conteúdo dinâmico e específico do usuário.

Para melhores práticas específicas por canal, veja:

<Columns cols={2}>
  <Card title="Push Notification Design" icon="bell" href="./push">
    Design, recursos e opções de plataforma para notificações push.
  </Card>

  <Card title="SMS Messaging" icon="comment-sms" href="./sms-messaging">
    Design, recursos e requisitos de conformidade para SMS.
  </Card>

  <Card title="Email HTML Design" icon="code" href="./design-emails-with-html">
    Construa emails com controle total de HTML e CSS.
  </Card>

  <Card title="Email Drag and Drop Design" icon="pen-ruler" href="./design-emails-with-drag-and-drop">
    Construa emails visualmente com o editor de arrastar e soltar.
  </Card>
</Columns>

***

## 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](/reference/create-message).

<Note>
  Para modelos de SMS/RCS, você seleciona um remetente, e o editor exibido depende desse remetente: você obtém o editor de RCS quando o remetente tem um recurso de RCS e o editor de SMS caso contrário. Selecionar um remetente com um recurso de RCS aprovado faz com que o OneSignal prefira automaticamente o RCS para todas as automações existentes que usam esse remetente. Consulte [Atualizar automações existentes para RCS](./sms-composing-messages#upgrading-existing-automations-to-rcs) para saber como o conteúdo de SMS existente é mapeado para RCS.
</Note>

### Template ID

Each template has a unique OneSignal-generated `template_id` (UUID v4). You can find it:

* Using the [View Templates API](/reference/view-templates)
* In the OneSignal Dashboard under **Messages > Templates > Options > Copy Template ID**

<Frame caption="Copy Template ID">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/templates/copy-template-id.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=b1b94df3f7ad6cdc5dc985e5c2f7ffeb" alt="Copy Template ID in OneSignal Dashboard" width="2208" height="1038" data-path="images/dashboard/templates/copy-template-id.png" />
</Frame>

***

## Rastrear desempenho

A página **Templates** mostra desempenho agregado ao longo da vida útil em todos os envios usando o template.

| Coluna        | Descrição                                                                                                                            |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Name**      | O nome do template.                                                                                                                  |
| **Labels**    | [Labels](./labels) usados para agrupar e filtrar templates.                                                                          |
| **Type**      | Push, Email ou SMS.                                                                                                                  |
| **Last Sent** | A última data e hora em que o template foi usado em uma mensagem enviada.                                                            |
| **Delivered** | Total de entregas bem-sucedidas (para servidores push, caixas de entrada dos destinatários, ou operadoras SMS, dependendo do canal). |
| **Opened**    | Total de aberturas de email (incluindo aberturas repetidas). Não aplicável para push ou SMS.                                         |
| **Clicked**   | Total 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:

<Card title="Template analytics" icon="chart-bar" href="./template-analytics">
  Relatórios detalhados por template com métricas específicas por canal e dados de público exportáveis.
</Card>

***

## Atualizar templates

Você pode atualizar templates via:

* **Dashboard:** Vá para **Messages > Templates > Options > Edit**.
* **API:** Use a [API Update Template](/reference/update-template).

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](/reference/push-notification) com novo `content`, isso substituirá a mensagem do template apenas para aquele envio.

***

## Deletar templates

Você pode deletar templates via:

* **Dashboard:** Vá para **Messages > Templates > Options > Delete**.
* **API:** Use a [API Delete Template](/reference/delete-template).

<Warning>
  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.
</Warning>

***

## 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](./template-analytics) para detalhes.

### Posso duplicar templates entre apps?

Sim. Use a [API Copy Template to Another App](/reference/copy-template-to-another-app) para qualquer tipo de template. Para email especificamente, você também pode usar [Email Template Forwarding](./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](/reference/create-message) junto com o `template_id`. Os campos da API substituem os campos correspondentes do template apenas para aquele envio.

## Páginas relacionadas

<Columns cols={2}>
  <Card title="Personalização de mensagens" icon="user-pen" href="./message-personalization">
    Personalize templates com tags, sintaxe Liquid e propriedades de eventos personalizados.
  </Card>

  <Card title="Sintaxe Liquid" icon="code" href="./using-liquid-syntax">
    Referência completa para templates Liquid em mensagens OneSignal.
  </Card>

  <Card title="Journeys" icon="route" href="./journeys-overview">
    Use templates em fluxos de mensagens multicanal automatizados.
  </Card>

  <Card title="Labels" icon="tag" href="./labels">
    Organize e filtre templates com labels personalizados.
  </Card>
</Columns>