ℹ️ Requisito previo (para todos los métodos): ya tenés que haber creado la campaña de Bienvenida Inmediata y su evento en WoowUp. La key del evento que se generó ahí es la que vas a usar abajo en el campo event. Si todavía no la creaste, seguí primero la Sección 3 del artículo principal.

Todos los métodos apuntan al mismo endpoint:

POST https://events.woowup.com/events/users

y el cuerpo mínimo obligatorio es siempre el mismo: app (tu Clave Pública), email y event (la key de tu campaña). Sin alguno de los tres, el disparo no ocurre.

VTEX (vía Master Data)

Paso 1 — Configurar el trigger en Master Data

Ingresá a Dynamic Storage (DS) en http://TIENDA.ds.vtexcrm.com.br/ (reemplazá TIENDA por el nombre de tu tienda).
Creá un nuevo trigger.

3. Configurá los parámetros del trigger:

Entidad de datos: Cliente (o la entidad personalizada donde se guardan los registros del newsletter de tu ecommerce).
Condición: "Un registro fue creado".

Programación: "Ejecutar lo más rápido posible".

Paso 2 — Configurar el envío a WoowUp

En la pestaña If Positive, configurá la acción Send an HTTP request, con estos datos:

Método: POST
URL: https://events.woowup.com/events/users
Headers:

Name	Value
cache-control	no-cache
content-type	application/json

json

{
"app": "CLAVE_PUBLICA_WOOWUP",
"email": "{!email}",
"event": "formulario-footer",
"tags": "ecommerce,newsletter,formulario-footer"
}

Configuración del HTTP request en Master Data

Notas:

La sintaxis de los placeholders usa llaves: {!nombredelcampo}.

tags admite múltiples valores separados por comas.

Guardá y activá el trigger.

Shopify (vía Flow)

Shopify Flow permite disparar el evento desde el backend cada vez que alguien se suscribe, sin tocar el código del theme. Es el equivalente al trigger de VTEX.

WoowUp ya tiene una guía con un flujo pre-armado para importar en Shopify Flow, que hace justo esto. Para conectar el flujo, seguí esa guía: 📄 Configurar Newsletter en Shopify (incluye el archivo .flow listo para importar y los pasos para instalar Flow, importar el flujo, cargar tu clave y activarlo).

Esa guía deja el registro llegando a WoowUp. Para que además dispare la Bienvenida Inmediata, hay que agregar un solo campo al flujo: el campo event.

Cómo agregar el event (el paso que falta para la Inmediata)

En el flujo importado, entrá a edit → Send HTTP request (el mismo paso donde reemplazás la clave pública) y sumá event y tags al Body del request. El body tiene que quedar así:

json
{
    "app": "TU_CLAVE_PUBLICA",
    "email": "{{customer.email}}",
    "event": "formulario-footer",
    "tags": ["formulario-footer"]
}

Reemplazá TU_CLAVE_PUBLICA por tu Clave Pública y formulario-footer por la key de tu campaña de Bienvenida Inmediata.
En Shopify Flow los placeholders usan sintaxis Liquid con doble llave: {{customer.email}} (ese ya viene en el flujo importado).

⚠️ Sin el campo event, el flujo crea el contacto pero NO dispara la Bienvenida Inmediata

Guardá y activá el flujo. Después, probá la conexión con la sección "Probar la conexión" de más abajo.

Código propio (Developer)

Para equipos de marketing con desarrollo propio: se agrega el request directamente en el sitio, escuchando el envío del formulario por JavaScript, o desde el backend.

 
# Enviar a WoowUp cada vez que alguien completa el formulario
POST https://events.woowup.com/events/users
Content-Type: application/json
 
{
  "app": "XXXXXXX", // Tu clave Publica
  "email": "{email_del_suscriptor}",
  "event": "formulario-footer",
  "tags": ["formulario-footer"]
}

Ejemplo de un formulario integrado usando Javascript y jquery.

<!DOCTYPE html>
<html lang="es">
<head>
    <meta charset="UTF-8">
    <title>My Ecommerce</title>
    <script src="https://code.jquery.com/jquery-2.2.4.min.js"></script>
    <script>
        var settings = {
            "async": true,
            "crossDomain": true,
            "url": "https://events.woowup.com/events/users",
            "type": "POST",
            "headers": {
                "cache-control": "no-cache",
                "content-type": "application/json"
            },
            "data": JSON.stringify({
                "app": "XXXXXXX", // Tu clave pública
                "email": "{email_del_suscriptor}",
                "event": "formulario-footer",
                "tags": ["formulario-footer"]
            })
        };

        $.ajax(settings).done(function (response) {
            console.log(response);
        }).fail(function (error) {
            console.log(JSON.stringify(error));
        });
    </script>
</head>
<body>
</body>
</html>

Consideración: la Clave Pública está disponible para usuarios con rol SuperAdmin en WoowUp, en Configuración → Mi cuenta → Clave Pública.

Probar la conexión

Haz una prueba de tu formulario de newsletter con un Email de prueba. El email no debe existir en tu base o la campaña no se disparará (es una bienvenida a registros nuevos).
Luego ingresa al modulo de Campañas.
Encuentra en el listado de Automatizadas tu campaña de Bienvenida Inmediata, asegurate de que está activa y haz click en el botón Ver.

4. Revisá que el evento del registro fue recibido.

5. Confirmá en el Timeline del Perfil 360 de ese contacto de prueba que el evento aparece.

¿Qué datos se pueden enviar desde el formulario?

El body mínimo solo necesita app, email y event — sin alguno de los tres, el disparo no ocurre. Pero podés sumar más campos (teléfono, nombre, apellido, fecha de nacimiento, etc.) para enriquecer el perfil o personalizar el mensaje, sea cual sea el método de conexión que estés usando (VTEX, Shopify o código propio).

📄 Tabla completa de campos disponibles y ejemplo de cómo sumarlos al JSON: sección "Campos adicionales que podés enviar" del artículo "Bienvenida Inmediata: cómo implementarla en tu formulario web".

Bienvenida Inmediata: conectar tu formulario por VTEX, Shopify o código propio

VTEX (vía Master Data)

Shopify (vía Flow)

Código propio (Developer)

Probar la conexión

¿Qué datos se pueden enviar desde el formulario?