Cuando necesitas conectar tu formulario de registro al evento de Bienvenida Inmediata sin utilizar Google Tag Manager, WoowUp ofrece tres alternativas:

Configurar un trigger en VTEX (vía Master Data)
Utilizar Shopify Flow
Implementar la llamada directamente desde tu código propio (JavaScript o backend)

ℹ️ Requisito previo (para todos los métodos)

❗ Antes de empezar: ya debes 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 utilizar en el campo event de los ejemplos de abajo. Si todavía no la creaste, sigue primero la Sección 3 del artículo principal: Bienvenida Inmediata: cómo implementarla en tu formulario web.

Endpoint y payload mínimo

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_PUBLICA",
  "email": "email_del_suscriptor",
  "event": "TU_KEY_DE_EVENTO",
  "tags": ["nombre-de-tu-formulario"]
}

❗Los tres campos app, email y event son obligatorios. Sin alguno de los tres, el disparo no ocurre. El campo tags es opcional pero muy recomendado: etiqueta al perfil con el origen del registro para que puedas segmentarlo

VTEX (vía Master Data)

Paso 1: Configurar el trigger en Master Data

Ingresa a Dynamic Storage (DS) en http://TIENDA.ds.vtexcrm.com.br/ (reemplaza TIENDA por el nombre de tu tienda).
Crea un nuevo trigger.

3. Configura 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, configura 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": "TU_CLAVE_PUBLICA",
  "email": "{!email}",
  "event": "TU_KEY_DE_EVENTO",
  "tags": ["nombre-de-tu-formulario"]
}

Configuración del HTTP request en Master Data

Notas sobre VTEX

La sintaxis de los placeholders usa llaves: {!nombredelcampo}. Por ejemplo, {!email} toma el email del registro.
Reemplaza TU_CLAVE_PUBLICA por tu Clave Pública, TU_KEY_DE_EVENTO por la key del evento de tu campaña, y nombre-de-tu-formulario por un nombre descriptivo (por ejemplo, formulario-footer).
tags debe ir como array (con corchetes). También admite múltiples valores: ["ecommerce", "newsletter", "formulario-footer"].

Paso 3: Guarda y activa 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.

¿Cómo conectar este flujo?

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, debes agregar un solo campo al flujo: el campo event.

¿Cómo agregar el `event`?

En el flujo importado, entra a Edit → Send HTTP request (el mismo paso donde reemplazaste la clave pública).
Suma event y tags al Body del request. El body debe quedar así:

{
  "app": "TU_CLAVE_PUBLICA",
  "email": "{{customer.email}}",
  "event": "TU_KEY_DE_EVENTO",
  "tags": ["nombre-de-tu-formulario"]
}

Reemplaza TU_CLAVE_PUBLICA por tu Clave Pública, TU_KEY_DE_EVENTO por la key del evento de tu campaña, y nombre-de-tu-formulario por un nombre descriptivo
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

Guarda y activa el flujo. Después, prueba la conexión con la sección descripta aquí.

Código propio (Developer)

Para equipos 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"]
}

Reemplaza TU_CLAVE_PUBLICA, TU_KEY_DE_EVENTO y nombre-de-tu-formulario por tus valores reales.

Ejemplo con JavaScript y jQuery

<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_KEY_DE_EVENTO",
      "tags": ["nombre-de-tu-formulario"]
    })
  };

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

👉 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

Una vez configurado cualquiera de los métodos anteriores, sigue estos pasos para verificar que todo funciona:

1. 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).

2. Luego ingresa al modulo de Campañas.

3. 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. Revisa el semáforo de eventos: indica si el evento está llegando correctamente y cuántos se han recibido. Si el semáforo muestra "recibiendo", la conexión está funcionando.

5. Confirma que el evento del registro fue recibido en el detalle de la campaña.

6. Confirma 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. Pero puedes sumar más campos para enriquecer el perfil o personalizar el mensaje, sin importar 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 puedes enviar" del artículo "Bienvenida Inmediata: cómo implementarla en tu formulario web".

A tener en cuenta

❗La Bienvenida Inmediata solo dispara cuando se crea un perfil nuevo. Si el email ya existe en la base de WoowUp (por ejemplo, por una compra anterior, un carrito abandonado o una importación), el evento se registra en el Timeline pero la campaña no se envía. Es una bienvenida a registros nuevos.

Buenas prácticas

Utiliza siempre el formato array (con corchetes) para el campo tags, tanto en VTEX como en Shopify y código propio: "tags": ["formulario-footer"].
Elige un nombre de tag descriptivo que identifique el origen del registro. Esto te permitirá segmentar fácilmente a estos contactos en WoowUp.
Si tienes más de un formulario (por ejemplo, footer y popup), crea un evento distinto y una campaña distinta para cada uno.

FAQ

¿Puedo utilizar los tres métodos a la vez?

No es necesario. Elige el método que mejor se adapte a tu stack técnico. Solo necesitas uno para que la Bienvenida Inmediata funcione.

¿El campo event tiene que coincidir exactamente con la key generada en WoowUp?

Sí, debe ser exactamente la misma key que se generó al crear el evento en la campaña. Si hay un error de tipeo o una diferencia, el evento no se asociará a la campaña y el envío no se disparará.

¿Qué pasa si ya usaba el endpoint events/users para crear perfiles pero sin el campo event?

En ese caso, la Bienvenida Inmediata no se dispara porque falta el evento. Para activarla, debes crear una nueva campaña de este tipo, generar el evento, y actualizar tu implementación agregando el campo event al payload.

¿Las importaciones CSV disparan la Bienvenida Inmediata?

No. Las importaciones no incluyen eventos, por lo tanto la campaña no se dispara. Solo afecta a las campañas de Bienvenida clásica (segmentada), que se basan en la fecha de creación del perfil.

¿Qué canales están disponibles para Bienvenida Inmediata?

Email y SMS. WhatsApp no está disponible por ahora en este trigger.

¿Necesito un desarrollador para implementar esto?

Depende del método. En VTEX necesitas acceso al Master Data. En Shopify necesitas acceso a Shopify Flow. En código propio, necesitas un desarrollador o agencia que pueda agregar la llamada a tu sitio. Si prefieres una opción sin código técnico, considera usar Google Tag Manager.

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