Plantillas de notificación

Qué es cada tipo de plantilla (push, in-app, email) y cómo se usa en envíos push, notificaciones in-app y journeys.

Una plantilla es contenido reutilizable que no se envía por sí mismo: se copia en cada envío o notificación in-app que la usa, o la lee en cada ejecución el nodo de journey que la referencia. El portal maneja tres tipos, cada uno guardado en su propia colección y con su propio editor. La pestaña Notificaciones > Plantillas los lista todos en una sola tabla, con buscador y filtro por tipo; una plantilla existente se abre desde su nombre o desde el ícono de lápiz de su fila.

Tipo	Dónde vive	Editor	Se usa en
Push	`notificationTemplates`	Plantillas > Nueva plantilla > Push	Envíos push, nodo push de journeys
In-App	`inAppNotifications` con estado `template`	Plantillas > Nueva plantilla > In-App (mismo editor que una in-app)	In-app vinculada a un push, "Crear desde plantilla"
Email	`emailTemplates`	Plantillas > Nueva plantilla > Email	Envíos de email, nodo email de journeys, asistente (`sendEmail`)

Plantillas push

Guardan título, cuerpo, imagen y datos custom. Al crear un envío push eliges Usar plantilla y el formulario se rellena con su contenido; puedes editarlo antes de enviar sin modificar la plantilla. El nodo Acción > Push de un journey referencia la plantilla por id y la lee en cada ejecución, así que editar la plantilla cambia lo que reciben los próximos clientes del journey.

Una plantilla push es solo push: no lleva apariencia in-app ni HTML de email.

El título y el cuerpo aceptan variables entre dobles llaves, sin espacios:

Variable	Valor
`{{firstName}}` / `{{lastName}}`	Nombre y apellido del cliente
`{{email}}`	Email del cliente
`{{tierName}}` / `{{xp}}`	Nivel y XP
`{{pointsBalance}}`	Saldo de puntos
`{{orgName}}`	Nombre de la organización
`{{event_<propiedad>}}`	Solo en journeys disparados por evento: una propiedad del evento que inscribió al cliente. Con `add_to_cart`, `{{event_value}}` es el monto del carrito

Las variables del evento toman las propiedades de primer nivel con valor simple (texto, número o verdadero/falso) y las envían tal cual llegaron: un value de 7990 se muestra 7990. Una variable sin valor queda vacía; en un journey disparado por segmento no hay evento, así que las {{event_…}} salen vacías.

Plantillas in-app

Una plantilla in-app es una notificación in-app completa (bloques, HTML, tipo, posición, colores, opacidades, botón y cierre) con estado template. Ese estado la deja fuera de todo lo que muestra o entrega in-apps:

No aparece en la pestaña In-App ni en el resumen; se lista en Plantillas (filtro Tipo: In-App).
Nunca se sirve al SDK: el GET de in-apps, los triggers por evento y los mini-juegos exigen estado active.
No se activa ni se pausa. Una plantilla no cambia de estado: se clona.

Los mini-juegos (contentType: "game") no pueden ser plantilla.

Crear una plantilla in-app

Plantillas > Nueva plantilla > In-App: abre el editor de in-apps sin las tarjetas de trigger, segmentación ni programación. Guarda solo contenido.
Guardar como plantilla desde el menú de una in-app existente: crea una plantilla con el contenido de esa in-app.
Desde el asistente: createInAppNotification con asTemplate: true.

Usar una plantilla in-app

"Crear desde plantilla", "Crear in-app desde esta plantilla" y la in-app vinculada a un push crean una copia con templateSourceId apuntando a la plantilla; editar la plantilla después no cambia esas copias.

Nueva In-App > Crear desde plantilla: clona la plantilla como borrador y abre el editor para ajustar audiencia, trigger y fechas.
Detalle de una plantilla > Crear in-app desde esta plantilla: lo mismo desde la plantilla.
Envío push > Mostrar también como notificación in-app > Desde plantilla in-app: el push crea una in-app vinculada con la misma audiencia y el contenido de la plantilla. La in-app vinculada guarda templateSourceId y el borrador del push guarda inApp.templateId. Si la plantilla se borró, el borrador muestra un aviso y hay que elegir otra.
Desde el asistente: sendPushNotification o saveDraftPush con inApp: { mode: "template", templateId }.

Plantillas de email

Guardan nombre, asunto y HTML. El HTML acepta variables entre dobles llaves que se reemplazan por datos del cliente al enviar:

Variable	Valor
`{{firstName}}` / `{{lastName}}`	Nombre y apellido del cliente
`{{email}}`	Email del cliente
`{{tierName}}` / `{{xp}}`	Nivel y XP
`{{pointsBalance}}`	Saldo de puntos
`{{orgName}}`	Nombre de la organización

Un envío de email (Notificaciones > Email > Enviar email), el asistente (sendEmail) y el nodo Acción > Email de un journey requieren una plantilla de email; sin plantillas la lista aparece vacía. Además, los envíos de email y el nodo email de journeys necesitan el SMTP de la organización configurado: sin credenciales SMTP no se envía nada.

Límites del plan

maxTemplates cuenta las plantillas push, las in-app con estado template y las de email.
maxInAppNotifications cuenta solo las in-apps que no son plantilla.

Al superar el límite, crear o clonar devuelve un error con el nombre del plan; borrar una plantilla libera cupo de inmediato.