Guía práctica
Conecta tu sitio WooCommerce a Casa Signals
Instala el conector de WordPress de Casa Signals, genera la clave API del sitio, activa el seguimiento y confirma que los eventos de WooCommerce llegan al panel.
Antes de empezar
- Una cuenta de Casa Signals.
- Una tienda WooCommerce en la que puedas iniciar sesión como administrador de WordPress.
Qué tendrás al terminar
- Existe una conexión WordPress Plugin en Casa Signals para el sitio correcto.
- La clave API de Casa Signals queda guardada en WordPress.
- El seguimiento de eventos queda activado en el plugin de WordPress.
- Los nuevos eventos de WooCommerce empiezan a aparecer en analítica, líneas de tiempo de clientes, informes de productos y disparadores de flujos de Casa Signals.
- Se pueden importar productos, usuarios y pedidos históricos sin disparar automatizaciones en vivo.
Cómo funciona la conexión
Casa Signals se conecta a WooCommerce mediante el plugin de WordPress Customer Event Sync for Casa Signals. El plugin registra actividad importante de WordPress y WooCommerce, encola los eventos dentro de WordPress y los envía a Casa Signals en lotes en segundo plano.
La conexión se autentica con una clave API específica para cada sitio. Cada sitio de Casa Signals tiene su propia clave, por lo que la clave debe salir del mismo registro de sitio que el dominio WooCommerce que estás conectando.
El seguimiento es opcional y debe activarse expresamente. Instalar el plugin no basta por sí solo. La clave API debe estar guardada, el dominio del sitio debe ser correcto y Enable event tracking debe estar activado.
- El sitio existe en Casa Signals.
- El plugin de WordPress está instalado y activo.
- La clave API está pegada en el plugin.
- El seguimiento de eventos está activado.
- La actividad reciente aparece en Casa Signals.
1. Añade el sitio WooCommerce en Casa Signals
Abre el panel de Casa Signals
Inicia sesión en Casa Signals y abre el panel. Si es la primera tienda de la cuenta, el panel mostrará el formulario Add domain.
Introduce el nombre de la tienda
Usa un nombre que tu equipo reconozca, por ejemplo Example Store. Este nombre se usa en todo el panel y puede aparecer en las vistas previas de SMS cuando no hay un Sender ID aprobado.
Introduce el dominio web
Introduce el dominio público que usan los clientes, por ejemplo example.com. No incluyas una ruta de checkout, una ruta de producto, una ruta wp-admin ni parámetros de seguimiento.
Usa el mismo dominio que los clientes usan para navegar y comprar. Si la tienda redirige de www a sin www, o al revés, usa el dominio público final que quieres que Casa Signals trate como la tienda.
Guarda el dominio
Haz clic en Add domain. La tarjeta del sitio aparecerá en el panel con enlaces a Analytics, Customers, Products, Broadcasts, Flows y Settings.
2. Genera la clave API de WordPress Plugin
Abre los ajustes del sitio
Desde el panel de Casa Signals, abre la tarjeta del sitio de la tienda WooCommerce y haz clic en Settings.
Busca el panel WordPress Plugin
En Settings, busca la sección Connection llamada WordPress Plugin. Este panel muestra si la tienda está conectada, permite generar o regenerar la clave API e incluye la descarga del plugin.
Genera la clave
Haz clic en Generate key. Casa Signals crea una nueva clave API para este sitio. Si ya existe una clave y haces clic en Regenerate key, la clave activa anterior de ese sitio se sustituye.
Copia la clave
Haz clic en Copy y ten la clave preparada para WordPress. Trátala como una contraseña. Cualquiera que tenga la clave puede enviar eventos para ese sitio de Casa Signals.
- La clave copiada procede del mismo sitio de Casa Signals que la tienda WooCommerce.
- El estado del sitio muestra Connected o hay una clave API visible.
- El usuario no ha copiado una clave de otro dominio.
3. Descarga e instala el plugin de WordPress
Descarga el conector
En el mismo panel WordPress Plugin, haz clic en Download plugin. El archivo se llama customer-event-sync-casa-signals.zip.
Súbelo a WordPress
En WordPress, ve a Plugins -> Add New Plugin -> Upload Plugin. Elige customer-event-sync-casa-signals.zip y haz clic en Install Now.
Activa el plugin
Después de que WordPress instale el plugin, haz clic en Activate Plugin. El nombre del plugin es Customer Event Sync for Casa Signals.
Abre los ajustes del plugin
Desde la pantalla Plugins de WordPress, haz clic en el enlace Settings bajo Customer Event Sync for Casa Signals.
4. Configura el plugin en WordPress
Pega la clave API
En el campo API key, pega la clave copiada desde Casa Signals. Si ya hay una clave guardada, WordPress muestra un marcador enmascarado para que la clave real no quede expuesta en el formulario de ajustes.
Confirma el dominio del sitio
En Site domain, introduce el mismo dominio que guardaste en Casa Signals. Así se vinculan los eventos entrantes con el sitio correcto.
Activa el seguimiento de eventos
Marca Enable event tracking. El plugin no registra ni envía eventos de clientes hasta que esta opción está activada.
Guarda los cambios
Haz clic en Save Changes. A partir de ese momento, el plugin puede establecer cookies propias de visitante y sesión, encolar eventos de clientes y de la tienda localmente, y enviarlos a Casa Signals en segundo plano.
- Enable event tracking está marcado.
- La clave API está presente.
- Site domain coincide con el sitio en Casa Signals.
- WooCommerce está activo.
5. Prueba la conexión
Crea un evento nuevo de cliente
Abre la tienda en una ventana privada o en otro navegador. Ve un producto, añádelo al carrito, abre el carrito y empieza el checkout.
Si es posible, introduce un correo electrónico y un número de teléfono en el checkout. Los flujos SMS al cliente necesitan un teléfono en el evento, y los flujos de email necesitan un correo electrónico.
Vuelve a Casa Signals
Abre el panel del sitio en Casa Signals. La nueva actividad puede aparecer en analítica, líneas de tiempo de clientes, analítica de productos y actividad en vivo del sitio.
Espera la entrega en segundo plano
El plugin encola eventos localmente y los envía mediante procesamiento en segundo plano de WordPress. Un pequeño retraso es normal, sobre todo si el sitio tiene poco tráfico o WP-Cron solo se ejecuta cuando alguien visita páginas.
Revisa el panel de depuración si hace falta
Si los eventos no aparecen, vuelve a los ajustes del plugin en WordPress, activa Debug mode, guarda, realiza otra acción en la tienda y revisa la cola de seguimiento y la última respuesta de la API en segundo plano en la página de ajustes.
6. Opcional: importa datos históricos
Cuando la conexión en vivo ya funcione, los administradores de WordPress pueden abrir Tools -> Casa Signals Import para importar catálogo, usuarios y pedidos existentes.
Las importaciones están diseñadas para ser idempotentes, así que volver a ejecutar una importación no debería duplicar los mismos registros históricos. Los eventos de pedidos históricos se marcan como backfill y no disparan flujos de SMS o email.
- Configura primero la clave API.
- Activa primero el seguimiento de eventos.
- Ejecuta las importaciones de productos, usuarios y pedidos cuando la tienda tenga tiempo suficiente para procesarlas.
- No uses la herramienta de importación como prueba de eventos en vivo, porque los eventos importados omiten intencionadamente las automatizaciones.
Qué empieza a registrar Casa Signals
Una vez activado, el plugin puede registrar vistas de producto, búsquedas de producto, vistas de carrito, eventos de añadir al carrito, eventos de quitar del carrito, cambios de cantidad del carrito, inicios de checkout, captura de contacto en checkout, actualizaciones de dirección en checkout, métodos de pago y envío seleccionados, pedidos realizados, pagos correctos, pagos fallidos, reembolsos, cancelaciones, actividad de cupones, registros de cuenta, inicios de sesión, cierres de sesión, restablecimientos de contraseña, actualizaciones de cuenta, suscripciones, envíos de formularios, atribución y estado del sitio.
Casa Signals usa esos eventos para analítica, líneas de tiempo de clientes, informes de productos, campañas, disparadores de flujos, comprobaciones de supresión y atribución de ingresos recuperados.
Buenas prácticas después de conectar
- Haz una compra real de prueba o una prueba de pago en el modo de pruebas de tu pasarela de WooCommerce, si está disponible.
- Mantén la clave API privada y regenérala si se ha compartido fuera de tu equipo.
- Revisa Analytics después del primer día para confirmar que llegan eventos de producto, carrito, checkout y pedido.
- Añade una dirección de email principal del dominio en Settings antes de usar flujos o campañas por email.
- Solicita un SMS Sender ID si quieres que los SMS al cliente muestren el nombre de tu marca en lugar del remitente por defecto.
- Crea un flujo de carrito abandonado solo después de ver eventos add_to_cart o checkout en Casa Signals.
Solución de problemas
No aparecen eventos en Casa Signals después de la configuración.
- Confirma que Enable event tracking está marcado en WordPress.
- Confirma que la clave API está guardada en WordPress y procede del sitio correcto de Casa Signals.
- Confirma que el campo Site domain en WordPress coincide con el dominio guardado en Casa Signals.
- Visita la tienda y crea un evento nuevo después de guardar los ajustes. La actividad histórica anterior a la configuración no aparecerá salvo que se importe.
- Asegúrate de que WP-Cron se está ejecutando. El conector envía eventos encolados en lotes en segundo plano.
El plugin está instalado, pero no hay datos.
- Instalar el plugin por sí solo no activa el seguimiento. Abre los ajustes del plugin desde la pantalla Plugins de WordPress, pega la clave API, introduce el dominio del sitio, marca Enable event tracking y guarda.
- Si la tienda usa plugins agresivos de seguridad, caché o desactivación de cron, permite WordPress cron y solicitudes HTTPS salientes a casasignals.com.
Los eventos llegan con retraso.
- Un pequeño retraso es esperado porque el plugin encola eventos localmente y envía lotes en segundo plano.
- Si los eventos se quedan atascados, activa Debug mode y revisa el número de eventos en la cola de seguimiento y la última respuesta de la API en segundo plano.
- Si DISABLE_WP_CRON está activado, configura un cron real de servidor para WordPress cron.
Los eventos aparecen bajo el sitio equivocado.
- Es probable que la clave API de WordPress proceda de otro sitio de Casa Signals, o que el valor Site domain no coincida con el sitio previsto.
- Genera una nueva clave desde Settings del sitio correcto en Casa Signals, pégala en WordPress, confirma el dominio del sitio y guarda.
Los flujos SMS al cliente no se envían después de conectar.
- Puede que la conexión funcione, pero los flujos SMS al cliente también necesitan un número de teléfono del cliente en el evento disparador.
- Comprueba que el flujo está activo, que hay créditos disponibles y que no se está suprimiendo porque el pago se completó durante el retraso.
- Recuerda que un destinatario dado de baja de SMS para la tienda será omitido.
La importación terminó, pero no se disparó ninguna automatización.
- Es lo esperado. La herramienta de importación marca los eventos históricos como backfill, y Casa Signals omite la ejecución de flujos y la atribución de recuperación para esos eventos importados.
- Usa una acción nueva en vivo en la tienda para probar las automatizaciones.
Preguntas frecuentes para agentes de soporte
¿Dónde encuentro la clave API de Casa Signals?
En Casa Signals, abre la tienda, ve a Settings y busca el panel de conexión WordPress Plugin. Haz clic en Generate key o Regenerate key y después en Copy.
¿Dónde están los ajustes del plugin de WordPress?
En WordPress, ve a Plugins, busca Customer Event Sync for Casa Signals y haz clic en Settings.
¿El plugin envía pedidos antiguos automáticamente?
No. El conector en vivo envía eventos nuevos después de activar el seguimiento. Los productos, usuarios y pedidos históricos se pueden importar desde Tools -> Casa Signals Import.
¿Importar pedidos antiguos disparará flujos SMS o email?
No. Los eventos importados se marcan como backfill. Casa Signals omite la automatización de flujos y la atribución de recuperación para eventos backfilled.