Paso 1: Acceder a la Configuración
Navegue hasta la sección de Configuración (o el ícono de engranaje) en su panel de control de Brevo.
Paso 2: Ir a SMTP y API
Dentro del menú de Configuración, localice y haga clic en la opción SMTP y API.
Paso 3: Buscar la Sección de Clave API
Una vez en la página de SMTP y API, busque la sección o pestaña etiquetada como Clave API o similar.
Paso 4: Generar la Clave API
Haga clic en el botón Generar una nueva clave API o Crear una clave API.
Se le pedirá que asigne un nombre a la clave (por ejemplo: "OmniwalleT").
Una vez generada, la Clave API se mostrará en pantalla. Cópiela inmediatamente, ya que por motivos de seguridad, no podrá verla de nuevo una vez que cierre la ventana.
Esta Clave API generada será la que debe ingresar en la configuración de Brevo dentro de la plataforma Omniwaller para completar la integración.
Creación de Atributos de Contacto en Brevo para OmniwalleT
A continuación, se detalla el proceso para crear los atributos de contacto personalizados en Brevo que serán utilizados por la plataforma Omniwaller.-----Pasos para Crear Atributos de Contacto
Siga las instrucciones a continuación en su cuenta de Brevo:
Paso 1: Acceder a Configuración y Contactos
Vuelva a la sección de Configuración (o el ícono de engranaje) en su panel de control de Brevo. Luego, navegue hasta la sección de Contactos dentro del menú de configuración.
Paso 2: Ir a Atributos de Contacto
Dentro de la sección de Contactos, localice y haga clic en la opción Atributos de Contacto o similar.
Paso 3: Crear los Nuevos Atributos
Una vez en la página de Atributos, haga clic en el botón para Crear un nuevo atributo. Deberá crear cada uno de los siguientes atributos con su tipo de dato correspondiente:
Nota: Es crucial que los nombres de los atributos sean exactos para asegurar una correcta sincronización con Omniwallet
.
Creación de Segmentos en Brevo para OmniwalleT
A continuación, se detalla el proceso para crear los segmentos de contacto personalizados en Brevo utilizando el atributo LEVEL previamente configurado.
Pasos para Crear un Segmento
Siga las instrucciones a continuación en su cuenta de Brevo:
Paso 1: Acceder a CRM y Segmentos
Navegue en el panel de control de Brevo hasta la sección de CRM y luego seleccione la opción Segmentos.
Paso 2: Crear un Segmento
Haga clic en el botón para Crear Segmentos (o similar) para iniciar el proceso de definición de su nuevo segmento.
Paso 3: Definir la Condición del Segmento
Utilizará el campo LEVEL de informacion de contacto de Omniwallet.
Defina la condición según los niveles que tenga establecidos en su plataforma. Por ejemplo, si desea crear un segmento para el nivel Bronze:
Seleccione el atributo LEVEL.
Elija la condición de coincidencia (por ejemplo, "es igual a").
Ingrese el valor del nivel, por ejemplo, bronze.
Paso 4: Finalizar la Creación
Asigne un nombre claro al segmento (por ejemplo: "Nivel - Bronze") y guarde la configuración. Una vez creado, los contactos que cumplan con la condición definida (en este caso, tener el valor "bronze" en su atributo LEVEL) se agregarán automáticamente al segmento.-----
Creación de Automatizaciones (Escenarios) en Brevo para Omniwallet
Pasos para Crear una Automatización
Siga las instrucciones a continuación en su cuenta de Brevo:
Paso 1: Acceder a Automatizaciones y Escenarios
Navegue en el panel de control de Brevo hasta la sección de Automatizaciones y luego seleccione la opción Escenarios.
Paso 2: Crear una Automatización
Haga clic en el botón para Crear una automatización (o similar) para iniciar la definición de su nuevo escenario.
Paso 3: Definir el Escenario (Ejemplo: Nivel Bronze)
Para crear una automatización para el nivel Bronze:
Punto de Entrada (Trigger): Seleccione un punto de entrada que se active cuando un contacto ingrese al segmento "Nivel - Bronze" que creó anteriormente.
Acción: Defina las acciones que desea que se ejecuten. Por ejemplo, enviarles un correo electrónico de bienvenida exclusivo para clientes Bronze o agregarles a una lista de marketing específica.
Finalizar: Asigne un nombre claro (ejemplo: "Automatización Nivel Bronze") y active el escenario.
Paso 4: Definir el Escenario (Ejemplo: Order Completa)
Para crear una automatización para una Order Completa:
Una vez activadas, las automatizaciones se ejecutarán automáticamente cada vez que se cumplan las condiciones del punto de entrada.
Mejores Instrucciones para Crear una Automatización con Evento Personalizado (Order Completa)
A continuación, se detalla el proceso para crear una automatización (Escenario) que se activa mediante un evento transaccional personalizado, como "Omniwallet Order Completed", y cómo acceder a los datos de dicho evento.
Pasos para Crear una Automatización (Evento Transaccional)
Paso 1: Acceder a Automatizaciones y Escenarios
Navegue en el panel de control de Brevo hasta la sección de Automatizaciones.
Seleccione la opción Escenarios.
Haga clic en el botón para Crear una automatización (o similar).
Paso 2: Elegir el Punto de Entrada (Trigger)
En la configuración del nuevo escenario, seleccione la opción de "Un evento de transacción sucede" (o similar, en la sección de "Eventos").
Buscar y Seleccionar el Evento: Ingrese el nombre de su evento personalizado, por ejemplo, omniwallet_order_completed (o el nombre exacto que haya configurado para la sincronización desde Omniwallet).
Opcionalmente, puede definir una condición para el evento (por ejemplo, que el total del pedido sea mayor a 100).
Paso 3: Definir la Acción (y Acceder a los Datos del Evento)
Una vez definido el punto de entrada, haga clic en el signo (+) para agregar una acción (por ejemplo, "Enviar un email").
Personalización con Datos del Evento: Al diseñar el contenido de la acción (por ejemplo, la plantilla de email), puede acceder a los datos específicos que desencadenaron el evento utilizando la sintaxis Liquid:
Acceder a Parámetros del Evento: Para acceder a cualquier dato pasado con el evento (como el total del pedido, ID de la transacción, etc.), use:
{{ params.NOMBRE_DEL_PARAMETRO }}
Ejemplo para Ítems de la Orden (Matriz): Si el evento incluye una lista de productos (una matriz llamada items), puede acceder a los detalles específicos de cada producto:
{{ params.items.0.product_name }}
(Muestra el nombre del primer producto en la lista).
Paso 4: Finalizar y Activar el Escenario
Complete las acciones restantes de su flujo (por ejemplo, agregar un delay o actualizar un atributo de contacto).
Asigne un nombre claro (ejemplo: "Automatización Order Completa") y active el escenario.
Una vez activo, el escenario se ejecutará automáticamente cada vez que Brevo reciba el evento omniwallet_order_completed con los datos de la orden.
Uso de Liquid para Atributos de Contacto y Eventos en Brevo
Para personalizar el contenido de correos electrónicos, plantillas o mensajes dentro de Brevo, puede utilizar el lenguaje de plantillas Liquid para acceder a los atributos de contacto y a los datos de eventos transaccionales sincronizados desde Omniwallet.
1. Atributos de Contacto
Los atributos de contacto se utilizan para personalizar la información de cada destinatario. Para acceder a un atributo de contacto, se usa la sintaxis {{ contact.NOMBRE_DEL_ATRIBUTO }}.
Ejemplo de Puntos de Lealtad: Para mostrar el valor del atributo POINTS, use:
{{ contact.POINTS }}
Ejemplo de Nivel de Contacto: Para mostrar el valor del atributo LEVEL, use:
{{ contact.LEVEL }}
2. Variables de Eventos Transaccionales (Parámetros)
Cuando se utilizan eventos transaccionales (como el de "Order Completa"), los datos adicionales del evento se pasan como parámetros. Para acceder a estos datos, se utiliza la sintaxis {{ params.NOMBRE_DEL_PARAMETRO }}. Si el parámetro es una matriz (una lista de elementos, como productos en un pedido), se debe especificar la posición y el sub-atributo.
Ejemplo de Nombre de Producto en una Orden: Para acceder al nombre del primer producto en la lista de ítems (items) de un evento de transacción, use:
{{ params.items.0.product_name }}
(Donde items es la matriz de productos, 0 es el índice del primer elemento de la matriz y product_name es el atributo del producto).
-----