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

# API de Gestión de Plantillas

> Documentación oficial para gestionar plantillas de mensajes de WhatsApp

## Introducción

Los endpoints de gestión de plantillas te permiten recuperar, inspeccionar y crear plantillas de mensajes de WhatsApp. Las plantillas son formatos de mensaje preaprobados requeridos por WhatsApp para las comunicaciones empresariales.

***

## 📋 Obtener Plantillas Disponibles

Recupera todas las plantillas disponibles para tu empresa y número de teléfono.

### Endpoint

```
GET https://cloud.lovi.ai/functions/v1/notify/templates?access_key={TU_ACCESS_KEY}&phone_number={NUMERO_TELEFONO}
```

### Parámetros de Consulta

| Parámetro      | Requerido | Descripción                                                 |
| -------------- | --------- | ----------------------------------------------------------- |
| `access_key`   | Sí        | Tu clave de acceso única a la API.                          |
| `phone_number` | Sí        | Número de teléfono para filtrar plantillas (sin signo '+'). |

**Ejemplo de Solicitud:**

```
GET https://cloud.lovi.ai/functions/v1/notify/templates?access_key=tu-api-key&phone_number=34666033135
```

### Respuesta

La API devuelve un **array** de objetos de plantilla (no envuelto en un objeto).

```json theme={null}
[
  {
    "id": "696796403510039",
    "name": "welcome_message",
    "status": "APPROVED",
    "category": "MARKETING",
    "language": "es",
    "components": [
      {
        "text": "¡Bienvenido! Este es un mensaje de prueba.",
        "type": "BODY"
      }
    ],
    "parameter_format": "POSITIONAL"
  }
]
```

**Notas Importantes:**

* La respuesta es un **array directo**, no un objeto con clave "templates"
* Los valores de `status` están en **MAYÚSCULAS**: `"APPROVED"`, `"PENDING"`, `"REJECTED"`
* Los valores de `category` están en **MAYÚSCULAS**: `"MARKETING"`, `"UTILITY"`, `"AUTHENTICATION"`

***

## 🔍 Obtener Componentes de Plantilla

Recupera información detallada sobre los componentes y la estructura de una plantilla específica.

### Endpoint

```
GET https://cloud.lovi.ai/functions/v1/notify/template/components?access_key={TU_ACCESS_KEY}&template={ID_PLANTILLA}
```

### Parámetros de Consulta

| Parámetro    | Requerido | Descripción                              |
| ------------ | --------- | ---------------------------------------- |
| `access_key` | Sí        | Tu clave de acceso única a la API.       |
| `template`   | Sí        | ID o nombre de la plantilla a consultar. |

### Respuesta

Este endpoint devuelve SOLO los **componentes dinámicos** que necesitas proporcionar al enviar una notificación.

```json theme={null}
{
  "status": "OK",
  "components": ["header_image", "body_text_0", "body_text_1"]
}
```

***

## 🆕 Crear Nueva Plantilla

Crea una nueva plantilla de mensaje de WhatsApp para que Meta la apruebe.

### Endpoint

```
POST https://cloud.lovi.ai/functions/v1/admin/whatsapp/create/template
```

### Cuerpo de la Solicitud

```json theme={null}
{
  "company_id": "uuid-empresa",
  "waba_id": "id-cuenta-whatsapp-business",
  "name_template": "nueva_plantilla",
  "language_template": "es_ES",
  "category_template": "MARKETING",
  "components_template": {
    "HEADER": {
      "format": "TEXT",
      "text": "Importante: {1}"
    },
    "BODY": {
      "text": "Hola {1}, te informamos que {2}. Para más información visita {3}."
    },
    "FOOTER": {
      "text": "Equipo de Soporte"
    },
    "BUTTONS": [
      {
        "type": "URL",
        "text": "Ver Detalles",
        "url": "https://ejemplo.com/detalles/{1}"
      },
      {
        "type": "QUICK_REPLY",
        "text": "Contactar Soporte"
      }
    ]
  }
}
```

### Categorías de Plantillas

| Categoría        | Descripción                           | Caso de Uso                         |
| ---------------- | ------------------------------------- | ----------------------------------- |
| `MARKETING`      | Mensajes promocionales                | Ofertas, anuncios                   |
| `UTILITY`        | Mensajes transaccionales, funcionales | Actualizaciones de pedidos, alertas |
| `AUTHENTICATION` | Mensajes de seguridad y verificación  | Códigos OTP, confirmaciones         |

### Proceso de Aprobación de Plantillas

1. **Envío**: La plantilla se envía a Meta para su revisión
2. **Revisión**: Meta revisa la plantilla (normalmente 24-48 horas)
3. **Aprobación/Rechazo**: La plantilla se aprueba o rechaza con comentarios
4. **Uso**: Las plantillas aprobadas pueden usarse en notificaciones

***

## 📝 Mejores Prácticas para Plantillas

### Convenciones de Nomenclatura

* Usa solo letras minúsculas
* Usa guiones bajos para los espacios
* Sé descriptivo: `bienvenida_nuevo_usuario` vs `plantilla1`
* Incluye el idioma si hay múltiples: `bienvenida_es`, `bienvenida_en`

### Razones Comunes de Rechazo

* ❌ Saludos genéricos ("Hola", "Buenos días")
* ❌ Lenguaje promocional en plantillas UTILITY
* ❌ Falta de contexto o propósito poco claro
* ❌ Uso incorrecto de variables
* ❌ Violaciones de políticas (spam, contenido inapropiado)

### Consejos para la Aprobación

* ✅ Incluir contexto empresarial específico
* ✅ Usar lenguaje claro y profesional
* ✅ Proporcionar ejemplos significativos
* ✅ Seguir las directrices de plantillas de WhatsApp
* ✅ Probar la sustitución de variables exhaustivamente