Skip to main content

​
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ámetroRequeridoDescripción
access_keySíTu clave de acceso única a la API.
phone_numberSí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). 
[
  {
    "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ámetroRequeridoDescripción
access_keySíTu clave de acceso única a la API.
templateSí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. 
{
  "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

{
  "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íaDescripciónCaso de Uso
MARKETINGMensajes promocionalesOfertas, anuncios
UTILITYMensajes transaccionales, funcionalesActualizaciones de pedidos, alertas
AUTHENTICATIONMensajes de seguridad y verificaciónCó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