Entender la sincronización de datos de Shopify con Brevo

Tajo lleva los datos de Shopify a Brevo de dos formas. La app de Shopify de Tajo procesa los webhooks de Shopify a medida que llegan. Las reglas de sincronización están aprobadas por humanos, son unidireccionales, se ejecutan por lotes y quedan registradas de principio a fin. Este artículo explica ambas, qué no incluyen y las pocas cosas que la app de Shopify de Tajo escribe de vuelta en Shopify.

Comprobación rápida Este artículo asume que ya conectaste Shopify y Brevo y publicaste al menos una regla de sincronización. Si no, empieza por conectar Tajo a Shopify.

A medida que ocurren los eventos: la app de Shopify de Tajo

La app de Shopify de Tajo se suscribe a los webhooks de Shopify y procesa cada uno a medida que llega. Los cambios de clientes y productos esperan antes unos cuatro segundos. Los clientes, pedidos, checkouts, productos, colecciones y niveles de stock llegan a Brevo por esta vía, junto con eventos como order_paid y cart_abandoned. La guía de integración con Shopify enumera cada tema y lo que escribe en Brevo.

La forma de una regla de sincronización

Una regla de sincronización es una definición revisada y aprobada de exactamente qué se mueve y cómo. Un agente la construye a partir de tu descripción y una persona la aprueba. Una regla tiene cuatro partes que puedes inspeccionar en su página, en Connections > Syncs and mappings:

Parte	Qué hace
Asignación de campos	Cada campo de origen, el campo de Brevo en el que escribe y cualquier transformación intermedia
Expresión de filtro	Se evalúa por registro; los registros que no coinciden se omiten
Cursor	Registra hasta dónde ha avanzado la sincronización, para que cada ejecución continúe donde se detuvo la anterior
Historial de ejecuciones	Cada ejecución, con los registros leídos, escritos y fallidos, además de duración y estado

Una regla de sincronización mueve los datos en una sola dirección: desde tu origen hacia Brevo. Nunca escribe en Shopify. La app de Shopify de Tajo sí escribe de vuelta algunas cosas en Shopify, como las bajas por consentimiento y las etiquetas de nivel de fidelidad. Los permisos de Shopify explicados enumeran cada escritura y cuándo ocurre.

Cuándo se ejecuta una regla de sincronización

Las reglas de sincronización se ejecutan por lotes. Las reglas de sincronización de contactos se ejecutan cada 15 minutos por defecto. Una regla Shopify orders → Brevo orders activa y publicada también se ejecuta cada 15 minutos, pero solo con el filtro de consentimiento de marketing del comprador que trae la plantilla. Una regla cuyo filtro se ha editado solo se ejecuta cuando la inicias tú. La primera ejecución programada de una regla de pedidos empieza unos minutos antes de ese momento y no envía pedidos más antiguos. Cada ejecución posterior envía los pedidos actualizados desde la ejecución anterior. Los pedidos anteriores solo llegan a Brevo cuando ejecutas tú la regla. La página de una regla activa tiene un botón Test run (1 batch), y el agente Sync Operator ejecuta las reglas activas cuando se lo pides. Las ejecuciones por lotes son lo que hace que cada escritura sea revisable, presupuestada y atribuible a una ejecución concreta.

Cada ejecución lee los registros nuevos y modificados desde el cursor, aplica el filtro, asigna los campos y escribe en Brevo. El registro de la ejecución muestra exactamente cuántos registros se leyeron, se escribieron y fallaron.

Las garantías de gobernanza

El consentimiento bloquea por defecto

Una regla que escribe datos personales en Brevo no puede publicarse sin el filtro de consentimiento y supresión. En tiempo de ejecución, se rechaza un contacto que se escribiría en una audiencia de marketing sin consentimiento demostrable. Cuando el consentimiento no puede establecerse, Tajo rechaza la escritura en lugar de adivinar. El modo de fallo es siempre “demasiado prudente”, nunca “envié de más”.

Las ejecuciones son idempotentes

Cada escritura lleva una clave derivada del registro de origen. La clave es un hash, así que no contiene datos personales. Volver a ejecutar una sincronización sobre los mismos registros, tras un fallo, una pausa o a mano, no crea escrituras duplicadas.

Todo queda auditado

La publicación de una regla, las aprobaciones invalidadas y las pausas automáticas quedan registradas en Activity. Cada decisión de aprobación lleva una justificación escrita. Cada ejecución queda registrada en el historial de ejecuciones de la regla. La aprobación que autorizó una publicación queda vinculada a un digest de la regla exacta que se previsualizó. Editar la regla la devuelve a borrador e invalida la aprobación, así que lo que se ejecuta es siempre lo que se autorizó.

Los fallos pausan la regla

Si cinco ejecuciones consecutivas fallan, un cortacircuitos pausa la regla automáticamente y muestra el último error en la página de la regla. Corrige la causa y vuelve a publicar para reanudar. Una ejecución parcialmente fallida informa su recuento de fallos para que veas exactamente qué no llegó.

Cómo se respetan las bajas de suscripción

Cuando un contacto se da de baja mediante el enlace del pie de un email de Brevo, esa exclusión queda registrada en el contacto y Brevo lo excluye de campañas futuras.
En la sincronización de clientes por lotes, la app de Shopify de Tajo compara la hora del consentimiento en Shopify con la hora de la baja en Brevo y conserva la más reciente.
Un cambio de consentimiento que llega desde Shopify como webhook se escribe en Brevo tal como lo informa Shopify.
Si el contacto estaba suscrito en Shopify, la app de Shopify de Tajo también lo marca como dado de baja en Shopify. Un evento de Brevo solo mueve a un cliente de suscrito a dado de baja. Nunca suscribe a nadie, así que una suscripción en Brevo no cambia nada en Shopify.

Qué datos están disponibles

La app de Shopify de Tajo envía contactos, pedidos, eventos de pedidos y de carrito, el catálogo de productos y el stock. Lo que envía una regla de sincronización depende de su asignación de campos. Para los clientes de Shopify, la plantilla asigna los campos de identidad, el gasto total, el número de pedidos, las etiquetas y el opt-in a atributos de contacto de Brevo que puedes usar en segmentos y campañas. La asignación exacta de tu espacio de trabajo no está escondida en una descripción: abre la regla de sincronización y lee la tabla de asignación de campos. Esa tabla es la respuesta autorizada a “qué se sincroniza”.

Qué no hace Tajo hoy

Ser precisos con los límites importa más que una larga lista de funciones:

Sin reglas de sincronización bidireccionales. Una regla de sincronización solo escribe en Brevo. Las escrituras propias de la app de Shopify en Shopify (bajas por consentimiento, metacampos de interacción y fidelidad de Brevo, etiquetas de nivel de fidelidad) se enumeran en los permisos de Shopify explicados.
Sin reglas de sincronización en tiempo real. Las reglas de sincronización se ejecutan por lotes. Solo la sincronización por webhooks de la app de Shopify de Tajo funciona a medida que llegan los eventos.
Sin botón de aviso de reposición. La app mantiene actualizado el stock de productos en Brevo y envía un evento back_in_stock a los compradores que pidieron que se les avisara. La solicitud tiene que venir de tu tienda: la app no añade un botón “Notify me” a tu tema.

Si alguno de estos límites bloquea un caso de uso para ti, díselo al equipo: las prioridades del acceso anticipado se definen exactamente con este tipo de comentarios.

Dónde ver tus datos

En Tajo: abre la regla de sincronización en Connections > Syncs and mappings para ver el historial de ejecuciones, la posición del cursor y los recuentos por ejecución. Activity recoge las publicaciones y las pausas automáticas.
En Brevo: abre Contactos e inspecciona los atributos de cualquier contacto para confirmar que los campos asignados se están rellenando. Crea segmentos sobre esos atributos para dirigir tus envíos.

Solución de problemas

Contactos que no aparecen en Brevo: revisa la última ejecución de la regla en busca de fallos y su estado (una regla pausada no se ejecuta). Consulta contactos que no aparecen en Brevo.
Ejecuciones que fallan repetidamente: el cortacircuitos pausará la regla y mostrará el último error. Consulta los datos no se sincronizan.
Contactos duplicados: las escrituras son idempotentes por registro de origen, pero los duplicados preexistentes en Brevo permanecen. Consulta contactos duplicados.

Preguntas frecuentes

¿Puedo hacer la sincronización más rápida? La página de una regla activa tiene un botón Test run (1 batch). Para los cambios a medida que ocurren, la sincronización por webhooks de la app de Shopify de Tajo ya cubre clientes, pedidos, checkouts, productos y stock.

¿Qué pasa si una ejecución falla a medias? La ejecución informa su recuento de fallos, el cursor solo avanza sobre lo procesado y la siguiente ejecución vuelve a cubrir el terreno con seguridad: las claves de idempotencia evitan duplicados.

¿Puedo cambiar qué se sincroniza? Sí. Pide al agente que cambie la asignación de campos o el filtro de la regla. La edición devuelve la regla a borrador, y debe volver a pasar por la previsualización y la aprobación antes de ejecutarse de nuevo.

¿Por qué mi regla se pausó sola? Los fallos consecutivos de ejecución activan el cortacircuitos. La página de la regla muestra el número de fallos y el último error; corrige el problema y vuelve a publicar.

Obtener ayuda

Contacta con el equipo.