# Comprender los Componentes de Plantillas de WhatsApp

***Explora los diferentes componentes de las plantillas de WhatsApp***

#### 1. Template Category

WhatsApp clasifica las plantillas en 3 categorías:

* **Marketing**\
  Usadas para mensajes **promocionales o de ventas adicionales** como ofertas o recomendaciones de productos.

  **Ejemplo de uso:** Oferta con descuento especial\
  **Mensaje ejemplo:**

```
🎉 Hola {{1}}, ¡disfruta un 20% de descuento en tu próxima compra con el código WELCOME20!
Oferta válida hasta {{2}}.
¡No te lo pierdas! Haz clic abajo para comprar ahora.
[Comprar ahora]
```

* **Utility**\
  Usadas para enviar **actualizaciones importantes** como confirmaciones de pedidos, recordatorios, actualizaciones de cuenta o notificaciones de envío.

**Ejemplo de uso:** Confirmación de envío\
**Mensaje ejemplo:**

```
Hola {{1}}, tu pedido #{{2}} ha sido enviado vía {{3}}.
Número de seguimiento: {{4}}
Entrega estimada en 3-5 días hábiles.
Toca abajo para rastrear tu paquete.
[Rastrear ahora]
```

* **Authentication**\
  Usadas para enviar **códigos OTP** y mensajes de verificación de inicio de sesión de forma segura.

**Ejemplo de uso:** Código de acceso de un solo uso\
**Mensaje ejemplo:**

```
Tu código de inicio de sesión es: {{1}}
Este código es válido por 10 minutos.
No lo compartas con nadie.
```

***

#### 2. Template Header

El **header** es la parte superior de una plantilla de mensaje de WhatsApp y puede incluir **texto** o **medios** para dar contexto o énfasis al mensaje.

![Encabezado de plantilla](https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2FtwitcnRXdEC7n35uv1qO%2Fheader.png?alt=media\&token=ac62ad63-72fb-449a-a572-6c395c7d9d81)

**1. Encabezado de Texto**

* Una línea de texto simple que resalta el mensaje principal.
* Solo se permite **una variable** en el encabezado de texto (ej. nombre del cliente o ID del pedido).

**2. Encabezado de Medios**

* Soporta **imágenes, videos, documentos o ubicaciones** para mejorar visualmente el mensaje.

**Tipos de Medios**

| Aspecto           | Static Media                                            | Dynamic Media                                           |
| ----------------- | ------------------------------------------------------- | ------------------------------------------------------- |
| Definición        | El mismo archivo se envía a todos los usuarios.         | El contenido cambia según el destinatario o evento.     |
| Casos de uso      | Banner promocional, logotipo, folleto estándar.         | Imagen del producto pedido, factura personalizada, etc. |
| Personalización   | Sin personalización, mismo contenido para todos.        | Altamente personalizado para cada usuario.              |
| Soporte de medios | Todos los medios (imagen, video, documento, ubicación). | Solo imágenes dinámicas soportadas por Wix y Shopify.   |

> ℹ️ **Nota:** Aunque la API de WhatsApp Business soporta medios dinámicos, **Wix y Shopify actualmente solo permiten encabezados con imágenes dinámicas**. Videos, documentos y ubicaciones dinámicas no están soportados en estas plataformas.

| Tipo de medio | Tamaño máximo |
| ------------- | ------------- |
| Imágenes      | 5 MB          |
| Videos        | 16 MB         |
| Documentos    | 100 MB        |

**Pasos para Añadir static y dynamic media**

{% tabs %}
{% tab title=" Static Media" %}
\
\&#xNAN;*Caso:* Un restaurante quiere notificar a todos los clientes sobre una oferta festiva.\
\&#xNAN;*Banner:* `diwali_offer.png`

**Uso:** Se muestra el mismo banner a todos los usuarios.

**Resultado:** Todos reciben la misma imagen, independientemente de su orden o preferencias.

**Pasos:**

1. Selecciona "Media" como encabezado.
2. Define como **Static**.
3. Carga una imagen de muestra.

![Ejemplo de Imagen Estática](https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2Fh2yM6KjlXidLpkxFgeqW%2Fimage.png?alt=media\&token=53e7dea6-279e-48da-a334-77eeb9c39430)
{% endtab %}

{% tab title="Dynamic Media" %}
\
**Caso práctico**

Una marca de cuidado de la piel D2C desea enviar actualizaciones de envío con una foto del producto exacto que el cliente pidió.

**Pasos:**

1. Selecciona "**Media**" como encabezado.
2. Define como **Dynamic**.
3. Configura el valor como URL de imagen del producto.

![Ejemplo de Imagen Dinámica](https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2FELmUMruAcLndAphkq9fu%2Fimage.png?alt=media\&token=ed0897b1-b509-4a38-bb87-37cee2d4ab8b)
{% endtab %}
{% endtabs %}

***

#### 3. Template Buttons

![Tipos de botones](https://392978341-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZtOBCP9JV8XEWJpUU4t%2Fuploads%2FLh60EiSxYDIQ69aGKV9f%2Fimage.png?alt=media\&token=58ebecee-5742-4f9c-b90e-074603e66761)

Agregar botones mejora la experiencia del usuario al permitir acciones con un solo toque directamente desde el mensaje.

**Tipos de Botones**

* Quick Reply Button
* Call to Action Button

***

**Quick Reply Buttons**

*Propósito:* Proporcionar opciones predefinidas para responder rápidamente. Ideal para encuestas, confirmaciones, o guías paso a paso.

**Ejemplos:**

* "Sí, estoy interesado."
* "Cambiar hora de entrega"
* "Cancelar reserva"

> ℹ️ **Máximo:** *3 botones de respuesta rápida por plantilla*

***

**Call to Action Buttons**

*Propósito:* Redirigir al usuario a una acción específica como visitar un sitio web, llamar o copiar un código.

**Opciones:**

1. **Visit Website**

* Puede ser **static** (igual para todos) o dynamic (personalizado).
* Ejemplo dinámico: `https://track.com/{{1}}`

2. **Call Phone Number**

* Abre el marcador con un número predefinido.

3. **Copy Offer Code**

* Permite copiar un código con un solo toque.

> ℹ️ **Máximo:** *2 botones de llamada a la acción por plantilla*

***

#### Diferentes tipos de URL en Call-to-Action Buttons

Al configurar botones de llamada a la acción (CTA) en las plantillas de WhatsApp, las URL ayudan a guiar a los usuarios a páginas web específicas.

Estas URL se pueden clasificar en dos tipos: Static URL estáticas y dynamic URL , según si el enlace es el mismo para todos los usuarios o varía según sus datos.

**Static URLs**

Una URL estática es una dirección web fija que permanece igual para todos los usuarios. No cambia según las entradas ni las acciones específicas del usuario.

**caso de uso**

Utilice Static URL  cuando:

Desea dirigir a todos los usuarios a una página común, como:

* Página de registro
* Página de contacto
* Preguntas frecuentes o Centro de ayuda

**Ejemplo:**

```
https://example.com/register
```

Esta URL siempre llevará a los usuarios a la misma página de registro, independientemente de quién haga clic en ella.

***

**Dynamic URLs**

Una Dynamic URL  contiene marcadores de posición que se reemplazan con valores específicos del usuario al enviar el mensaje. Esto permite que cada destinatario reciba un enlace personalizado.

**Caso de us**

Utilice URL dinámicas cuando:

La URL de destino varía según el usuario, por ejemplo:

* Seguimiento de pedidos
* Confirmaciones personalizadas
* Promociones únicas

**Ejemplo:**

```
https://example.com/{{1}}
```

Aquí, {{1}} es un parámetro dinámico que se reemplaza con un valor único, como un ID de pedido o un ID de usuario.

* Para el usuario A : `https://example.com/ORDER12345`&#x20;
* Para el usuario B : `https://example.com/ORDER98978` &#x20;

Esto permite a cada usuario acceder a contenido personalizado de forma segura y directa.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mercuri.cx/mercuri-docs-es/caracteristicas/templates/whatsapp-template/comprender-los-componentes-de-plantillas-de-whatsapp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
