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

# Introducción

> Escribe una vez y envía hasta siete canales con variables que personalizan cada envío.

<Tip>
  Una plantilla es su **carta ya preparada**: constrúyala **una vez**, use `{{name}}`, `{{order}}` y envíela por SMS, WhatsApp, correo electrónico y más en una sola llamada.
</Tip>

## ¿Qué son las plantillas en Notifique?

Son el espacio de trabajo **modelo multicanal**: un registro con bloques por canal (`sms`, `whatsapp`, `email`, etc.). Al enviar, Notifique **fusiona** variables, valida alcances y créditos y pone en cola cada canal solicitado.

Puede:

* **Crear y editar** plantillas en el panel o API (`templates:*`)
* **Envío** a hasta **100** destinatarios por llamada (`POST /v1/templates/send`)
* **Personalizar** con `{{key}}`, datos de contacto y `variableDefaults`
* **Traducir** por configuración regional (`localeTranslations`) cuando el contacto tiene una preferencia de idioma
* **Combina** canales de formato libre (SMS, correo electrónico...) con **WhatsApp oficial** sincronizado con Meta

Piensa en una carpeta con versiones del mismo mensaje, una por canal, que envías todas a la vez.

<Info>
  **Instagram** y **Widget (chat del sitio)** existen en la plataforma, pero **no** admiten plantillas. Utilice la API de cada canal para esos casos.
</Info>

## Canales admitidos

* **WhatsApp**, teléfono E.164 (`whatsapp`)
* **SMS**, teléfono E.164 (`sms`)
* **Telegrama**, `chat_id` o `@username` (`telegram`)
* **Correo electrónico**, dirección de correo electrónico (`email`)
* **RCS**, teléfono E.164 (`rcs`)
* **Pulsar**, ID del dispositivo (`push`)
* **Voz**, teléfono E.164 con `+` (`voice`)

Cada plantilla habilita **1 a 7** canales. Al enviar, `channels` debe ser un **subconjunto** de canales habilitados.

## ¿Cuándo usarlos?

Excelente para **confirmación multicanal**, **campañas recurrentes** y mensajes **personalizados** con variables. Para un envío **único** en **un** canal, puedes llamar a la API de ese canal directamente (SMS, correo electrónico, etc.) sin una plantilla.

## Cómo funciona en la práctica

1. **Cree la plantilla**, habilite solo los canales necesarios
2. **Escribe** cada bloque con `{{key}}` y valores predeterminados opcionales
3. **Envío** con `template`, `channels`, `to` y `variables`.
4. La API devuelve **202** con ID por canal (`messageIds`, `smsIds`, `emailIds`,…)
5. **Entrega** por canal → webhooks de ese canal (`message.*`, `sms.*`,…)
6. **Metaaprobación** para WhatsApp oficial → **`template.*`** webhooks (abajo)

<Note>
  Cada envío consume **créditos por destinatario y por canal**. Si el saldo no es suficiente para la solicitud completa, **no se envía nada** (`INSUFFICIENT_CREDITS`).
</Note>

***

## WhatsApp oficial y Meta

Esto vincula las plantillas **internas** de Notifique con el catálogo **oficial** de Meta (API de la nube).

### Dos tipos de plantillas de WhatsApp

|                | **Internal** (`ZENVIO`)                   | **Official** (`WHATSAPP_OFFICIAL`)              |
| -------------- | ----------------------------------------- | ----------------------------------------------- |
| Where it lives | Workspace only                            | Meta **WABA** **and** Notifique                 |
| Typical line   | **Unofficial** WhatsApp (QR)              | **Official** WhatsApp (Embedded Signup)         |
| Approval       | Immediate in Notifique                    | Meta: `PENDING` → `APPROVED` / `REJECTED`       |
| WA content     | Simple text and image                     | Header, footer, buttons, carousel (per Meta)    |
| Other channels | SMS, email, etc. in the **same** template | SMS, email, etc. **still** in the same template |

En la **línea oficial**, fuera del período de **24 horas** después de que el cliente respondió, solo las metaplantillas **aprobadas** pueden iniciar o reanudar una conversación. Desde el punto de vista no oficial, esto no se aplica.

### Sincronizar con metaservidores

No necesitas copias duplicadas por canal. Flujo típico:

1. **Crear interno** en Notifique (SMS + correo electrónico + bloqueo de WhatsApp)
2. **Extracción de Meta**, catálogo de sincronización ya aprobado en WABA
3. **Vincular** el bloque de WhatsApp a un metamodelo existente, **o**
4. **Publicar** internamente en Meta y **esperar aprobación**

El nombre interno (`order_alert`) puede diferir de **`metaName`** en Meta (`order_update`). En envío oficial, Meta utiliza el modelo **aprobado** en su catálogo.

Varios números **oficiales** en la misma cuenta comercial **comparten** el mismo catálogo de plantillas.

Guía completa (sincronización, enlace, publicación, estado, errores): **[Metaplantillas oficiales](/es/template-api/como-funciona/templates-oficiais-meta)**.

### Estado de aprobación

Seguimiento en el panel o mediante webhook:

| Status     | Meaning                     |
| ---------- | --------------------------- |
| `PENDING`  | Meta reviewing              |
| `APPROVED` | Can send on official line   |
| `REJECTED` | Rejected, fix and republish |
| `PAUSED`   | Paused for quality          |

Eventos: **`template.submitted`**, **`template.status_changed`**, **`template.category_changed`**. Detalles: [Eventos de webhook](/es/template-api/como-funciona/eventos-do-webhooks).

<Warning>
  Editar solo en Notifique **sin** reflejar en Meta **no** cambia lo que el cliente ve en WhatsApp oficial. El texto entregado proviene de la definición **aprobada** de Meta.
</Warning>

***

## Funciones del panel

* Biblioteca de plantillas con **detección de variables**
* **Valores predeterminados** y traducciones por configuración regional
* Insignia **Meta** y estado coloreado en las plantillas oficiales
* **Sincronizar plantillas con Meta** en la instancia oficial
* Valores predeterminados del espacio de trabajo: instancia de WhatsApp, dominio de correo electrónico, aplicación Push, número de voz

## Características de la API

* **Gestión:** `templates:read`, `templates:create`, `templates:update`, `templates:delete`
* **Enviar:** alcance para **cada** canal en `channels` (`whatsapp:send`, `sms:send`,…)
* Detalles en la **referencia de API** en la pestaña Plantillas

## Próximos pasos

* [Inicio rápido](/es/template-api/como-funciona/quick-start): crear y enviar
* [Metaplantillas oficiales](/es/template-api/como-funciona/templates-oficiais-meta): sincronización, enlace y aprobación
* [Alcances de clave API](/es/template-api/como-funciona/escopos-da-api-key): gestión y envío
* [Eventos de webhook](/es/template-api/como-funciona/eventos-do-webhooks): Meta `template.*`
* [Variables y CRUD](/es/template-api/como-funciona/variaveis-disponiveis-e-crud): cargas útiles por canal