WHATSAPP-TEMPLATES / CAPACIDADES_META_Y_KAPSO / GUÍA VISUAL & REGLAS

Catálogo Completo de Plantillas Meta: Qué se Puede Enviar, Botones y Carruseles

Las plantillas (Message Templates) son el único formato autorizado por Meta para iniciar conversaciones outbound por WhatsApp. Descubre cómo funcionan los textos dinámicos, imágenes, documentos, botones interactivos y carruseles multiproducto a través de Kapso.

ESTUDIO VISUAL

Simulador de Tipos de Plantillas en WhatsApp

TIPO: TEXTO CON VARIABLES

Plantilla Estándar con Parámetros Dinámicos

UTILITY

El formato más común para avisos de cobro, confirmaciones de pedido y alertas de servicio. Utiliza marcadores de posición {{1}}, {{2}} que se reemplazan en tiempo real desde la API o desde cada fila de un archivo CSV.

COMPONENTES PERMITIDOS:

Header (Cabecera): Opcional (Texto de hasta 60 caracteres). Soportado

Body (Cuerpo): Obligatorio (Hasta 1.024 caracteres, variables ilimitadas). Obligatorio

Footer (Pie): Opcional (Hasta 60 caracteres en gris claro). Soportado

ESTRUCTURA DE ENVÍO JSON: POST /v1/messages

{
  "to": "+56912345678",
  "template": {
    "name": "aviso_pago",
    "language": "es",
    "parameters": {
      "1": "Carlos Pérez",
      "2": "$25.000",
      "3": "25 de Septiembre"
    }
  }
}

Regla de Oro de Meta para Variables: Las variables no pueden contener saltos de línea consecutivos, no pueden ser parámetros vacíos (`""`), y deben guardar estricta correlación secuencial (`{{1}}`, `{{2}}`, `{{3}}`).

Innovia Notificaciones Cuenta Verificada Meta

Escribe un mensaje...

CATEGORIZACIÓN META

Las 3 Categorías de Plantillas de WhatsApp

Meta clasifica y tarifa las plantillas en función de su objetivo. Una plantilla rechazada suele deberse a categorización incorrecta:

UTILITY (UTILIDAD) Costo Menor

Notificaciones & Transaccional

Mensajes desencadenados por una acción o solicitud específica del usuario: avisos de cobro, confirmación de pedidos, actualización de envíos, recordatorios de citas.

Restricción Estricta: Si agregas palabras promocionales ("aprovecha", "descuento", "oferta"), Meta reclasifica automáticamente la plantilla a MARKETING.

MARKETING Tarifa Estándar

Promociones & Campañas Outbound

Campañas masivas de ventas, ofertas, anuncios de productos, carruseles de catálogo y re-engagement. Incluye botones de llamada a la acción y enlaces personalizados.

Opt-out Obligatorio: Meta exige que las plantillas de marketing incluyan un botón para que el usuario pueda darse de baja ("Detener mensajes").

AUTHENTICATION (OTP) Autofill One-Tap

Códigos de Verificación

Envío seguro de códigos de verificación de un solo uso (OTP) para inicio de sesión, recuperación de contraseña y validación en 2 pasos.

Formato Cerrado: Meta no permite editar el texto libremente; solo permite cambiar el tiempo de caducidad del código y el botón de copiar.

FLUJO OPERATIVO & API

¿Cómo se Crean las Plantillas y Cómo Llegan a Innovia?

Entiende la interacción técnica y operativa entre Meta (quien aprueba), Kapso (quien transporta) e Innovia (quien administra):

1 Creación de Plantilla

Se define el nombre, idioma, categoría y cuerpo con variables `{{1}}`, `{{2}}`.

2 Revisión Automática Meta

La IA de Meta valida que no haya spam ni enlaces prohibidos (tarda de 30s a 5 min).

3 Sincronización vía Kapso

Kapso recibe el webhook de Meta y lo expone en su API `GET /templates`.

4 Lista en Innovia

Innovia persiste la plantilla en PostgreSQL y extrae las variables para el wizard de campañas.

Método 1 (Recomendado MVP): En WhatsApp Manager

Cero costo de desarrollo en la V1

Oficial

El cliente o el equipo de Innovia crea la plantilla directamente en la consola oficial de Meta Business Suite (business.facebook.com/wa/manage/message-templates).

¿Por qué es la mejor opción para la V1?

Meta ofrece un editor visual interactivo gratuito con vista previa exacta en iPhone y Android.
Valida en vivo las políticas de rechazo antes de enviar a revisión.
Aprobación prácticamente instantánea por los algoritmos de Meta.
En Innovia: Solo necesitas implementar un botón de "Sincronizar Plantillas" que llama a Kapso y guarda las plantillas aprobadas en tu base de datos.

Método 2: Creación Programática vía API

Para integraciones avanzadas

REST API

Puedes enviar una solicitud HTTP a la API de Kapso (POST /v1/templates), la cual reenvía el esquema a Meta Graph API.

EJEMPLO DE LLAMADA API:

POST https://api.kapso.ai/v1/templates
{
  "name": "aviso_vencimiento_v1",
  "language": "es",
  "category": "UTILITY",
  "components": [
    {
      "type": "BODY",
      "text": "Hola {{1}}, tu cuenta vence el {{2}}.",
      "example": {
        "body_text": [["Carlos", "25 de Septiembre"]]
      }
    }
  ]
}

Importante: El bloque `example` es obligatorio por Meta. Si envías variables sin valores de ejemplo, Meta rechaza la plantilla automáticamente.

¿Cómo Detecta Innovia las Variables para el Wizard de Campañas?

Cuando sincronizas las plantillas a la base de datos de Innovia en la tabla templates, el backend ejecuta una expresión regular sobre el texto del cuerpo:

1. EXTRACCIÓN REGEX: const vars = body.match(/\{\{([0-9]+)\}\}/g);

Detecta dinámicamente si la plantilla requiere 1, 2 o más parámetros.

2. INTERFAZ DE MAPEO EN EL FRONTEND: {{1}} ➔ Columna "Nombre" del CSV

Genera automáticamente los selectores de columnas correspondientes.

Matriz de Conformidad: Qué está Permitido vs Qué Provoca Rechazo en Meta

Compliance Meta

Totalmente Permitido por Meta & Kapso

Encabezados Multimedia Dinámicos: Enviar un PDF diferente por cada cliente (ej: la factura en PDF adjunta dinámicamente vía URL en la API).
Botones de Respuesta Rápida (Quick Replies): Hasta 3 botones predefinidos (ej: "Confirmar Pago", "Hablar con Agente", "Reprogramar").
URLs Dinámicas en Botones: `https://pagos.innovia.io/checkout?id={{1}}` para llevar al cliente directo a su pasarela de pago.
Carruseles de Tarjetas (Cards): Hasta 10 tarjetas horizontales navegables con imagen, texto y botones independientes cada una.

Rechazado o Bloqueado por Meta

Variables sin Contexto o Variables Flotantes: "Hola {{1}}, tu código es {{2}}" sin texto previo explicativo es rechazado por falta de contexto.
Enlaces Acortados Genéricos: Uso de `bit.ly`, `tinyurl` u ofuscadores de URL está estrictamente prohibido y bloquea la plantilla.
Contenido Promocional en Categoría de Utilidad: Intentar registrar un mensaje publicitario como UTILITY para pagar menos tarifa provoca sanción o rechazo.
Solicitud de Datos Sensibles: Pedir números completos de tarjetas de crédito, contraseñas bancarias o CVC directamente en WhatsApp.