Instalación
- En el panel de Tiendanube, entra a Mis aplicaciones.
- Busca Customer.io Tracker e instala la app.
- Acepta los permisos. Vas a llegar automáticamente al panel de configuración.
Configuración
Una vez instalada, abrí la app desde el panel de Tiendanube. Hay un solo campo para completar: tu API Key de Customer.io.
API Key (obligatoria)
Es la clave que conecta tu tienda con tu cuenta de Customer.io. Para crearla:
- Entra a tu cuenta en customer.io.
- Ve a Integrations → Add Integration.
- En la pestaña Directory, busca customer.io y elige la tarjeta Customer.io API — no la de Customer.io (Workspaces), que es otra cosa.
- Ponle un nombre que te sirva para reconocerla, por ejemplo Tiendanube. La API Key aparece en esa misma pantalla: copiala.
- Customer.io no deja terminar la integración hasta que reciba datos con esa key: la misma pantalla te da un comando
curllisto para copiar, y después el botón de verificación confirma que llegaron. Si no trabajás con la terminal, mandanos la key a hello@hyppo.io y hacemos la prueba nosotros. - Con la prueba en verde, haz clic en Complete Setup.
- Pegala en el campo de la app en Tiendanube y guarda.
La región se detecta sola
Customer.io tiene dos regiones, US y EU, y una key pertenece a una sola. No hay que elegirla: la app la resuelve desde tu key y la muestra debajo del campo. Si la key no existe en tu cuenta, te lo dice al guardar en vez de fallar en silencio — el error más común es pegar el Site ID o la Track API Key, que son de Journeys y no sirven acá.
Qué eventos manda
Desde que guardás la key, cada uno de estos eventos de tu tienda llega a Customer.io con la persona ya identificada por email:
order_created— se creó una ordenorder_paid— se pagóorder_fulfilled— se preparó para envíoorder_cancelled— se cancelócustomer_created— se registró un cliente nuevo
El tracking de navegación en la tienda (page views, carrito) no forma parte de la app: se configura aparte y lo montamos nosotros por tienda.
Preguntas frecuentes
¿Dónde encuentro mi API Key de Customer.io?
En Customer.io, en Integrations → Add Integration → Customer.io API: le pones un nombre y ahí mismo te muestra la API Key. No es el Site ID ni la Track API Key de Workspace Settings: esas dos son de Journeys y no funcionan con esta app.
¿Qué eventos manda la app a Customer.io?
Cinco: order_created, order_paid, order_fulfilled, order_cancelled y customer_created. Cada uno llega con la persona identificada por email.
¿La app trackea las visitas de mi tienda?
No. La app manda los eventos de compra desde el servidor. El tracking de navegación en la tienda se configura aparte y lo montamos nosotros por tienda.
¿Tengo que elegir la región US o EU?
No. La app resuelve la región desde tu key y la muestra debajo del campo. Si la key no existe en tu cuenta, te lo dice al guardar.
Guardé la key pero no llega ningún evento.
Suele ser que el token de la app no incluye el permiso de órdenes, y entonces los webhooks no quedan registrados. La app te muestra un aviso para reconectarla; después de reconectar, los eventos empiezan a llegar solos.
¿Necesitas ayuda?
Si tienes problemas para activar la app o los datos no aparecen en Customer.io, escríbenos a hello@hyppo.io.
También te puede interesar
Legales y privacidad
La app procesa datos únicamente para conectar Tiendanube con Customer.io. No almacenamos datos personales de tus clientes en servidores externos.