Recursos · Integración n8n

Integración PostHog n8nAutomatiza PostHog con n8n.

El dato que no llega a PostHog no sirve de nada. La integración PostHog n8n cubre justo ese tramo final: 5 operaciones repartidas en 4 recursos para crear un evento, una identidad o un alias, y para registrar una página o una pantalla. PostHog no tiene nodo trigger en n8n, así que el flujo arranca en otro sitio.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué cubre la integración PostHog n8n?

El nodo PostHog escribe. Toma el elemento que circula por tu flujo de trabajo y lo convierte en algo que PostHog puede guardar: un evento con nombre y propiedades, una identidad, un alias, o una página o pantalla registrada. Cada llamada necesita un distinct ID, el valor con el que PostHog separa a un usuario de otro. El nodo viene incluido en n8n, y el credential, es decir las credenciales guardadas dentro de n8n, se reutiliza en todos los flujos de la instancia.

Hay un caso que aparece siempre el primero: el evento que nunca sale del navegador. Un cobro confirmado por el equipo financiero, un contrato firmado dentro del CRM, una baja gestionada por soporte. Nada de eso dispara un script en una página, así que PostHog no se entera. Un flujo que ya recibe ese dato llama a event.create, pone nombre al evento, adjunta el distinct ID, y el embudo vuelve a contar la historia completa.

El segundo bloque es el de identidades. identity.create crea una identidad a partir de un distinct ID, y alias.create guarda un nombre de alias frente a ese mismo distinct ID. Aquí encajan bien los flujos que nacen fuera del producto: un aviso que pasa por Slack o un lote que llega desde una hoja de Google Sheets suele traer el identificador antes que la propia aplicación.

El tercero son las páginas y las pantallas enviadas desde servidor. track.page y track.screen piden un Name y un distinct ID cada una, lo que las hace útiles cuando la vista ocurre donde ningún script de cliente llega a ejecutarse. Si el mismo flujo ya alimenta Segment o Google Analytics, puedes repartir desde un único lugar en vez de montar tres integraciones por separado.

Y ahora el límite, sin adornos. El catálogo son 5 operaciones en 4 recursos, y esa es toda la superficie del nodo. Para el resto de la API de PostHog está el nodo HTTP Request, que llama a cualquier endpoint de la herramienta reutilizando el mismo credential mediante la autenticación predefinida. No es un plan B triste, es otro nodo en el mismo lienzo.

Queda un detalle de diseño: PostHog no tiene nodo trigger en n8n. Un flujo que lo use arranca con un Schedule Trigger a intervalo fijo, con el nodo Webhook de n8n al que llama un servicio externo, o con el trigger de otra herramienta. La plantilla pública 968 hace exactamente eso, crear un evento en PostHog cuando llega una petición a una URL de webhook. Si prefieres entender la plataforma antes de montar nada, ahí está la reseña n8n.

Conexión

¿Cómo se conecta PostHog con n8n?

  1. 01

    Consigue la clave API correcta

    Necesitas una cuenta de PostHog, o PostHog alojado en tu propio servidor. La clave depende de lo que vaya a llamar el nodo. Para los endpoints públicos que solo aceptan POST, usa una Project API key de los ajustes General de tu proyecto. Para los privados, una Personal API key de la sección Personal API Keys de tu cuenta de usuario. Son dos claves distintas en dos pantallas distintas: coge la que tu flujo necesita.

  2. 02

    Elige la URL de la API

    El credential pide una URL, y el dominio correcto depende de dónde viva tu proyecto. En US Cloud, https://us.i.posthog.com para los endpoints públicos solo POST y https://us.posthog.com para los privados. En EU Cloud, la pareja es https://eu.i.posthog.com y https://eu.posthog.com. Si alojas PostHog tú, va tu propio dominio. Mirando la URL de tu instancia de PostHog confirmas en cuál de los tres casos estás.

  3. 03

    Guarda el credential una sola vez

    En n8n, abre el menú Credentials, crea el credential de PostHog y rellena los campos URL y API Key. Un credential se crea una vez y se reutiliza en todos los flujos de la instancia, así que esto se hace el primer día y ya está. Después coloca un nodo PostHog en el lienzo y lo verás propuesto en su lista desplegable. El procedimiento es idéntico en n8n Cloud y en una instancia autoalojada.

Acciones

Qué sabe hacer el nodo PostHog

El nodo PostHog expone 5 operaciones en 4 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreatePageScreen
Alias✓
Event✓
Identity✓
Track✓✓

Alias

1 operación
01

Create an alias

alias.create

Lo que ves en n8n

Notas y casos de uso

Guarda un nombre de alias frente a un usuario al que ya sigues por su distinct ID. Un elemento de entrada, un alias almacenado en PostHog.

Parámetros clave

  • Alias: el nombre del alias. Campo obligatorio, que escribes en el nodo o traes del elemento entrante con una expresión como {{ $json.field }}.
  • Distinct ID: el distinct ID del usuario, también obligatorio. Un campo obligatorio vacío detiene la ejecución del nodo antes de llamar a la API.
  • Timestamp: está dentro de Additional Fields. Si no lo rellenas, toma automáticamente la hora actual, algo que importa cuando reprocesas datos antiguos.
Casos de uso
un flujo de alta que recibe una cuenta con dos identificadores escribe aquí el segundo, justo después de crearla.

Event

1 operación
02

Create an event

event.create

Lo que ves en n8n

Notas y casos de uso

Es la operación que más vas a usar. Manda un evento con nombre a PostHog para un usuario concreto, y hace visible un paso que ocurre lejos del navegador.

Parámetros clave

  • Event: el nombre del evento, obligatorio. Es la etiqueta que buscarás luego dentro de PostHog, así que mantenla estable entre ejecuciones.
  • Distinct ID: el distinct ID del usuario, obligatorio. Suele venir del nodo anterior, escrito como {{ $json.field }}.
  • Properties: colección dentro de Additional Fields, con un botón Add Property y una fila por cada propiedad que quieras adjuntar.
Casos de uso
una factura que pasa a pagada en un flujo de facturación se convierte en evento, con el plan y el importe como propiedades.

Identity

1 operación
03

Create an identity

identity.create

Lo que ves en n8n

Notas y casos de uso

Aquí solo hay un campo obligatorio: el distinct ID de la identidad. Eso la convierte en la llamada más ligera de las cinco, y en un buen primer nodo cuando el flujo conoce a la persona antes que el producto.

Parámetros clave

  • Distinct ID: el distinct ID de la identidad, obligatorio y único campo requerido de la operación.
  • Properties: en Additional Fields, con el mismo mecanismo Add Property que en las demás operaciones.
  • Timestamp: opcional. Vacío, se ajusta solo a la hora actual.
Casos de uso
una importación nocturna de fichas nuevas desde un CRM crea primero la identidad, y el resto del flujo ya puede colgarle eventos.

Track

2 operaciones
04

Track a page

track.page

Lo que ves en n8n

Notas y casos de uso

Registra una página vista desde el flujo en lugar de desde el navegador. Sirve cuando la página se sirve en un sitio donde ningún script de cliente llega a ejecutarse.

Parámetros clave

  • Name: obligatorio, el nombre de la página que registras.
  • Distinct ID: el distinct ID del usuario, obligatorio, para que la vista quede colgada de alguien y no suelta.
  • Properties: disponible en Additional Fields con Add Property, una fila por propiedad.
Casos de uso
un documento reservado a clientes que sirve tu propio backend se registra en el momento de la entrega, con el distinct ID del lector tomado de la propia petición.
05

Track a screen

track.screen

Lo que ves en n8n

Notas y casos de uso

Misma idea, otra superficie: esta registra una pantalla en lugar de una página, con su nombre y la persona a la que corresponde.

Parámetros clave

  • Name: obligatorio, el nombre de la pantalla que registras.
  • Distinct ID: el distinct ID del usuario, obligatorio.
  • Timestamp: opcional, dentro de Additional Fields. Si lo dejas vacío se usa la hora actual, así que dale un valor cuando la pantalla se vio antes de la ejecución del flujo.
Casos de uso
un lote de actividad de la aplicación que llega por una cola se reproduce pantalla a pantalla, cada elemento con su propia marca de tiempo.
Necesitas ayuda

¿Necesitas ayuda para automatizar PostHog con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

PostHog y n8n, las dudas más habituales

01¿La integración PostHog n8n es gratuita?
Sí por el lado de n8n. El nodo de PostHog viene incluido con n8n, así que no hay nada que instalar ni coste adicional por añadirlo, tanto en n8n Cloud como en una instancia autoalojada con la Community Edition y su licencia Sustainable Use. Un flujo montado en una funciona igual en la otra, de modo que puedes probar en Cloud y mudarte después sin rehacer los nodos. Lo que conectas del lado de PostHog es tu cuenta o tu servidor, y eso ya se decide entre PostHog y tú. Dentro de n8n, lo único que cuesta el nodo es el rato de crear el credential una vez.
02¿Qué credenciales necesita el nodo de PostHog?
Una clave API, y conviene elegir bien cuál. El credential de PostHog en n8n pide dos valores: la URL de la API y la API Key. Para los endpoints públicos que solo aceptan POST, la clave es una Project API key que sale de los ajustes General del proyecto. Para los endpoints privados, es una Personal API key de la sección Personal API Keys de los ajustes de tu usuario. La URL sigue el mismo reparto: en US Cloud, us.i.posthog.com para lo público solo POST y us.posthog.com para lo privado, con sus equivalentes eu en EU Cloud, o tu propio dominio si alojas PostHog. Antes de todo esto necesitas una cuenta de PostHog o una instancia propia.
03¿Qué limitaciones tiene el nodo de PostHog en n8n?
El nodo expone 5 operaciones repartidas en 4 recursos: Alias, Event, Identity y Track. Ese es el catálogo tal cual viene, y todas esas llamadas piden un distinct ID. Cuando el endpoint que buscas no está en ese catálogo, el nodo HTTP Request llama a cualquier endpoint de la API de PostHog reutilizando el mismo credential mediante la autenticación predefinida, así que la llamada no se pierde, simplemente cambia de nodo. El otro punto a tener en cuenta es que no hay trigger, algo que se explica justo debajo. Lo demás depende de cómo alimente tu propio flujo al nodo.
04¿PostHog tiene nodo trigger en n8n?
No. PostHog no tiene nodo trigger en n8n, así que un flujo que lo use arranca siempre en otro punto. Con tres opciones se cubre casi todo. El Schedule Trigger lanza el flujo a intervalo fijo, lo que encaja con importaciones y procesos nocturnos. El nodo Webhook de n8n te da una URL a la que llama un servicio externo, es decir un punto de entrada que se dispara desde fuera: la plantilla 968 de la biblioteca de n8n crea un evento en PostHog justo cuando llega una petición a esa URL. Y también puedes partir del trigger de otra herramienta, dejando el nodo PostHog como paso posterior. Elige según quién se entera primero de que algo ha pasado.
05¿n8n o Make para PostHog?
Depende de cuatro criterios, y el precio es solo uno. Alojamiento: n8n se autoaloja con Docker o npm, o se usa en n8n Cloud, mientras que Make funciona solo alojado por su proveedor. De ahí sale el control del dato, porque una instancia de n8n en tu infraestructura mantiene dentro los datos que empujas hacia PostHog. Modelo de coste: Make factura por operación, algo que conviene simular si tu flujo crea un evento por cada elemento de un lote grande. Lógica visual: las dos plataformas trabajan sobre un lienzo, y suele ganar la que tu equipo lee más rápido. La decisión se juega en la plataforma, no en esta integración.