INTEGRACIÓN POSTHOG n8n: AUTOMATIZAR POSTHOG CON N8N

Esta acción te permite crear eventos personalizados en PostHog directamente desde tus workflows n8n. Es la acción fundamental para trackear comportamientos de usuarios que ocurren fuera de tu aplicación principal o que provienen de sistemas externos. Particularmente útil para enriquecer tu análisis de producto con eventos que no pueden capturarse mediante el SDK tradicional (acciones offline, conversiones en herramientas externas, eventos generados por integraciones).

Parámetros clave: Event: Campo de texto requerido donde defines el nombre del evento a crear (ej: "lead_qualified", "subscription_upgraded", "support_ticket_created"). Acepta valores fijos o expresiones dinámicas para construir nombres de eventos basados en datos del workflow. Distinct ID: Campo de texto requerido que identifica de manera única al usuario asociado con este evento. Es crucial para que PostHog pueda vincular correctamente el evento al perfil del usuario. Puedes usar el email, user_id de tu sistema, o cualquier identificador consistente. Additional Fields: Sección opcional que te permite añadir propiedades personalizadas al evento como pares clave-valor. Haz clic en "Add Field" para incluir contexto adicional (ej: plan_type, source_campaign, deal_value, feature_used). Estas propiedades enriquecen tus análisis permitiéndote segmentar y filtrar eventos en PostHog.

Casos de uso típicos: Crear automáticamente un evento "demo_scheduled" en PostHog cuando un lead reserva una demostración en Calendly, incluyendo propiedades como empresa, sector y origen del lead. Trackear eventos de conversión cuando un usuario completa acciones específicas en herramientas de terceros (formularios Typeform, compras en Stripe, reservas en sistemas externos). Registrar acciones offline como eventos PostHog: llamadas telefónicas registradas en tu CRM, reuniones presenciales, interacciones en ferias comerciales.

Cuándo usarlo: Ideal cuando necesitas completar tu tracking de producto con eventos que no pueden capturarse mediante el SDK JavaScript/Python tradicional de PostHog, o cuando quieres centralizar todo tu tracking de eventos en workflows automatizados para mantener consistencia.

Esta acción crea una nueva identidad en PostHog, permitiéndote registrar usuarios con un identificador único y propiedades asociadas. Es fundamental para inicializar perfiles de usuario en PostHog cuando se registran en tu sistema o cuando importas usuarios desde otras fuentes. A diferencia de crear un simple evento, crear una identidad establece explícitamente un perfil de usuario que persistirá en PostHog y podrá enriquecerse con eventos y propiedades adicionales.

Parámetros clave: Distinct ID: Campo de texto requerido que establece el identificador único de la identidad a crear en PostHog. Este ID debe ser consistente con el que utilizarás posteriormente en tus eventos para vincularlos correctamente al perfil del usuario. Additional Fields: Sección opcional para añadir propiedades iniciales del usuario (email, nombre, plan, fecha de registro, etc.). Estas propiedades aparecerán inmediatamente en el perfil del usuario en PostHog y pueden utilizarse para segmentación y análisis. Haz clic en "Add Field" para incluir cada propiedad como un par clave-valor.

Casos de uso típicos: Crear automáticamente una identidad PostHog cuando un nuevo usuario se registra en tu aplicación vía Auth0 o Firebase, sincronizando propiedades básicas como email, nombre y fecha de registro. Importar masivamente usuarios existentes desde tu base de datos hacia PostHog para comenzar el tracking de producto en un proyecto existente. Inicializar perfiles de usuarios que interactúan con tu producto a través de canales no web (API, aplicaciones móviles nativas, integraciones).

Cuándo usarlo: Utiliza esta acción cuando necesites crear explícitamente un perfil de usuario en PostHog antes de comenzar a trackear sus eventos, especialmente en procesos de onboarding automatizados o migraciones de datos.

Esta acción crea un alias en PostHog, permitiéndote vincular un nuevo identificador a un usuario existente. Es esencial para unificar el journey de un usuario cuando cambia de estado (de anónimo a identificado, por ejemplo) o cuando utilizas múltiples identificadores para el mismo usuario en diferentes sistemas. PostHog utilizará este alias para consolidar todos los eventos bajo un único perfil, garantizando análisis precisos del comportamiento del usuario.

Parámetros clave: Alias: Campo de texto requerido que especifica el nuevo identificador (alias) que quieres vincular al usuario existente. Por ejemplo, si un usuario anónimo (trackado con un session_id) se registra y obtiene un user_id permanente, el user_id se convierte en el alias. Distinct ID: Campo de texto requerido que identifica al usuario existente al cual quieres asociar el nuevo alias. Es el identificador original que PostHog ya conoce y bajo el cual ya existen eventos o una identidad. Additional Fields: Sección opcional para añadir propiedades adicionales al evento de creación de alias, útil para contexto o debugging (ej: source: "signup_flow", timestamp_conversion, previous_state).

Casos de uso típicos: Vincular automáticamente el user_id definitivo de un usuario al session_id temporal que utilizaste para trackear sus acciones antes del registro, unificando todo su historial de eventos bajo un único perfil. Consolidar perfiles cuando detectas que un mismo usuario ha interactuado con tu producto desde múltiples dispositivos o sesiones con identificadores diferentes. Gestionar cambios de identificadores cuando un usuario actualiza su email o cuando migras de un sistema de identificación a otro.

Cuándo usarlo: Usa esta acción cada vez que necesites unificar múltiples identificadores de un mismo usuario en PostHog, especialmente en momentos de conversión (anónimo → identificado) o cuando detectas duplicados que deben consolidarse.

Esta acción trackea específicamente una visualización de página en PostHog. Es perfecta para registrar navegaciones que ocurren fuera de tu aplicación principal o que provienen de fuentes externas donde no tienes el SDK de PostHog instalado. Te permite mantener un historial completo de pages views incluso para interacciones en landing pages externas, sistemas de terceros o aplicaciones sin instrumentación directa.

Parámetros clave: Name: Campo de texto opcional donde especificas el nombre de la página trackada (ej: "Pricing Page", "Product Demo", "Checkout Step 2"). Puedes usar valores fijos o construir dinámicamente el nombre basándote en datos del workflow. Distinct ID: Campo de texto opcional que identifica al usuario asociado con esta visualización de página. Esencial para vincular la page view al perfil correcto en PostHog y analizar el journey completo del usuario. Additional Fields: Sección opcional para añadir propiedades contextuales a la page view como URL completa, referrer, parámetros UTM, timestamp, duración de la sesión, dispositivo utilizado, etc. Estas propiedades enriquecen tu análisis de navegación en PostHog.

Casos de uso típicos: Trackear automáticamente visualizaciones de landing pages hosteadas en plataformas externas como Webflow donde no puedes instalar directamente el SDK de PostHog, enviando eventos vía webhook → n8n → PostHog. Registrar navegaciones en aplicaciones móviles nativas o sistemas legacy donde la implementación del SDK es compleja, utilizando n8n como proxy de tracking. Consolidar page views desde múltiples propiedades web en un único proyecto PostHog para análisis unificado del customer journey.

Cuándo usarlo: Ideal cuando necesitas trackear page views desde sistemas donde no puedes implementar el SDK JavaScript de PostHog directamente, o cuando quieres centralizar todo tu tracking de navegación en workflows automatizados para mayor control y flexibilidad.

Esta acción trackea la visualización de una pantalla (screen view) en PostHog, diseñada específicamente para aplicaciones móviles, aplicaciones de escritorio o cualquier interfaz que no se base en el modelo tradicional de "páginas web". Funciona de manera similar a "Track Page" pero está optimizada para contextos donde las interacciones se organizan en "pantallas" en lugar de URLs.

Parámetros clave: Name: Campo de texto opcional donde defines el nombre de la pantalla trackada (ej: "HomeScreen", "ProfileSettings", "PaymentFlow_Step3"). Utiliza una convención de nomenclatura consistente para facilitar el análisis posterior en PostHog. Distinct ID: Campo de texto opcional que identifica al usuario asociado con esta visualización de pantalla. Crucial para vincular la screen view al perfil del usuario y analizar su navegación en la aplicación. Additional Fields: Sección opcional para añadir propiedades contextuales como versión de la app, plataforma (iOS/Android), resolución de pantalla, parámetros de navegación, estado de la sesión, etc. Estas propiedades adicionales son valiosas para entender cómo los usuarios interactúan con diferentes pantallas.

Casos de uso típicos: Trackear navegación en aplicaciones móviles React Native o Flutter con FlutterFlow donde implementas una arquitectura de tracking centralizada via API en lugar de SDK embebido. Registrar transiciones de pantallas en aplicaciones de escritorio (Electron, .NET) enviando eventos a n8n que luego los reenvía a PostHog. Consolidar tracking de screen views desde aplicaciones multi-plataforma en un único proyecto PostHog para análisis unificado del comportamiento de usuario.

Cuándo usarlo: Utiliza esta acción cuando trabajas con aplicaciones que organizan su interfaz en pantallas en lugar de páginas, especialmente aplicaciones móviles nativas o de escritorio donde quieres centralizar el tracking de navegación en workflows n8n.