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

# Introdução

> Escreva a mensagem uma vez e dispare em até sete canais com variáveis que personalizam cada envio.

<Tip>
  Template é a **carta pronta** da sua operação: você monta **uma vez**, usa `{{name}}`, `{{pedido}}` e dispara em SMS, WhatsApp, e-mail e outros canais na mesma chamada.
</Tip>

## O que é Template na Notifique?

É o modelo **multicanal** do workspace: um único registro com blocos por canal (`sms`, `whatsapp`, `email`, etc.). Na hora do envio, a Notifique **mescla** variáveis, valida escopos e créditos, e enfileira cada canal pedido.

Você pode:

* **Criar e editar** templates no painel ou API (`templates:*`)
* **Disparar** para até **100** destinatários por chamada (`POST /v1/templates/send`)
* **Personalizar** com `{{chave}}`, dados do contato e `variableDefaults`
* **Traduzir** por idioma (`localeTranslations`) quando o contato tem preferência
* **Combinar** canais livres (SMS, e-mail…) com **WhatsApp oficial** sincronizado com a Meta

Pense numa pasta com versões da mesma mensagem, uma para cada canal, que você envia todas de uma vez.

<Info>
  **Instagram** e **Widget (chat no site)** existem na plataforma, mas **não** entram em templates. Use a API de cada canal para esses casos.
</Info>

## Canais suportados

* **WhatsApp**, telefone E.164 (`whatsapp`)
* **SMS**, telefone E.164 (`sms`)
* **Telegram**, `chat_id` ou `@username` (`telegram`)
* **E-mail**, endereço de e-mail (`email`)
* **RCS**, telefone E.164 (`rcs`)
* **Push**, ID do dispositivo (`push`)
* **Voz**, telefone E.164 com `+` (`voice`)

Cada template liga **1 a 7** canais. No envio, `channels` deve ser **subconjunto** dos canais habilitados no template.

## Quando usar?

Funciona muito bem para **confirmação multicanal**, **campanhas recorrentes** e **mensagens personalizadas** com variáveis. Para um **único** envio pontual em **um** canal, pode mandar direto na API do canal (SMS, e-mail, etc.) sem criar template.

## Como funciona na prática

1. **Crie o template**, ligue só os canais necessários
2. **Escreva** cada bloco com `{{chave}}` e valores padrão se quiser
3. **Dispare** com `template`, `channels`, `to` e `variables`
4. A API responde **202** com IDs por canal (`messageIds`, `smsIds`, `emailIds`, …)
5. **Entrega** de cada canal → webhooks do **canal** (`message.*`, `sms.*`, …)
6. **Aprovação Meta** do WhatsApp oficial → webhooks **`template.*`** (veja abaixo)

<Note>
  Cada envio gasta **créditos por destinatário e por canal**. Se não houver saldo para toda a requisição, **nada** é enviado (`INSUFFICIENT_CREDITS`).
</Note>

***

## WhatsApp oficial e a Meta

Esta é a parte que liga templates **internos** do Notifique ao catálogo **oficial** da Meta (Cloud API).

### Dois tipos de template WhatsApp

|               | **Interno** (`ZENVIO`)                  | **Oficial** (`WHATSAPP_OFFICIAL`)                    |
| ------------- | --------------------------------------- | ---------------------------------------------------- |
| Onde vive     | Só no workspace                         | Na **WABA** da Meta **e** no Notifique               |
| Linha típica  | WhatsApp **não oficial** (QR)           | WhatsApp **oficial** (Embedded Signup)               |
| Aprovação     | Imediata no Notifique                   | Meta: `PENDING` → `APPROVED` / `REJECTED`            |
| Conteúdo WA   | Texto e imagem simples                  | Cabeçalho, rodapé, botões, carrossel (conforme Meta) |
| Outros canais | SMS, e-mail, etc. no **mesmo** template | SMS, e-mail, etc. **continuam** no mesmo template    |

Na **linha oficial**, fora da janela de **24h** após resposta do cliente, só entra mensagem com template **aprovado** pela Meta. Na linha não oficial, isso não se aplica.

### Sincronização com os servidores da Meta

Você não precisa duplicar tudo por canal. O fluxo usual:

1. **Criar interno** no Notifique (SMS + e-mail + bloco WhatsApp)
2. **Trazer da Meta**, sincronizar catálogo já aprovado na WABA
3. **Vincular** o bloco WhatsApp do interno a um modelo existente na Meta, **ou**
4. **Publicar** o interno na Meta e **aguardar aprovação**

O nome interno (`alerta_pedido`) pode ser diferente do **`metaName`** na Meta (`order_update`). No envio oficial, a Meta usa o modelo **aprovado** no catálogo dela.

Vários números **oficiais** na mesma conta Business **compartilham** o mesmo catálogo de templates.

Guia completo (sync, vínculo, publicação, status, erros): **[Templates oficiais Meta](/template-api/como-funciona/templates-oficiais-meta)**.

### Status de aprovação

Acompanhe no painel ou via webhook:

| Status     | Significado                         |
| ---------- | ----------------------------------- |
| `PENDING`  | Meta analisando                     |
| `APPROVED` | Pode enviar na linha oficial        |
| `REJECTED` | Recusado, ajuste e publique de novo |
| `PAUSED`   | Pausado por qualidade               |

Eventos: **`template.submitted`**, **`template.status_changed`**, **`template.category_changed`**. Detalhes: [Eventos dos webhooks](/template-api/como-funciona/eventos-do-webhooks).

<Warning>
  Editar só no Notifique **sem** espelhar na Meta **não** muda o que o cliente vê no WhatsApp oficial. O texto entregue vem da **definição aprovada na Meta**.
</Warning>

***

## O que você encontra no painel

* Biblioteca de templates com **detecção de variáveis**
* **Valores padrão** e traduções por idioma
* Badge **Meta** e status colorido em templates oficiais
* **Sincronizar templates com a Meta** na instância oficial
* Padrões de workspace: instância WhatsApp, domínio de e-mail, app Push, número de voz

## O que você encontra na API

* **Gestão:** `templates:read`, `templates:create`, `templates:update`, `templates:delete`
* **Envio:** escopo de **cada** canal em `channels` (`whatsapp:send`, `sms:send`, …)
* Detalhes na **referência da API** na aba Templates

## Próximos passos

* [Quick Start](/template-api/como-funciona/quick-start): criar e disparar
* [Templates oficiais Meta](/template-api/como-funciona/templates-oficiais-meta): sync, vínculo e aprovação
* [Escopos da API Key](/template-api/como-funciona/escopos-da-api-key): gestão e envio
* [Eventos dos webhooks](/template-api/como-funciona/eventos-do-webhooks): `template.*` da Meta
* [Variáveis e CRUD](/template-api/como-funciona/variaveis-disponiveis-e-crud): payloads por canal