Sincronización con Joinotify Cloud

La Sincronización en la nube de Joinotify manda los clientes y los eventos de este sitio a tu cuenta de Joinotify, donde se convierten en contactos y disparan los flujos de Cloud. Es lo que une la tienda a las campañas, al inbox y a las audiencias del panel.

Viene desactivada. Se activa en Configuraciones → General, con el botón Configurar para las opciones, o en la pestaña Fuentes de Audiencias y Contactos. La ventana de configuración dice exactamente qué se envía antes de que la actives.

Qué se envía

Cada pedido sale con el historial de compras del cliente (cuántos pedidos, cuánto gastó, primera y última compra) y los enlaces de pagar, ver y valorar. «Creado» y «pagado» salen una vez por pedido, por mucho que cambie el estado, y un fallo al montar un evento nunca interrumpe el checkout.

En la misma ventana puedes dejar fuera formularios, carritos, artículos del pedido y direcciones completas (la ciudad y el estado van siempre), y marcar todo contacto con el nombre del sitio o con una etiqueta tuya. Cada opción de la ventana, con su valor predeterminado, está en Conectar WordPress y WooCommerce; la lista exacta de lo que lleva cada envío está en la sección External services del readme.txt del plugin.

Cómo salen los eventos

No se envía nada durante un checkout ni durante la carga de una página. Los eventos entran en una cola en una tabla propia y salen en lotes, mediante una tarea programada. Un lote que falla espera y lo vuelve a intentar.

La sincronización se pausa sola — en lugar de mandar pedidos de prueba a clientes reales — cuando:

• la clave de la API fue revocada;
• el sitio se eliminó del panel;
• el sitio parece ser una copia en otra dirección (un staging clonado de producción, por ejemplo).

La ventana de la sincronización muestra si está activada, por qué se pausó (con el botón Intenta de nuevo), cuántos eventos esperan, cuántos salieron y de cuántos desistió — que se pueden reenviar o descartar.

Enviar los clientes que ya existen

Enviar clientes existentes manda, una sola vez, los usuarios y los compradores sin cuenta que ya tiene la tienda, con el historial de pedidos y sin iniciar ningún flujo. Antes de confirmar, la pantalla muestra cuántos se enviarían. El envío se ejecuta en segundo plano, en etapas que se reanudan después de un fallo, y al final dice cuántos salieron, cuántos quedaron fuera por no tener teléfono y cuántos frenó el límite de contactos de tu plan.

Consentimiento de marketing

También desactivado por defecto. Cuando está activado, una casilla desmarcada, con el texto que escribas, aparece en el checkout clásico y en el de bloques, en los formularios de registro y en Mi cuenta.

• Quien la marca queda registrado como opt-in en Joinotify, con el texto de la casilla, dónde y cuándo, como evidencia.
• Quien la desmarca en Mi cuenta pasa a opt-out allí también.
• Un opt-in o un opt-out hecho en Joinotify actualiza la preferencia del cliente en el sitio.
• En el checkout de bloques, un cliente que ya aceptó ve la casilla marcada, y lo que envíe en ella no cambia el consentimiento que ya dio.

Los formularios de WPForms y de Elementor pueden tener una regla propia que indica qué casilla es el consentimiento — consulta Audiencias y Contactos.

Datos personales

Las herramientas Exportar datos personales y Borrar datos personales de WordPress cubren la sincronización: los registros de consentimiento y los eventos de la persona que siguen en la cola. Borrar también pide a Joinotify que borre los contactos que este sitio le envió.

Desactivar la sincronización lo detiene todo en el acto. Lo que ya se recibió sigue en tu cuenta de Joinotify, donde los contactos se pueden borrar.

Para desarrolladores

joinotify_track() pone en cola un evento tuyo, que llega a los flujos de Cloud por la misma cola. El nombre es custom. seguido de uno a tres segmentos [a-z0-9_]; la función devuelve el id del evento, o false cuando la sincronización está desactivada o el nombre está fuera del espacio custom.*.

joinotify_track(
    'custom.presupuesto.solicitado',
    array( 'presupuesto' => array( 'id' => 991, 'total' => '1290.00' ) ), // en los flujos: {{trigger.presupuesto.total}}
    array(                                                                // opcional: de quién es el evento
        'ref'        => array( 'kind' => 'wp_user', 'id' => (string) $user_id ),
        'phone'      => '+5541987654321',
        'email'      => '[email protected]',
        'first_name' => 'Ana',
    )
);

Sin ref, el evento se registra pero no llega a ningún contacto. El kind es wp_user, wc_customer, wc_guest o lead; en los dos últimos el id tiene que ser un hash (el plugin usa el SHA-256 del correo en minúsculas), nunca un dato personal en claro.

La acción Joinotify/Cloud_Sync/Ready se dispara cuando la sincronización está activada y escuchando — es donde colgar tus propios emisores. Cómo llegan los eventos a Cloud y se convierten en disparador de flujo está en Eventos del sitio.