> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ararahq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# O que é um template

> Template é a mensagem pré-aprovada pela Meta que você envia a qualquer momento, inclusive fora da janela de 24h.

Template é a mensagem **pré-aprovada pela Meta** que a empresa pode enviar a qualquer momento, inclusive para quem não escreveu nas últimas 24h. Fora da [janela de 24h](/concepts/24h-window), é a única forma de iniciar ou retomar a conversa.

Em documentação mais antiga você vai ver o nome **HSM** (Highly Structured Message). É a mesma coisa.

## Por que template existe

A Meta limita a comunicação iniciada pela empresa para conter spam. Antes de enviar, você declara o conteúdo, escolhe a categoria e passa pela revisão da Meta. Aprovado, o template pode ser enviado quantas vezes precisar, respeitando opt-out e os [limites do plano](/concepts/pricing).

## As 3 categorias

<CardGroup cols={3}>
  <Card title="UTILITY" icon="bell">
    Algo que o cliente espera receber: pedido confirmado, cobrança, lembrete de consulta.
  </Card>

  <Card title="MARKETING" icon="megaphone">
    Promoção, oferta, lançamento, reativação da base. Exige consentimento para marketing.
  </Card>

  <Card title="AUTHENTICATION" icon="key">
    Apenas código de verificação (OTP, 2FA).
  </Card>
</CardGroup>

Cada categoria tem uma tarifa Meta diferente, e MARKETING é a mais cara. Valores em [Preços](/concepts/pricing).

<Warning>
  A Meta pode reclassificar um template depois de aprovado (por exemplo, de UTILITY para MARKETING). A partir daí ele custa como a nova categoria, e a Arara avisa pelo webhook `template.category_changed`.
</Warning>

## Ciclo de vida

```
Você cria o template
     ↓
A Arara valida estrutura, variáveis e exemplos
     ↓
A Meta revisa
     ↓
Webhook template.updated com o novo status
     ↓
APPROVED: pode enviar        REJECTED: veja o motivo, corrija e crie de novo
```

Só envia quem está `APPROVED`. Os outros status (`PENDING`, `REJECTED`, `DISABLED` e `PAUSED`) recusam o envio com `422`.

Mesmo aprovado, um template pode ser **pausado** pela Meta quando recebe muito feedback negativo (bloqueios e denúncias). Enquanto estiver pausado, o envio responde `422 TEMPLATE_PAUSED`.

Todos os status, códigos de erro e o que fazer em cada caso estão no guia [Criar e aprovar um template](/templates/policy).

## Template ou mensagem dentro da janela

| Situação | O que você pode enviar |
| - | - |
| O cliente escreveu nas últimas 24h | Mensagem livre (texto, mídia, botões, localização) ou template |
| O cliente não escreveu nas últimas 24h | Somente template aprovado |
| Código de verificação (OTP) | Template de autenticação |

Enviar um template não abre a janela. Ela só abre quando o cliente responde.

## Como é um template

Um template tem corpo (obrigatório) e, opcionalmente, cabeçalho de texto ou mídia, rodapé e botões. Os trechos que mudam a cada envio são variáveis, como `{{1}}` e `{{2}}`:

```
Oi {{1}}, seu pedido {{2}} foi confirmado.
Total: R$ {{3}}.
```

Também existe o formato carrossel, com vários cards de mídia e botões.

## Onde criar

Você cria templates pelo [Dashboard](https://app.ararahq.com), pela API (`POST /v1/templates`) ou pelo [MCP](/mcp-server). Quem tem número conectado ainda pode partir da biblioteca de templates UTILITY da Meta, que já nascem aprovados.

## Próximos passos

<CardGroup cols={3}>
  <Card title="Criar e aprovar um template" icon="file-lines" href="/templates/policy">
    Variáveis, mídia, botões, o que reprova e como corrigir.
  </Card>

  <Card title="Janela de 24h" icon="clock" href="/concepts/24h-window">
    Quando você pode dispensar o template.
  </Card>

  <Card title="API: Templates" icon="code" href="/api-reference/templates">
    Todos os endpoints de templates.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.