n8n
Conecta n8n como fuente de datos de webhook: cómo los nodos de la comunidad de Instasent envían contactos y eventos al stream de ingesta de Instasent, qué sincroniza, cómo se asignan los campos a los atributos y cómo se controla el consentimiento a través de los datos que envías.
n8n es una plataforma de webhooks: en vez de leer tus datos directamente, te permite construir un flujo que envía contactos y eventos al stream de ingesta de Instasent. Úsalo para conectar Instasent con cualquier herramienta que n8n admita y que no tenga conector nativo.
Cómo conectar
n8n es una plataforma de webhooks: no creas ninguna credencial en el lado de n8n — Instasent crea la fuente y te da las credenciales, y tú las usas en los nodos de Instasent. Puedes hacer el lado de Instasent antes de tener nada configurado en n8n; la fuente queda creada esperando datos en tiempo real.
Los nodos de Instasent se distribuyen como un paquete de la comunidad. Instálalos una
vez desde los ajustes de community-nodes de n8n añadiendo el paquete npm
n8n-nodes-instasent; a partir de ahí los nodos de Instasent quedan disponibles en tus
flujos.
Añade la fuente de datos
En Fuentes de datos, selecciona Añadir fuente de datos y selecciona n8n en la sección de Integraciones.
Configura la fuente
Rellena el paso Configurar — Nombre de la conexión, País por defecto, Configuración regional / Locale y Zona horaria — e Instasent crea la fuente.
Copia tus credenciales
Instasent muestra las credenciales de la fuente en Instrucciones de configuración — el UID de proyecto, el ID Fuente de datos y la API key. Guárdalos en lugar seguro.
Instala los nodos de Instasent y construye tu flujo
En los ajustes de community-nodes de n8n, instala el paquete
n8n-nodes-instasent. Después añade un nodo de Instasent a tu flujo y usa las credenciales del panel para enviar contactos y eventos al stream de tu fuente.Observa el registro de stream
De vuelta en Instasent, la fuente muestra un registro de stream de los datos que llegan, para que confirmes que tu flujo funciona.
Para las formas de los endpoints y las credenciales completas, consulta API y webhooks.
Qué sincroniza
n8n envía lo que tu flujo emita — normalmente contactos y eventos, en tiempo
real según se ejecuta el flujo. El payload sigue el formato de ingesta: un payload de
contacto identifica al contacto (contact_id); un payload de evento añade el nombre del
evento y sus parámetros.
Mapeo de campos
Los campos que envías se asignan a atributos de Instasent igual que en cualquier fuente — decides en tu flujo qué valores van a qué campos, y confirmas el mapeo. Consulta el mapeo de campos.
Mapeo de consentimiento
n8n no tiene mapeo de consentimiento propio — simplemente deja pasar los datos que tu
flujo envía. El consentimiento se controla con las columnas y atributos que incluyes en
el payload. Si envías los atributos de consentimiento (_accepts_marketing_*,
_is_subscribed_*), aplican las mismas reglas que en cualquier importación: fija
_accepts_marketing_* en false solo ante un opt-out activo; "sin dato" se queda en
null. Consulta Consentimiento.