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

# Plantillas de WhatsApp

> Mensajes preaprobados por Meta: cuándo hacen falta, cómo crearlas para que las aprueben y cómo mantenerlas sincronizadas.

<Info>Outbound → **Plantillas** · Owner y Admin · Requiere un plan con campañas y un número de WhatsApp conectado</Info>

## Por qué existen

WhatsApp solo permite escribirle a alguien que **no te ha escrito en las últimas 24 horas** usando un mensaje previamente **aprobado por Meta**: una plantilla. Sin plantilla aprobada no hay campañas ni notificaciones proactivas. Dentro de la ventana de 24 horas puedes escribir libremente.

## Estados de una plantilla

| Estado            | Significado                                                   | Qué hacer                                                                      |
| ----------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **En revisión**   | Enviada a Meta; suele tardar minutos, puede tardar hasta 24 h | Esperar y **Sincronizar**                                                      |
| **Aprobada**      | Lista para usar en campañas y por API                         | —                                                                              |
| **Rechazada**     | Meta la rechazó                                               | Ver motivo en Meta Business, corregir y crear una nueva (no se editan)         |
| **Pausada**       | Meta la pausó por baja calidad (muchos bloqueos o reportes)   | Revisar el contenido y la audiencia; se reactiva sola tras un tiempo si mejora |
| **Deshabilitada** | Meta la deshabilitó definitivamente                           | Crear una nueva                                                                |

Solo se pueden eliminar plantillas **En revisión**, **Rechazadas** o **Deshabilitadas**; al eliminar, se elimina también de tu cuenta de WhatsApp Business.

## Crear una plantilla

**Crear plantilla**. La vista previa de la derecha se actualiza mientras escribes.

| Campo                                 | Reglas                                                                                                                                                                                                                                                  |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Número de WhatsApp**                | Si tienes varios números, elige a cuál pertenece.                                                                                                                                                                                                       |
| **Nombre**                            | Minúsculas, números y guiones bajos (`recordatorio_cita`). Es el identificador que usarás por API.                                                                                                                                                      |
| **Categoría**                         | **Utility**: notificaciones transaccionales (recordatorios, confirmaciones, estado de un pedido). **Marketing**: promociones y campañas comerciales. Meta cobra distinto y es más estricta con Marketing; elegir mal la categoría es motivo de rechazo. |
| **Idioma**                            | Español · Español (México) · Inglés (US). Al enviar por API se identifica la plantilla por nombre **e** idioma.                                                                                                                                         |
| **Cuerpo del mensaje**                | Hasta 1.024 caracteres. Admite `*negrita*` y `_cursiva_`.                                                                                                                                                                                               |
| **Variables**                         | **+ Agregar variable** inserta `{{nombre_variable}}` donde esté el cursor. Usa nombres descriptivos (`{{nombre}}`, `{{fecha}}`), no números.                                                                                                            |
| **Ejemplos para la revisión de Meta** | Un ejemplo por variable, obligatorio: Meta necesita ver un mensaje real para aprobarlo.                                                                                                                                                                 |
| **Pie de página**                     | Opcional, hasta 60 caracteres, sin variables. Ideal para *Responde STOP para dejar de recibir mensajes*.                                                                                                                                                |
| **Botones**                           | Hasta 3: **Respuesta rápida** (el cliente responde con un toque, por ejemplo *Confirmar* / *Reprogramar*) o **Ir a sitio web** (abre una URL). Texto de hasta 25 caracteres.                                                                            |

Pulsa **Enviar a revisión**.

### Reglas que el editor comprueba

* El mensaje no puede **empezar ni terminar** con una variable, ni tener **dos variables seguidas** sin texto entre ellas.
* Nombres de variable solo con minúsculas, números y guion bajo.
* Todas las variables necesitan ejemplo.

### Consejos para que Meta apruebe

<Tip>
  * Escribe el mensaje como lo leería el cliente, con contexto claro de por qué lo recibe: *"Hola {{nombre}}, le escribimos de Aseguradora La Ceiba para dar seguimiento a su cotización de {{producto}}."*
  * No uses variables para meter contenido distinto al que aprobó Meta: si el ejemplo dice *seguro de vehículo* y luego envías un párrafo de promoción, la plantilla acabará pausada.
  * Evita mayúsculas sostenidas, signos de exclamación repetidos y URLs acortadas.
  * Para mensajes de marketing, incluye siempre el pie de baja.
</Tip>

## Sincronizar

**Sincronizar** consulta a Meta el estado actual de todas las plantillas del número: trae las que se crearon fuera de Sofia Chat, actualiza estados (aprobada, rechazada, pausada) y deshabilita las eliminadas. Hazlo después de enviar una a revisión y siempre que algo "no aparezca". El resultado indica cuántas se crearon, actualizaron o deshabilitaron.

## Usar una plantilla

* En **campañas**: solo aparecen las plantillas **Aprobadas** del número elegido.
* **Individualmente**: desde tus sistemas, con `POST /v1/messages` y `type: "template"` ([guía para desarrolladores](/desarrolladores/tutorial-campana)).
* **Ver detalle** (👁) muestra la vista previa exacta de cómo se ve en WhatsApp.