¿Qué es esta función?
Es una nueva estrategia de contenido disponible en el nodo de Email dentro de una campaña de Flow. Permite personalizar la vitrina de productos de un mail con productos que ya vienen definidos por un sistema externo del cliente, en lugar de que Growlat los calcule con sus estrategias habituales (más vendidos, relacionados, etc.).
Se la encuentra en el selector de estrategias con el nombre:
Recomendación externa: Utiliza productos definidos por un sistema externo para personalizar el contenido.
¿Para qué sirve?
Esta función está pensada para casos donde el cliente ya tiene su propia lógica de recomendación de productos por fuera de Growlat (por ejemplo, un motor de recomendaciones propio, o una lista de productos que un contacto está esperando que vuelvan a tener stock) y solo necesita que Growlat los inserte en el mail al momento de enviarlo.
Caso típico: campaña de "Volvió el stock" donde el sistema del cliente sabe qué SKUs le interesan a cada contacto y se los envía a Growlat junto con el perfil, para que el mail se arme con esos productos puntuales.
Requisitos previos (importante)
Esta función no se configura solo desde la plataforma. Para que funcione, tu equipo técnico tiene que estar enviando los SKUs a través del endpoint de inyección de perfiles de la campaña, agregando dos campos nuevos y opcionales:
Campo | Qué hace |
| SKUs que van a la vitrina principal del mail ( |
| SKUs que van a la vitrina complementaria del mail ( |
Si todavía no tenes esta integración armada, avisale a tu equipo técnico o al integrador para que sume estos campos al momento de inyectar perfiles.
Puntos clave a comunicar al cliente/integrador:
Los SKUs se mandan por perfil (cada contacto trae los suyos), no a nivel de todo el request.
El orden en que se envían los SKUs se respeta en el mail final.
Los productos deben existir en el catálogo del proyecto y estar completos (no virtuales, con
completed:true). Si un producto todavía no está sincronizado del todo, no se va a mostrar.Si se inyecta el mismo perfil más de una vez, gana la última inyección.
Si el perfil no manda estos campos, todo sigue funcionando como antes (no rompe nada existente).
De dónde sale la URL que tiene que consumir el cliente
No hay que armar la URL a mano ni pedirle el UUID de campaña a nadie: la propia plataforma te la da lista desde el Nodo de Inyectar de la Campaña de Flujos.
En el Workflow, abrí el Nodo de Inyectar.
Ahí vas a ver la URL completa, ya con el identificador de esa campaña puntual incluido, más un botón Copiar URL.
El propio nodo muestra un aviso de ¡Importante! con lo que falta para poder llamarla:
Agregar el header
X-Tenant. (Lo obtenes desde Preferencias → Tokens)Agregar el header
Authorization: Bearer <token>. (Preferencias → Tokens → Crear Token)Content-Type: siempre es
application/json
Ese es todo el trabajo de "armado" que tenés que hacer vos como usuaria de la plataforma: copiar la URL del nodo y generar el token. El resto (headers, body) se lo pasás a tu equipo técnico o al del cliente para que lo integren.
Headers que necesita el request:
X-Tenant: <uuid del tenant>Authorization: Bearer <token generado en Preferencias → Tokens, colección Campaña>Content-Type: application/json
Ejemplo del JSON:
{
"profiles": [
{
"email": "[email protected]",
"products_primary": ["LKFC3516RER"]
}
]
}
Con ese request, Growlat guarda que ese perfil tiene el SKU LKFC3516RER esperando para la vitrina principal. Cuando se dispare el nodo de Email con la estrategia Recomendación externa configurada, ese producto es el que se va a mostrar en el mail.
Si además se quiere mandar productos para la vitrina complementaria, se suma products_complementary con su propio array de SKUs, en el mismo objeto del perfil.
Cómo configurarlo en la plataforma
Hay dos partes: preparar el nodo que recibe los SKUs, y configurar el nodo de Email para que los use.
1. Nodo de Inyectar (por donde van a entrar los SKUs)
En el Flow, agregá o abrí el Nodo de Inyectar por donde van a ingresar los perfiles a la campaña.
Copiá la URL que te ofrece el nodo con el botón Copiar URL (ya trae el identificador de esta campaña puntual).
Generá un token en Preferencias → Tokens, con la colección Campaña.
Pasale esa URL y ese token a tu equipo técnico o al del cliente, junto con el detalle de los campos
products_primary/products_complementary.
2. Nodo de Email (para que la vitrina use esos productos)
Abrí el nodo de Email de esa misma campaña.
En la configuración del contenido, seleccioná Contenido Dinámico.
3. Elegí Recomendación externa (podés seleccionarla tanto en la vitrina principal como en la complementaria, o en ambas).
4. No hay ninguna configuración adicional que completar: no elegís cantidad, filtros ni orden manualmente, porque eso ya lo define el sistema externo del cliente al inyectar los SKUs.
5. Guardá el nodo como cualquier otro.
¿Qué pasa al momento del envío?
Growlat busca la última inyección de SKUs que recibió ese perfil para esa campaña.
Toma los SKUs correspondientes a la vitrina configurada (principal o complementaria).
Si algún SKU no existe o no está completo en el catálogo, simplemente no se muestra (no rompe el envío).
Si el perfil nunca recibió SKUs inyectados para esa campaña, la vitrina queda vacía.
Preguntas frecuentes
¿Puedo usar esta estrategia sin que el cliente tenga integración propia?
No. Sin que alguien inyecte los SKUs por API, la vitrina va a quedar siempre vacía.
¿Puedo combinarla con otras estrategias en la misma campaña?
Sí, podés usar "Recomendación externa" en una vitrina (por ejemplo la principal) y una estrategia habitual de Growlat en la otra (la complementaria), o viceversa.¿Qué pasa si el cliente inyecta productos dos veces para el mismo contacto? Se usa siempre la inyección más reciente.
¿Necesito coordinar algo con el equipo de soporte de Growlat antes de activarla?
No para el uso básico: ya está disponible en la plataforma. Si tenes un caso particular (grandes volúmenes, dudas sobre el formato del request), escribinos un email al equipo de soporte.