Integración Customer.io n8nAutomatiza Customer.io con n8n.
¿Dónde acaba un clic en un email de Customer.io? Una integración Customer.io n8n expone 9 operaciones repartidas en 4 recursos: clientes, eventos, campañas y segmentos. El trigger escucha 32 eventos en 5 familias. Pensado para equipos que ya gestionan la mensajería a diario.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Para qué sirve una integración Customer.io n8n?
Una integración Customer.io n8n conecta los perfiles que guarda Customer.io con el resto de herramientas que tocan tus flujos de trabajo. El nodo crea y actualiza clientes, envía eventos, lee campañas y mueve perfiles dentro y fuera de un segmento. El trigger hace el camino contrario: reacciona a lo que ocurre después de enviar un mensaje, así que el seguimiento deja de ser una tarea manual de cada lunes.
Primer caso, el alta. Una fila llega a Google Sheets, n8n la recoge, customer.upsert crea el perfil con su correo y segment.add lo mete en el segmento de bienvenida, con lo que la campaña arranca sola. Esa es la forma de la plantilla de Customer.io publicada en n8n.io con el número 646, y es el camino más corto entre un formulario y una secuencia que ya funciona.
Segundo caso, la reacción. El trigger salta con email.clicked, n8n filtra por la campaña que envió el mensaje y quien lleva la cuenta recibe un aviso en Discord mientras el interés sigue caliente. El mismo montaje con email.spammed: el perfil sale del segmento de seguimiento con segment.remove antes del siguiente envío. Si el aviso tiene que sonar en el móvil de la persona de guardia, Pushover hace ese trabajo.
Tercer caso, el informe. Un nodo Schedule se ejecuta el lunes, campaign.getAll lista las campañas, campaign.getMetrics trae los contadores de cada una y el resumen sale por Gmail. Nadie tiene que abrir un panel para saber cómo fue la semana.
El nodo cubre 4 recursos y ahí se acaba. Para cualquier otro punto de la API de Customer.io, el nodo HTTP Request llama al endpoint directamente y reutiliza el mismo credential, es decir el juego de credenciales guardado en n8n, mediante la autenticación predefinida. Conviene saberlo antes de dibujar nada: ninguna operación del nodo envía mensajes. Enviar sigue siendo trabajo de las campañas de Customer.io.
Del lado del trigger, n8n mantiene la etiqueta Beta y la versión 1, así que tenlo en el radar. Tampoco existe una opción que lo capture todo: cada evento que quieras se marca a mano en la lista Events. Si todavía estás aprendiendo a montar flujos así, el Curso n8n cubre esta forma de trabajar paso a paso.
¿Cómo se conecta Customer.io con n8n?
- 01
Genera las dos claves de API en Customer.io
Customer.io expone dos API distintas y n8n necesita una clave para cada una. La Tracking API Key trabaja contra la Track API, en
https://track.customer.io/api/v1/. La App API Key trabaja contra la App API, enhttps://api.customer.io/v1/api/. Las dos se crean desde la pantalla de credenciales de tu cuenta de Customer.io, la que su documentación llama gestión de credenciales de API. - 02
Elige la región de tu espacio de trabajo
El campo Region cambia los subdominios a los que llama n8n. La opción Global mantiene las URL por defecto de ambas API y vale para cualquier país fuera de la Unión Europea. La opción EU cambia el subdominio de la Track API a
track-euy el de la App API aapi-eu, y solo debe marcarse si tu espacio de trabajo está realmente en la UE. Una región equivocada hace que una clave válida nunca autentique. - 03
Crea el credential una sola vez en n8n
En n8n, abre el menú Credentials y añade un credential de Customer.io. Pega la Tracking API Key, el Tracking Site ID que la acompaña, la App API Key y la región. Ese mismo credential alimenta tanto al nodo Customer.io como al Customer.io Trigger, y todos los flujos posteriores lo eligen en una lista desplegable sin volver a teclear ninguna clave.
¿Qué puede arrancar un flujo desde Customer.io ?
Customer.io Trigger es el nodo que arranca un workflow cuando algo ocurre en Customer.io. Escucha 32 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que Customer.io llama) en tu cuenta.
Lo que ves en n8n
Todos los eventos, por familia
Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.
email.*10email.attemptedbouncedclickedconverteddelivereddraftedfailedopenedsentspammed
push.*8push.attemptedbouncedclickeddelivereddraftedfailedopenedsent
sms.*7sms.attemptedbouncedclickeddelivereddraftedfailedsent
slack.*5slack.attemptedclickeddraftedfailedsent
customer.*2customer.subscribedunsubscribed
Notas de configuración
01Configure the Customer.io Trigger
El Customer.io Trigger arranca un flujo cuando pasa algo dentro de Customer.io. Tiene un único ajuste y todo depende de él.
Parámetros clave
- Events: la lista de eventos que reenviará el webhook. Un webhook es una URL a la que Customer.io llama en el momento en que ocurre el evento, así que no hay consultas periódicas y cada aviso llega en segundos. No existe una opción que lo capture todo, de modo que marca uno a uno los eventos que te interesan entre los 32 disponibles.
02Email Events
El correo es la familia más grande del catálogo, con 10 eventos que cubren desde la preparación del mensaje hasta la queja por spam.
Parámetros clave
- Events:
email.drafted,email.attempted,email.sentyemail.deliveredsiguen el envío paso a paso, y luegoemail.opened,email.clickedyemail.convertedcuentan qué hizo la persona con el mensaje. - Events: las tres señales de fallo son
email.bounced,email.failedyemail.spammed, y merecen su propio flujo en lugar de una rama compartida.
email.converted a quien lleva la cuenta y engancha email.spammed a una limpieza que saque el perfil de todos los segmentos de seguimiento. Un tercer flujo sobre email.delivered copia cada envío en tu propia base de datos, de manera que el histórico de mensajes no dependa de lo que guarde una sola herramienta.03Push Events
La notificación móvil suma 8 eventos, con nombres tan parecidos a los del correo que un solo flujo suele servir para los dos canales.
Parámetros clave
- Events:
push.drafted,push.attempted,push.sentypush.deliveredtrazan la entrega, mientras quepush.openedypush.clickedcuentan qué hizo el dispositivo con el aviso. - Events:
push.bouncedypush.failedavisan de un problema de entrega, casi siempre un token de dispositivo que ya no responde.
push.failed marca el perfil en tu base de datos y la siguiente campaña vuelve al correo en vez de hablar sola. Lo contrario sirve igual: anotar push.opened junto al perfil evita que una secuencia repita un aviso que ya cumplió su función.04SMS and Slack Events
Dos familias más cortas conviven en la lista Events: 7 eventos para SMS y 5 para Slack, 12 entre las dos.
Parámetros clave
- Events: en SMS tienes
sms.drafted,sms.attempted,sms.sent,sms.delivered,sms.clicked, mássms.bouncedysms.failedcuando el número rechaza el mensaje. - Events: en Slack tienes
slack.drafted,slack.attempted,slack.sent,slack.clickedyslack.failed. Esa familia no tiene señal de entrega ni de rebote.
sms.failed que deje de insistir con un número malo evita repetir el envío contra una línea muerta. En Slack, slack.clicked confirma que alguien leyó el aviso interno. Las dos familias avisan además de un estado preparado y de un intento antes de que salga nada, lo que permite registrar la intención aunque el envío no llegue a completarse.05Customer Subscription Events
La familia más pequeña son 2 eventos, y justo los que tienen peso legal: customer.subscribed salta cuando alguien entra en una lista y customer.unsubscribed cuando se da de baja.
Parámetros clave
- Events: marca
customer.subscribedpara recoger cada alta nueva, venga de un formulario o de una importación. - Events: marca
customer.unsubscribedpara recoger cada baja en el segundo en que ocurre.
customer.unsubscribed escribe la baja en el CRM y en la facturación en la misma ejecución, y nadie reconstruye una lista desde una exportación vieja medio año después. El alta, por su parte, alimenta la bienvenida con segment.add. Entre los dos eventos se arma también un rastro de auditoría, porque cada cambio de pertenencia aterriza en el mismo sitio y con el momento exacto en que ocurrió.¿Qué sabe hacer el nodo Customer.io dentro de un flujo?
El nodo Customer.io expone 9 operaciones en 4 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | Get | Get Many | Delete | Add Customer | Remove Customer | Get Metrics | Track | Track Anonymous | Create or Update |
|---|---|---|---|---|---|---|---|---|---|
| Customer | ✓ | ✓ | |||||||
| Event | ✓ | ✓ | |||||||
| Campaign | ✓ | ✓ | ✓ | ||||||
| Segment | ✓ | ✓ |
Customer
2 operacionesCreate or update a customer
customer.upsertLo que ves en n8n
Notas y casos de uso
Una sola llamada resuelve los dos casos. Si el identificador ya existe en Customer.io el perfil se actualiza, y si no existe se crea. Eso es un upsert.
Parámetros clave
- ID: el identificador único del cliente, normalmente
{{ $json.id }}traído del nodo anterior. Usa siempre el mismo valor o una persona acabará como dos perfiles. - Additional Fields: guarda Email, Created At como marca de tiempo UNIX en segundos y Custom Properties para tus propios atributos.
- JSON Parameters: activado, pegas el contenido entero en JSON en vez de rellenar campo por campo.
Delete a customer
customer.deleteLo que ves en n8n
Notas y casos de uso
Borrar un perfil ocupa un solo campo, y la operación no deja nada detrás en Customer.io.
Parámetros clave
- ID: el identificador único del cliente, el mismo valor con el que se creó el perfil, casi siempre
{{ $json.id }}de una búsqueda previa y no un correo escrito a mano.
Event
2 operacionesTrack a customer event
event.trackLo que ves en n8n
Notas y casos de uso
Envía un evento con nombre asociado a un perfil conocido. Es lo que le da a una campaña algo a lo que responder.
Parámetros clave
- Customer ID: el identificador único del cliente al que pertenece el evento.
- Event Name: el nombre del evento que se registra, la etiqueta que compararán las condiciones de tu campaña.
- Additional Fields: Custom Attributes lleva los datos adjuntos y Type cambia el tipo de evento, con el valor
pagepara una vista de página.
Track an anonymous event
event.trackAnonymousLo que ves en n8n
Notas y casos de uso
La misma idea sin identidad detrás. Sirve cuando la visita ya ha hecho algo interesante antes de existir como perfil.
Parámetros clave
- Event Name: obligatorio aquí, porque es lo único que describe lo ocurrido.
- Additional Fields: Custom Attributes transporta el contexto que tengas, un correo escrito en un formulario o una referencia de producto.
- JSON Parameters: activado, el contenido entra como JSON en bruto dentro de Additional Fields.
Campaign
3 operacionesGet a campaign
campaign.getLo que ves en n8n
Notas y casos de uso
Lee una campaña y devuelve sus datos. Es la forma rápida de convertir un identificador en algo legible.
Parámetros clave
- Campaign ID: el identificador único de la campaña, un número y no su nombre, casi siempre
{{ $json.campaign_id }}que llega con un evento del trigger.
email.bounced se entiende mucho mejor con el nombre de la campaña dentro. Esta operación traduce el identificador crudo del webhook a la etiqueta que el equipo reconoce antes de publicar el mensaje en ningún sitio.Get many campaigns
campaign.getAllLo que ves en n8n
Notas y casos de uso
Devuelve de una vez las campañas del espacio de trabajo. No hay ningún campo que rellenar, lo que la convierte en el primer nodo natural de cualquier flujo de informes.
Get metrics for a campaign
campaign.getMetricsLo que ves en n8n
Notas y casos de uso
Devuelve los contadores de una campaña en un periodo, listos para escribirse en una hoja o en una base de datos.
Parámetros clave
- Campaign ID: el identificador numérico de la campaña que quieres medir.
- Period: hours, days, weeks o months, que fija la granularidad de la serie.
- Steps: cuántos periodos se devuelven. Por defecto, el máximo disponible, o 12 con months. Los topes son 24 hours, 45 days, 12 weeks y 120 months.
- Type: limita la métrica a email, push, slack, twilio, urbanAirship, webhook o empty.
Segment
2 operacionesAdd a customer to a segment
segment.addLo que ves en n8n
Notas y casos de uso
Mete uno o varios perfiles en un segmento manual. Suele ser lo que de verdad pone una campaña en marcha.
Parámetros clave
- Segment ID: el identificador numérico del segmento, sacado de Customer.io y digno de anotarse en las notas del flujo.
- Customer IDs: la lista de identificadores de cliente que se añaden, así entra un lote entero con un solo nodo y sin bucle.
Remove a customer from a segment
segment.removeLo que ves en n8n
Notas y casos de uso
Saca perfiles de un segmento manual. Los perfiles siguen en Customer.io, lo único que termina es su pertenencia al segmento.
Parámetros clave
- Segment ID: el identificador numérico del segmento que los perfiles abandonan.
- Customer IDs: la lista de identificadores de cliente que salen.
¿Necesitas ayuda para automatizar Customer.io con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
