Ir al contenido principal

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

Guía técnica para conectar tu formulario por VTEX (Master Data) o código propio (API), como alternativa a Google Tag Manager.


VTEX (vía Master Data)

Paso 1 — Configurar el trigger en Master Data

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

  2. Creá un nuevo trigger.

Crear nuevo trigger en Master Data

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".

Condición: un registro fue creado

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

Programación del trigger

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: cache-control: no-cache y content-type: application/json

Content as JSON:

{    "app": "TU_CLAVE_PUBLICA",    "email": "{!email}",    "event": "tu-evento",    "tags": ["tu-evento"]}

Configuración del HTTP request en Master Data

Notas: la sintaxis de los placeholders en VTEX usa llaves con signo de exclamación ({!nombredelcampo}). tags admite múltiples valores separados por comas.

Guardá y activá el trigger.

Paso 3 — Probar la conexión

  1. Hacé una prueba en tu formulario con un email que no exista en tu base (si ya existe, la campaña no se dispara — es una bienvenida para altas nuevas).

  2. Andá al módulo de Campañas → Automatizadas → tu campaña de Bienvenida Inmediata → confirmá que está activa → Ver.

Ver campaña de Bienvenida Inmediata

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

Evento recibido


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.

POST https://events.woowup.com/events/usersContent-Type: application/json{  "app": "TU_CLAVE_PUBLICA",  "email": "{email_del_suscriptor}",  "event": "tu-evento",  "tags": ["tu-evento"]}

Ejemplo con JavaScript + jQuery:

<!DOCTYPE html><html lang="es"><head>    <meta charset="UTF-8">    <title>Mi 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": "TU_CLAVE_PUBLICA",                "email": "{email_del_suscriptor}",                "event": "tu-evento",                "tags": ["tu-evento"]            })        };        $.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: igual que en el otro método — usá un email que no exista en tu base, y confirmá en Campañas → Automatizadas → tu campaña → Ver, que el evento fue recibido.


¿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 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".

¿Ha quedado contestada tu pregunta?