Las Plantillas de Contenido de Twilio te permiten enviar plantillas de mensajes preaprobadas de WhatsApp a través de tus canales de negocio de WhatsApp de Twilio en Chatwoot. Estas plantillas te permiten iniciar conversaciones y enviar mensajes estructurados que cumplen con las políticas de mensajería de WhatsApp.

## **Tipos de Plantillas Soportadas**

**Plantillas de Texto**

* Mensajes de texto simples con variables opcionales

* Soporte para hasta 100 variables por plantilla usando el formato `{{1}}`, `{{2}}`

* Soporte multilingüe

**Plantillas de Medios**

* **Plantillas de Imagen**: Texto con encabezados de imagen (JPEG/PNG, máx 5MB)

* **Plantillas de Video**: Texto con encabezados de video (MP4/3GPP, máx 16MB)

* **Plantillas de Documento**: Texto con archivos adjuntos (PDF/formato Office, máx 100MB)

* Soporte para URLs de medios dinámicos con variables

**Plantillas de Respuesta Rápida**

* Botones de respuesta interactiva gestionados por WhatsApp

* Acciones de botones simples para respuestas comunes

* Soporte para múltiples variantes de idioma

**Plantillas de Llamada a la Acción**

* **Plantillas de Botón de URL**: Envía mensajes con botones de acción clickeables

* **Soporte de Variables**: Tanto el texto del mensaje como los parámetros del botón pueden incluir variables

* **Tipos de Acción**: Botones de URL para pagos, reservas, sitios web, etc.

## **Requisitos Previos**

Antes de usar las Plantillas de Contenido de Twilio:

1. **Cuenta de Twilio**: Cuenta activa de Twilio con acceso a la API de WhatsApp Business

2. **Plantillas Aprobadas**: Plantillas creadas y aprobadas en la Consola de Twilio

3. **Integración con Chatwoot**: Canal de WhatsApp de Twilio configurado en Chatwoot

4. **Cuenta de WhatsApp Business**: Perfil de negocio en WhatsApp verificado

## **Configuración de Plantillas**

1. Inicia sesión en tu [Consola de Twilio](https://console.twilio.com/)

2. Ve a **Mensajería** → **Content Template Builder**

3. Haz clic en **Crear nueva plantilla**

4. Elige el tipo de plantilla: **Texto**: Para mensajes simples, **Medios**: Para imágenes, videos o documentos,  **Respuesta Rápida**: Para botones interactivos

5. Configura la plantilla según el propósito.

6. Envía la plantilla para aprobación de WhatsApp

7. Espera la aprobación (5 minutos a 24 horas)

8. Las plantillas aprobadas reciben un ContentSid

9. Las plantillas están listas para usarse en Chatwoot

## **Sincronizar Plantillas en Chatwoot**

**Sincronización Automática vía API**

Las plantillas se sincronizan automáticamente cuando:

1. Abres el modal de plantillas de contenido en una conversación

2. Creas una nueva conversación con un canal de WhatsApp de Twilio

**Sincronización Manual**

Para administradores de bandeja de entrada:

1. Ve a **Configuraciones** → **Bandejas de entrada**

2. Selecciona tu bandeja de WhatsApp de Twilio

3. Haz clic en el botón **Sincronizar plantillas**

4. Espera la notificación de finalización de sincronización

## **Uso de Plantillas en Conversaciones**

#### **Paso 1: Accede a las opciones de plantilla**

Abre cualquier conversación con un contacto de WhatsApp, haz clic en el **icono de plantilla** en el compositor de mensajes, selecciona **"Plantillas de WhatsApp"** en el menú desplegable

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTnAxRXdJPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--859d1249d1c6a48c60b489dbcd8e64c9cb051213/CleanShot%202025-08-26%20at%2013.49.16@2x.png)

#### **Paso 2: Elige tu plantilla**

Busca entre tus plantillas aprobadas, utiliza la barra de búsqueda para encontrar plantillas específicas rápidamente

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTzExRXdJPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--c4a753fd824fadbe3a6f3bb225fbdd38c7452d56/CleanShot%202025-08-26%20at%2013.51.19@2x.png)

#### **Paso 3: Personaliza tu mensaje**

Dependiendo del tipo de plantilla puede que tengas que completar:

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCUFIxRXdJPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--75e325a080c3749165473b87370618b8246c0a4e/CleanShot%202025-08-26%20at%2013.51.56@2x.png)

## **Mejores Prácticas**

**Diseño de Plantillas**

* Mantén los mensajes concisos y claros

* Usa variables para personalizar

* Asegúrate de que los archivos multimedia estén optimizados y sean accesibles

* Prueba las plantillas antes de enviarlas a aprobación

**Uso de Variables**

* Usa nombres de variables descriptivos en la Consola de Twilio

* Proporciona ejemplos claros para la aprobación

* Mantén el número de variables razonable (menos de 10 para mejor experiencia de usuario)

**Guías para Medios**

* Aloja los archivos en servidores confiables y rápidos

* Usa URLs HTTPS para todos los medios

* Optimiza el tamaño de archivos para entrega rápida

* Incluye texto alternativo en plantillas con medios

**Cumplimiento**

* Cumple las pautas de la Política de Negocios de WhatsApp

* Asegura que las plantillas tengan fines legítimos de negocio

* Respeta la privacidad y consentimiento de los usuarios

* Monitorea el desempeño y aprobación de las plantillas

## **Solución de Problemas**

**Problemas Comunes**

**La plantilla no aparece**

* **Causa**: La plantilla no fue aprobada por WhatsApp

* **Solución**: Verifica el estado de aprobación en la Consola de Twilio

**Fallo en la sincronización de plantilla**

* **Causa**: Problemas de conexión API o credenciales inválidas

* **Solución**: Verifica las credenciales de Twilio y reintenta la sincronización

**El medio no carga**

* **Causa**: La URL del medio no es accesible o es un formato incorrecto

* **Soluciones**: Verifica que la URL sea pública, revisa el formato y los límites de tamaño, asegúrate de usar protocolo HTTPS

**Las variables no funcionan**

* **Causa**: Formato de variable incorrecto o valores faltantes

* **Soluciones**: Usa el formato correcto `{{1}}`, `{{2}}` en Twilio, completa todas las variables requeridas en Chatwoot, verifica que la cantidad de variables coincida con la plantilla

## **Mensajes de Error**

**"Plantilla no encontrada"**

* La plantilla no está sincronizada con Chatwoot

* Ejecuta la sincronización manual o verifica la aprobación de la plantilla

**"Archivo de medios demasiado grande"**

* El archivo excede los límites de WhatsApp

* Comprime el archivo o usa otro formato

**"Parámetros de plantilla inválidos"**

* Valores de variables incorrectos o faltantes

* Revisa y completa todos los campos obligatorios

## **Ejemplos de Plantillas**

**Plantilla de Texto Básica**

```

Nombre: welcome_message

Contenido: "¡Bienvenido a {{1}}! Estamos emocionados de ayudarte con {{2}}."

Variables: Nombre de la empresa, tipo de servicio
```

**Lanzamiento de producto (Plantilla de Medios)**

```

Nombre: product_launch

Medio: Imagen del producto

Contenido: "🎉 ¡Nuevo lanzamiento! {{1}} ya está disponible por {{2}}. ¡Oferta por tiempo limitado!"

Variables: Nombre del producto, precio
```

**Confirmación de pedido (Plantilla de texto)**

```

Nombre: order_confirmed

Contenido: "Hola {{1}}! Tu pedido {{2}} ha sido confirmado. Entrega estimada: {{3}}."

Variables: Nombre del cliente, ID de pedido, fecha de entrega
```

**Plantilla de respuesta rápida**

```

Nombre: support_options

Contenido: "¿En qué podemos ayudarte hoy?"

Botones: "Soporte técnico", "Facturación", "Información general"
```

## **Limitaciones**

**Limitaciones Actuales**

* Las plantillas no están soportadas en campañas (próximamente en futuras actualizaciones)

* Plantillas de selector de lista 

* Plantillas de catálogo

* Plantillas de carrusel

**Límites de Plantillas**

* Máximo 100 variables por plantilla

* Los archivos multimedia deben ser de acceso público

* Las plantillas requieren aprobación de WhatsApp

* Numeración secuencial de parámetros requerida

## **Soporte**

Para ayuda adicional:

* Consulta la [Documentación de WhatsApp de Twilio](https://www.twilio.com/docs/whatsapp)

* Revisa las [Pautas de la Plataforma de Negocios de WhatsApp](https://developers.facebook.com/docs/whatsapp/business-platform)

* Contacta con tu administrador de sistema para problemas técnicos

* Consulta la documentación de Chatwoot para orientación general sobre la plataforma