INNOVIA-UX-SPEC / PANTALLAS_Y_WIZARD_CAMPANAS / MANEJO END-TO-END

¿Cómo se Administran y Usan las Plantillas en la Plataforma de Innovia?

Esta guía detalla la experiencia de usuario (UX), pantallas y flujos de software que el usuario final y los operadores verán dentro del portal web de Innovia para sincronizar, previsualizar y mapear plantillas con archivos CSV.

PANTALLA 1 Catálogo de Plantillas

Listado con estados de aprobación en tiempo real de Meta, previsualización en vivo y botón de sincronización con Kapso.

PANTALLA 2 Mapeador en Campañas CSV

Detección automática de variables `{{1}}`, `{{2}}` y selectores para vincularlas a las columnas del archivo Excel/CSV.

PANTALLA 3 Selector en API Transaccional

Uso de plantillas por nombre desde sistemas externos (`POST /v1/messages`) con paso de parámetros tipados.

MOCKUP 1 · PANTALLA PRINCIPAL

El Módulo de Plantillas en el Dashboard de Innovia

Ruta: /dashboard/templates

Plantillas WhatsApp Conectadas Línea: +56 9 8765 4321

Crear Plantilla en Meta

Filtrar por: Todas (6) Utilidad (4) Marketing (2)

Última sincronización: Hoy, hace 5 minutos

recordatorio_pago_v2 APROBADA

Hola {{1}}, le recordamos que su factura de {{2}} vence el día {{3}}.

Variables: 3 ({{1}}, {{2}}, {{3}})

envio_factura_pdf APROBADA

[Header: Documento PDF] Estimado cliente {{1}}, adjuntamos su estado de cuenta...

Header: PDF | Vars: 1

oferta_lanzamiento MARKETING

¡Aprovecha nuestro descuento de {{1}} en planes seleccionados! [Botón: Comprar]

Botón: URL | Vars: 1

MOCKUP 2 · WIZARD DE CAMPAÑAS OUTBOUND

El Mapeador de Variables de Plantilla con CSV

Paso 3 de 4 en /dashboard/campaigns/new

Cuando el operador sube el archivo CSV de destinatarios y selecciona una plantilla, la interfaz de Innovia detecta automáticamente cuántas variables requiere y despliega un selector dinámico para que el operador vincule cada variable con una columna del archivo:

PLANTILLA SELECCIONADA: recordatorio_pago_v2

"Hola {{1}}, le recordamos que su factura por un valor de {{2}} vence el día {{3}}."

ASIGNAR COLUMNAS DEL ARCHIVO CSV (clientes_septiembre.csv):

Variable {{1}} Nombre del destinatario

➔

Variable {{2}} Importe / Deuda

➔

Variable {{3}} Fecha límite de pago

➔

VISTA PREVIA DE LAS PRIMERAS 2 FILAS DEL CSV:

FILA 1: +56 9 1234 5678

Hola Carlos Pérez, le recordamos que su factura por un valor de $25.000 vence el día 25 de Septiembre.

FILA 2: +56 9 8765 4321

Hola Mariana Silva, le recordamos que su factura por un valor de $42.900 vence el día 28 de Septiembre.

Validado: 100% de filas con variables asignadas correctamente

Estructura de Almacenamiento en Base de Datos (PostgreSQL)

Table: templates

CÓMO GUARDA INNOVIA LA PLANTILLA EN SQL:

{
  "id": "tpl_9918a2-11bc",
  "tenant_id": "inn_tenant_01",
  "name": "recordatorio_pago_v2",
  "language": "es",
  "category": "UTILITY",
  "status": "APPROVED",
  "provider_template_id": "meta_tpl_887123991",
  "components": [
    {
      "type": "BODY",
      "text": "Hola {{1}}, le recordamos que su factura...",
      "variable_count": 3
    }
  ]
}

VENTAJAS DE ESTE MODELO PARA INNOVIA:

Cero Latencia en Campañas: Innovia no tiene que consultar a Meta cada vez que un usuario abre el dashboard; las plantillas ya están en nuestra base de datos.
Portabilidad: Si en el futuro sustituyes Kapso por Gupshup o Meta Cloud directo, el nombre y los identificadores de tus plantillas se mantienen intactos.
Despacho Transaccional Limpio: En la API pública, un sistema externo solo envía:
POST /v1/messages { "template": { "name": "recordatorio_pago_v2", "parameters": { "1": "Carlos", ... } } }