PostHog
En lugar de seguir estos pasos manualmente, puedes usar el Asistente de Credenciales con IA — describe lo que quieres conectar y la IA te guiara paso a paso, adaptado a tu cuenta.
Descripción General
Conecta tu cuenta de PostHog a Nirvai para automatizar analíticas de producto, acceder a datos de eventos e integrar insights de usuarios en tus flujos de trabajo.
Métodos de Autenticación Soportados
- Personal API Key - Para endpoints de API privados
- Project API Key - Para endpoints públicos (tracking de analíticas)
Requisitos Previos
- Una cuenta de PostHog (Cloud o Self-hosted)
- Acceso a la configuración de API keys
Instrucciones de Configuración
Personal API Key (Recomendado)
Para acceder a endpoints de API privados (datos de usuarios, eventos, etc.):
- Inicia sesión en tu cuenta de PostHog
- Haz clic en tu avatar en la esquina inferior izquierda
- Selecciona Settings (o ve a la configuración de usuario)
- Navega a Personal API Keys
- Haz clic en Create personal API key
- Ingresa una etiqueta (ej., "Integración Nirvai")
- Copia la clave inmediatamente
- En Nirvai, ingresa:
- API URL: Selecciona tu región (US, EU, o URL self-hosted)
- API Key: Pega tu Personal API Key
Project API Key (Para Analíticas)
Para tracking de analíticas y endpoints públicos:
- Ve a Project Settings > General
- Encuentra Project API Key
- Copia la clave
- Esta clave es solo para analíticas del lado del cliente
Campos de Configuración
| Campo | Descripción | Ejemplo |
|---|---|---|
| API URL | URL de instancia de PostHog | https://us.posthog.com |
| API Key | Personal o Project API key | phx_xxxxx... |
Opciones de API URL
Selecciona según tu configuración de PostHog:
| Configuración | API URL |
|---|---|
| US Cloud | https://us.posthog.com |
| EU Cloud | https://eu.posthog.com |
| Self-hosted | Tu URL personalizada (ej., https://posthog.tuempresa.com) |
Tipos de Claves
| Tipo de Clave | Caso de Uso | Nivel de Acceso |
|---|---|---|
| Personal API Key | Acceso Backend/API | Acceso completo de lectura a tus datos |
| Project API Key | Analíticas Frontend | Limitado a tracking de eventos |
Operaciones Disponibles
Con credenciales de PostHog, puedes:
- Consultar eventos y datos de usuarios
- Acceder a feature flags
- Obtener insights de analíticas
- Gestionar personas y grupos
- Acceder a cohortes
- Consultar tendencias y funnels
Solución de Problemas
Problemas Comunes
- 401 Unauthorized: La API key es inválida o expiró. Crea una nueva clave.
- 403 Forbidden: La clave no tiene acceso al endpoint.
- Región Incorrecta: Usando clave US con endpoint EU. Coincide con la región de tu cuenta.
- Problemas Self-hosted: Verifica que tu URL de PostHog sea accesible.
Encontrar tu Región
Verifica la URL de tu dashboard de PostHog:
us.posthog.com→ US Cloudeu.posthog.com→ EU Cloud- Dominio personalizado → Self-hosted
Scopes de Claves
Las Personal API keys tienen acceso completo de lectura por defecto. No puedes restringir scopes en claves personales.
Rate Limiting
PostHog tiene límites de tasa de API:
- Se aplican límites de tasa estándar a todos los endpoints
- Implementa lógica de reintento con backoff exponencial
Recursos Relacionados
Adaptado de la documentación de n8n para la plataforma Nirvai
Siguientes Pasos
Usa el Creador de Herramientas con IA para convertir esta credencial en herramientas usables por el agente. Describe lo que tu agente deberia poder hacer y la IA investiga la API, configura los endpoints y te entrega un toolkit revisable antes de guardar nada.