API de Gestión de Plantillas

​

Introducción

​

📋 Obtener Plantillas Disponibles

​

Endpoint

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

​

Parámetros de Consulta

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

​

Respuesta

[
  {
    "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"
  }
]

• 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

​

Endpoint

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

​

Parámetros de Consulta

​

Respuesta

{
  "status": "OK",
  "components": ["header_image", "body_text_0", "body_text_1"]
}

​

🆕 Crear Nueva Plantilla

​

Endpoint

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

​

Cuerpo de la Solicitud

{
  "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

​

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