Sim

PostHog

Análisis de productos y gestión de funcionalidades

La herramienta PostHog integra análisis de productos potentes, gestión de banderas de funcionalidades, experimentación y perspectivas del comportamiento del usuario directamente en tus flujos de trabajo agénticos. Diseñada para equipos modernos, te permite capturar, analizar y actuar sobre los datos de usuarios en tiempo real — ayudándote a crear mejores productos, entender la participación y aumentar las conversiones.

Con la herramienta PostHog, puedes:

  • Seguir y analizar eventos: Usa las operaciones posthog_capture_event y posthog_batch_events para registrar acciones individuales o múltiples de usuarios, vistas de página o eventos personalizados para análisis profundos.
  • Explorar datos de eventos: Recupera y lista eventos históricos o en tiempo real usando la operación posthog_list_events para análisis avanzado de eventos.
  • Entender a los usuarios: Aprovecha las operaciones posthog_list_persons, posthog_get_person y posthog_delete_person para gestionar perfiles de usuario, obtener información detallada de usuarios o eliminarlos según sea necesario.
  • Obtener información procesable sobre productos: Visualiza recorridos de usuarios, uso de funcionalidades y participación a través de las operaciones posthog_list_insights, posthog_get_insight y posthog_create_insight.
  • Gestionar y lanzar funcionalidades de forma segura: Alterna funcionalidades y ejecuta pruebas A/B o multivariantes a escala usando operaciones como posthog_list_feature_flags, posthog_get_feature_flag, posthog_create_feature_flag, posthog_update_feature_flag y posthog_delete_feature_flag.
  • Segmentar y dirigirte a audiencias: Construye, lista o gestiona cohortes con posthog_list_cohorts, posthog_get_cohort y posthog_create_cohort.
  • Recopilar feedback directo: Diseña, implementa y analiza encuestas a través de posthog_list_surveys, posthog_get_survey, posthog_create_survey y posthog_update_survey.
  • Monitorizar la experiencia del usuario: Accede y analiza grabaciones de sesiones a través de las operaciones posthog_list_session_recordings y posthog_get_session_recording.
  • Colaborar con tu equipo: Organiza paneles (posthog_list_dashboards, posthog_get_dashboard), crea y anota perspectivas y eventos, y gestiona proyectos y organizaciones dentro de PostHog.

Ya sea que desees implementar análisis de productos a gran escala, mejorar la incorporación de usuarios, refinar tu hoja de ruta del producto o automatizar decisiones basadas en datos de uso reales, la herramienta PostHog potencia tus agentes y flujos de trabajo con análisis avanzados y experimentación dentro del producto, todo en una plataforma unificada.

¿Buscas análisis de productos reales con privacidad, escalabilidad y una opción de código abierto? PostHog es la herramienta de confianza para equipos ágiles y empresas en todo el mundo.

Instrucciones de uso

Integra PostHog en tu flujo de trabajo. Realiza seguimiento de eventos, gestiona indicadores de funciones, analiza el comportamiento del usuario, ejecuta experimentos, crea encuestas y accede a grabaciones de sesiones.

Herramientas

posthog_capture_event

Captura un solo evento en PostHog. Utiliza esto para realizar seguimiento de acciones de usuarios, vistas de página o eventos personalizados.

Entrada

ParámetroTipoObligatorioDescripción
projectApiKeystringClave API del proyecto PostHog (token público para ingesta de eventos)
regionstringNoRegión de PostHog: us (predeterminado) o eu
eventstringEl nombre del evento a capturar (p. ej., "page_view", "button_clicked")
distinctIdstringIdentificador único para el usuario o dispositivo. Puede ser ID de usuario, ID de dispositivo o ID anónimo
propertiesstringNoCadena JSON de propiedades del evento (p. ej., {"button_name": "signup", "page": "homepage"})
timestampstringNoMarca de tiempo ISO 8601 para cuando ocurrió el evento. Si no se proporciona, usa la hora actual

Salida

ParámetroTipoDescripción
statusstringMensaje de estado que indica si el evento se capturó correctamente

posthog_batch_events

Captura múltiples eventos a la vez en PostHog. Utiliza esto para la ingesta masiva de eventos y mejorar el rendimiento.

Entrada

ParámetroTipoObligatorioDescripción
projectApiKeystringClave API del proyecto PostHog (token público para ingesta de eventos)
regionstringNoRegión de PostHog: us (predeterminado) o eu
batchstringArray JSON de eventos a capturar. Cada evento debe tener: event, distinct_id, y opcionalmente properties, timestamp. Ejemplo: [{"event": "page_view", "distinct_id": "user123", "properties": {"page": "/"}}]

Salida

ParámetroTipoDescripción
statusstringMensaje de estado que indica si el lote fue capturado correctamente
eventsProcessednumberNúmero de eventos procesados en el lote

posthog_list_events

Lista eventos en PostHog. Nota: Este endpoint está obsoleto pero se mantiene por compatibilidad. Para uso en producción, es preferible utilizar el endpoint Query con HogQL.

Entrada

ParámetroTipoObligatorioDescripción
personalApiKeystringClave API personal de PostHog (para acceso API autenticado)
regionstringNoRegión de PostHog: us (predeterminado) o eu
projectIdstringID del proyecto PostHog
limitnumberNoNúmero de eventos a devolver (predeterminado: 100, máximo: 100)
offsetnumberNoNúmero de eventos a omitir para paginación
eventstringNoFiltrar por nombre específico de evento
distinctIdstringNoFiltrar por distinct_id específico
beforestringNoMarca de tiempo ISO 8601 - solo devuelve eventos anteriores a esta hora
afterstringNoMarca de tiempo ISO 8601 - solo devuelve eventos posteriores a esta hora

Salida

ParámetroTipoDescripción
eventsarrayLista de eventos con sus propiedades y metadatos

posthog_list_persons

Lista personas (usuarios) en PostHog. Devuelve perfiles de usuario con sus propiedades e identificadores distintos.

Entrada

ParámetroTipoObligatorioDescripción
personalApiKeystringClave API personal de PostHog (para acceso API autenticado)
regionstringNoRegión de PostHog: us (predeterminado) o eu
projectIdstringID del proyecto de PostHog
limitnumberNoNúmero de personas a devolver (predeterminado: 100, máximo: 100)
offsetnumberNoNúmero de personas a omitir para paginación
searchstringNoBuscar personas por email, nombre o ID distintivo
distinctIdstringNoFiltrar por distinct_id específico

Salida

ParámetroTipoDescripción
personsarrayLista de personas con sus propiedades e identificadores

posthog_get_person

Obtener información detallada sobre una persona específica en PostHog mediante su ID o UUID.

Entrada

ParámetroTipoObligatorioDescripción
personalApiKeystringClave API personal de PostHog (para acceso API autenticado)
regionstringNoRegión de PostHog: us (predeterminado) o eu
projectIdstringID del proyecto de PostHog
personIdstringID o UUID de la persona a recuperar

Salida

ParámetroTipoDescripción
personobjectDetalles de la persona incluyendo propiedades e identificadores

posthog_delete_person

Elimina una persona de PostHog. Esto eliminará todos los eventos y datos asociados. Usar con precaución.

Entrada

ParámetroTipoObligatorioDescripción
personalApiKeystringClave API personal de PostHog (para acceso API autenticado)
regionstringNoRegión de PostHog: us (predeterminado) o eu
projectIdstringID del proyecto de PostHog
personIdstringID de persona o UUID a eliminar

Salida

ParámetroTipoDescripción
statusstringMensaje de estado que indica si la persona fue eliminada con éxito

posthog_query

Ejecuta una consulta HogQL en PostHog. HogQL es PostHog

Entrada

ParámetroTipoObligatorioDescripción
personalApiKeystringClave API personal de PostHog (para acceso API autenticado)
regionstringNoRegión de PostHog: us (predeterminado) o eu
projectIdstringID del proyecto de PostHog
querystringConsulta HogQL a ejecutar. Ejemplo: {"kind": "HogQLQuery", "query": "SELECT event, count() FROM events WHERE timestamp > now() - INTERVAL 1 DAY GROUP BY event"}
ExamplestringNoSin descripción
valuesstringNoCadena JSON opcional de valores de parámetros para consultas parametrizadas. Ejemplo: {"user_id": "123"}
ExamplestringNoSin descripción

Salida

ParámetroTipoDescripción
resultsarrayResultados de la consulta como un array de filas

posthog_list_insights

Lista todos los insights en un proyecto de PostHog. Devuelve configuraciones de insights, filtros y metadatos.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringEl ID del proyecto de PostHog
regionstringNoRegión en la nube de PostHog: "us" o "eu" (predeterminado: "us")
limitnumberNoNúmero de resultados a devolver por página (predeterminado: 100)
offsetnumberNoNúmero de resultados a omitir para la paginación

Salida

ParámetroTipoDescripción
countnumberNúmero total de insights en el proyecto
nextstringURL para la siguiente página de resultados
previousstringURL para la página anterior de resultados
resultsarrayLista de insights con sus configuraciones y metadatos

posthog_get_insight

Obtiene un insight específico por ID desde PostHog. Devuelve configuración detallada del insight, filtros y metadatos.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringEl ID del proyecto de PostHog
insightIdstringEl ID del insight a recuperar
regionstringNoRegión en la nube de PostHog: "us" o "eu" (predeterminado: "us")

Salida

ParámetroTipoDescripción
idnumberIdentificador único para el insight
namestringNombre del insight
descriptionstringDescripción del insight
filtersobjectConfiguración de filtros para el insight
queryobjectConfiguración de consulta para el insight
created_atstringMarca de tiempo ISO cuando se creó el insight
created_byobjectUsuario que creó el insight
last_modified_atstringMarca de tiempo ISO cuando se modificó por última vez el insight
last_modified_byobjectUsuario que modificó por última vez el insight
savedbooleanSi el insight está guardado
dashboardsarrayIDs de los dashboards donde aparece este insight
tagsarrayEtiquetas asociadas con el insight
favoritedbooleanSi el insight está marcado como favorito

posthog_create_insight

Crea un nuevo insight en PostHog. Requiere nombre del insight y configuración de filtros o consulta.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringEl ID del proyecto de PostHog
regionstringNoRegión en la nube de PostHog: "us" o "eu" (predeterminado: "us")
namestringNoNombre para el insight (opcional - PostHog generará un nombre derivado si no se proporciona)
descriptionstringNoDescripción del insight
filtersstringNoCadena JSON de configuración de filtros para el insight
querystringNoCadena JSON de configuración de consulta para el insight
dashboardsstringNoLista separada por comas de IDs de dashboard para añadir este insight
tagsstringNoLista separada por comas de etiquetas para el insight

Salida

ParámetroTipoDescripción
idnumberIdentificador único para el insight creado
namestringNombre del insight
descriptionstringDescripción del insight
filtersobjectConfiguración de filtro para el insight
queryobjectConfiguración de consulta para el insight
created_atstringMarca de tiempo ISO cuando se creó el insight
created_byobjectUsuario que creó el insight
last_modified_atstringMarca de tiempo ISO cuando se modificó por última vez el insight
savedbooleanSi el insight está guardado
dashboardsarrayIDs de los dashboards donde aparece este insight
tagsarrayEtiquetas asociadas con el insight

posthog_list_dashboards

Lista todos los dashboards en un proyecto de PostHog. Devuelve configuraciones de dashboard, mosaicos y metadatos.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringEl ID del proyecto de PostHog
regionstringNoRegión de la nube de PostHog: "us" o "eu" (predeterminado: "us")
limitnumberNoNúmero de resultados a devolver por página (predeterminado: 100)
offsetnumberNoNúmero de resultados a omitir para la paginación

Salida

ParámetroTipoDescripción
countnumberNúmero total de dashboards en el proyecto
nextstringURL para la siguiente página de resultados
previousstringURL para la página anterior de resultados
resultsarrayLista de dashboards con sus configuraciones y metadatos

posthog_get_dashboard

Obtén un panel específico por ID desde PostHog. Devuelve la configuración detallada del panel, los mosaicos y los metadatos.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringEl ID del proyecto de PostHog
dashboardIdstringEl ID del panel a recuperar
regionstringNoRegión en la nube de PostHog: "us" o "eu" (predeterminado: "us")

Salida

ParámetroTipoDescripción
idnumberIdentificador único para el panel
namestringNombre del panel
descriptionstringDescripción del panel
pinnedbooleanSi el panel está fijado
created_atstringMarca de tiempo ISO cuando se creó el panel
created_byobjectUsuario que creó el panel
last_modified_atstringMarca de tiempo ISO cuando se modificó por última vez el panel
last_modified_byobjectUsuario que modificó por última vez el panel
tilesarrayMosaicos/widgets en el panel con sus configuraciones
filtersobjectFiltros globales aplicados al panel
tagsarrayEtiquetas asociadas con el panel
restriction_levelnumberNivel de restricción de acceso para el panel

posthog_list_actions

Lista todas las acciones en un proyecto de PostHog. Devuelve definiciones de acciones, pasos y metadatos.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringEl ID del proyecto de PostHog
regionstringNoRegión en la nube de PostHog: "us" o "eu" (predeterminado: "us")
limitnumberNoNúmero de resultados a devolver por página (predeterminado: 100)
offsetnumberNoNúmero de resultados a omitir para la paginación

Salida

ParámetroTipoDescripción
countnumberNúmero total de acciones en el proyecto
nextstringURL para la siguiente página de resultados
previousstringURL para la página anterior de resultados
resultsarrayLista de acciones con sus definiciones y metadatos

posthog_list_cohorts

Lista todas las cohortes en un proyecto de PostHog. Devuelve definiciones de cohortes, filtros y recuentos de usuarios.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringEl ID del proyecto de PostHog
regionstringNoRegión en la nube de PostHog: "us" o "eu" (predeterminado: "us")
limitnumberNoNúmero de resultados a devolver por página (predeterminado: 100)
offsetnumberNoNúmero de resultados a omitir para la paginación

Salida

ParámetroTipoDescripción
countnumberNúmero total de cohortes en el proyecto
nextstringURL para la siguiente página de resultados
previousstringURL para la página anterior de resultados
resultsarrayLista de cohortes con sus definiciones y metadatos

posthog_get_cohort

Obtén una cohorte específica por ID desde PostHog. Devuelve la definición detallada de la cohorte, filtros y recuento de usuarios.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringEl ID del proyecto de PostHog
cohortIdstringEl ID de la cohorte a recuperar
regionstringNoRegión en la nube de PostHog: "us" o "eu" (predeterminado: "us")

Salida

ParámetroTipoDescripción
idnumberIdentificador único para la cohorte
namestringNombre de la cohorte
descriptionstringDescripción de la cohorte
groupsarrayGrupos que definen la cohorte
deletedbooleanSi la cohorte está eliminada
filtersobjectConfiguración de filtro para la cohorte
queryobjectConfiguración de consulta para la cohorte
created_atstringMarca de tiempo ISO cuando se creó la cohorte
created_byobjectUsuario que creó la cohorte
is_calculatingbooleanSi la cohorte está siendo calculada
last_calculationstringMarca de tiempo ISO del último cálculo
errors_calculatingnumberNúmero de errores durante el cálculo
countnumberNúmero de usuarios en la cohorte
is_staticbooleanSi la cohorte es estática
versionnumberNúmero de versión de la cohorte

posthog_create_cohort

Crea una nueva cohorte en PostHog. Requiere nombre de cohorte y configuración de filtro o consulta.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringEl ID del proyecto de PostHog
regionstringNoRegión en la nube de PostHog: "us" o "eu" (predeterminado: "us")
namestringNoNombre para la cohorte (opcional - PostHog usará "Untitled cohort" si no se proporciona)
descriptionstringNoDescripción de la cohorte
filtersstringNoCadena JSON de configuración de filtro para la cohorte
querystringNoCadena JSON de configuración de consulta para la cohorte
is_staticbooleanNoSi la cohorte es estática (predeterminado: false)
groupsstringNoCadena JSON de grupos que definen la cohorte

Salida

ParámetroTipoDescripción
idnumberIdentificador único para la cohorte creada
namestringNombre de la cohorte
descriptionstringDescripción de la cohorte
groupsarrayGrupos que definen la cohorte
deletedbooleanSi la cohorte está eliminada
filtersobjectConfiguración de filtro para la cohorte
queryobjectConfiguración de consulta para la cohorte
created_atstringMarca de tiempo ISO cuando se creó la cohorte
created_byobjectUsuario que creó la cohorte
is_calculatingbooleanSi la cohorte está siendo calculada
countnumberNúmero de usuarios en la cohorte
is_staticbooleanSi la cohorte es estática
versionnumberNúmero de versión de la cohorte

posthog_list_annotations

Lista todas las anotaciones en un proyecto de PostHog. Devuelve el contenido de las anotaciones, marcas de tiempo e insights asociados.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringEl ID del proyecto de PostHog
regionstringNoRegión en la nube de PostHog: "us" o "eu" (predeterminado: "us")
limitnumberNoNúmero de resultados a devolver por página (predeterminado: 100)
offsetnumberNoNúmero de resultados a omitir para la paginación

Salida

ParámetroTipoDescripción
countnumberNúmero total de anotaciones en el proyecto
nextstringURL para la siguiente página de resultados
previousstringURL para la página anterior de resultados
resultsarrayLista de anotaciones con su contenido y metadatos

posthog_create_annotation

Crea una nueva anotación en PostHog. Marca eventos importantes en tus gráficos con fecha y descripción.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringEl ID del proyecto de PostHog
regionstringNoRegión en la nube de PostHog: "us" o "eu" (predeterminado: "us")
contentstringContenido/texto de la anotación
date_markerstringMarca de tiempo ISO que indica cuándo se aplica la anotación (p. ej., "2024-01-15T10:00:00Z")
scopestringNoAlcance de la anotación: "project" o "dashboard_item" (predeterminado: "project")
dashboard_itemstringNoID del elemento del panel para adjuntar esta anotación
insight_short_idstringNoID corto del insight para adjuntar esta anotación

Salida

ParámetroTipoDescripción
idnumberIdentificador único para la anotación creada
contentstringContenido/texto de la anotación
date_markerstringMarca de tiempo ISO que indica cuándo se aplica la anotación
created_atstringMarca de tiempo ISO cuando se creó la anotación
updated_atstringMarca de tiempo ISO cuando se actualizó por última vez la anotación
created_byobjectUsuario que creó la anotación
dashboard_itemnumberID del elemento del panel al que está adjunta esta anotación
insight_short_idstringID corto del insight al que está adjunta esta anotación
insight_namestringNombre del insight al que está adjunta esta anotación
scopestringÁmbito de la anotación (proyecto o elemento_del_panel)
deletedbooleanSi la anotación está eliminada

posthog_list_feature_flags

Listar todas las feature flags en un proyecto de PostHog

Entrada

ParámetroTipoRequeridoDescripción
projectIdstringEl ID del proyecto de PostHog
regionstringRegión de la nube de PostHog: us o eu
apiKeystringClave API personal de PostHog
limitnumberNoNúmero de resultados a devolver
offsetnumberNoNúmero de resultados a omitir

Salida

ParámetroTipoDescripción
resultsarrayLista de feature flags

posthog_get_feature_flag

Obtener detalles de un feature flag específico

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringEl ID del proyecto de PostHog
flagIdstringEl ID del feature flag
regionstringRegión de la nube de PostHog: us o eu
apiKeystringClave API personal de PostHog

Salida

ParámetroTipoDescripción
flagobjectDetalles del feature flag

posthog_create_feature_flag

Crear un nuevo feature flag en PostHog

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringEl ID del proyecto de PostHog
regionstringRegión de la nube de PostHog: us o eu
apiKeystringClave API personal de PostHog
namestringNoNombre del feature flag (opcional - puede estar vacío)
keystringClave del feature flag (identificador único)
filtersstringNoFiltros del feature flag como cadena JSON
activebooleanNoSi el flag está activo (predeterminado: true)
ensureExperienceContinuitybooleanNoSi se debe asegurar la continuidad de la experiencia (predeterminado: false)
rolloutPercentagenumberNoPorcentaje de despliegue (0-100)

Salida

ParámetroTipoDescripción
flagobjectBandera de característica creada

posthog_update_feature_flag

Actualizar una bandera de característica existente en PostHog

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringEl ID del proyecto de PostHog
flagIdstringEl ID de la bandera de característica
regionstringRegión de la nube de PostHog: us o eu
apiKeystringClave API personal de PostHog
namestringNoNombre de la bandera de característica
keystringNoClave de la bandera de característica (identificador único)
filtersstringNoFiltros de la bandera de característica como cadena JSON
activebooleanNoSi la bandera está activa
ensureExperienceContinuitybooleanNoSi se debe asegurar la continuidad de la experiencia
rolloutPercentagenumberNoPorcentaje de despliegue (0-100)

Salida

ParámetroTipoDescripción
flagobjectBandera de característica actualizada

posthog_delete_feature_flag

Eliminar una bandera de característica de PostHog

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringEl ID del proyecto de PostHog
flagIdstringEl ID de la bandera de característica a eliminar
regionstringRegión de la nube de PostHog: us o eu
apiKeystringClave API personal de PostHog

Salida

ParámetroTipoDescripción
successbooleanSi la eliminación fue exitosa
messagestringMensaje de confirmación

posthog_evaluate_flags

Evalúa las feature flags para un usuario o grupo específico. Este es un endpoint público que utiliza la clave API del proyecto.

Entrada

ParámetroTipoObligatorioDescripción
regionstringRegión de PostHog cloud: us o eu
projectApiKeystringClave API del proyecto PostHog (no clave API personal)
distinctIdstringEl ID distintivo del usuario para el que se evaluarán las flags
groupsstringNoGrupos como cadena JSON (p. ej., {"company": "company_id_in_your_db"})
personPropertiesstringNoPropiedades de persona como cadena JSON
groupPropertiesstringNoPropiedades de grupo como cadena JSON

Salida

ParámetroTipoDescripción
featureFlagsobjectEvaluaciones de feature flag (pares clave-valor donde los valores son booleanos o variantes de cadena)
featureFlagPayloadsobjectCargas adicionales adjuntas a las feature flags
errorsWhileComputingFlagsbooleanSi hubo errores al calcular las flags

posthog_list_experiments

Lista todos los experimentos en un proyecto de PostHog

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringEl ID del proyecto PostHog
regionstringRegión de PostHog cloud: us o eu
apiKeystringClave API personal de PostHog
limitnumberNoNúmero de resultados a devolver
offsetnumberNoNúmero de resultados a omitir

Salida

ParámetroTipoDescripción
resultsarrayLista de experimentos

posthog_get_experiment

Obtener detalles de un experimento específico

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringEl ID del proyecto PostHog
experimentIdstringEl ID del experimento
regionstringRegión en la nube de PostHog: us o eu
apiKeystringClave API personal de PostHog

Salida

ParámetroTipoDescripción
experimentobjectDetalles del experimento

posthog_create_experiment

Crear un nuevo experimento en PostHog

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringEl ID del proyecto PostHog
regionstringRegión en la nube de PostHog: us o eu
apiKeystringClave API personal de PostHog
namestringNoNombre del experimento (opcional)
descriptionstringNoDescripción del experimento
featureFlagKeystringClave de feature flag para usar en el experimento
parametersstringNoParámetros del experimento como cadena JSON
filtersstringNoFiltros del experimento como cadena JSON
variantsstringNoVariantes del experimento como cadena JSON
startDatestringNoFecha de inicio del experimento (formato ISO)
endDatestringNoFecha de finalización del experimento (formato ISO)

Salida

ParámetroTipoDescripción
experimentobjetoExperimento creado

posthog_list_surveys

Lista todas las encuestas en un proyecto de PostHog. Las encuestas te permiten recopilar comentarios de los usuarios.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringID del proyecto de PostHog
regionstringNoRegión en la nube de PostHog: us o eu (predeterminado: us)
limitnumberNoNúmero de resultados a devolver (predeterminado: 100)
offsetnumberNoNúmero de resultados a omitir para la paginación

Salida

ParámetroTipoDescripción
surveysarrayLista de encuestas en el proyecto

posthog_get_survey

Obtiene detalles de una encuesta específica en PostHog por ID.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringID del proyecto de PostHog
surveyIdstringID de la encuesta a recuperar
regionstringNoRegión en la nube de PostHog: us o eu (predeterminado: us)

Salida

ParámetroTipoDescripción
surveyobjetoDetalles de la encuesta

posthog_create_survey

Crea una nueva encuesta en PostHog. Admite tipos de preguntas: Básica (abierta), Enlace, Valoración y Opción múltiple.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringID del proyecto de PostHog
regionstringNoRegión de la nube de PostHog: us o eu (predeterminado: us)
namestringNoNombre de la encuesta (opcional)
descriptionstringNoDescripción de la encuesta
typestringNoTipo de encuesta: popover (en la aplicación) o api (implementación personalizada) (predeterminado: popover)
questionsstringCadena JSON del array de preguntas de la encuesta. Cada pregunta debe tener tipo (open/link/rating/multiple_choice) y texto de la pregunta. Las preguntas de valoración pueden tener escala (1-10), lowerBoundLabel, upperBoundLabel. Las preguntas de opción múltiple necesitan un array de opciones. Las preguntas de enlace pueden tener buttonText.
startDatestringNoFecha de inicio de la encuesta en formato ISO 8601
endDatestringNoFecha de finalización de la encuesta en formato ISO 8601
appearancestringNoCadena JSON de configuración de apariencia (colores, posición, etc.)
conditionsstringNoCadena JSON de condiciones de visualización (coincidencia de URL, etc.)
targetingFlagFiltersstringNoCadena JSON de filtros de feature flag para segmentación
linkedFlagIdstringNoID de feature flag para vincular a esta encuesta
responsesLimitnumberNoNúmero máximo de respuestas a recopilar

Salida

ParámetroTipoDescripción
surveyobjetoDetalles de la encuesta creada

posthog_update_survey

Actualiza una encuesta existente en PostHog. Puede modificar preguntas, apariencia, condiciones y otros ajustes.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringID del proyecto de PostHog
surveyIdstringID de la encuesta a actualizar
regionstringNoRegión en la nube de PostHog: us o eu (predeterminado: us)
namestringNoNombre de la encuesta
descriptionstringNoDescripción de la encuesta
typestringNoTipo de encuesta: popover o api
questionsstringNoCadena JSON del array de preguntas de la encuesta. Cada pregunta debe tener tipo (open/link/rating/multiple_choice) y texto de la pregunta.
startDatestringNoFecha de inicio de la encuesta en formato ISO 8601
endDatestringNoFecha de finalización de la encuesta en formato ISO 8601
appearancestringNoCadena JSON de configuración de apariencia (colores, posición, etc.)
conditionsstringNoCadena JSON de condiciones de visualización (coincidencia de URL, etc.)
targetingFlagFiltersstringNoCadena JSON de filtros de feature flag para segmentación
linkedFlagIdstringNoID de feature flag para vincular a esta encuesta
responsesLimitnumberNoNúmero máximo de respuestas a recopilar
archivedbooleanNoArchivar o desarchivar la encuesta

Salida

ParámetroTipoDescripción
surveyobjetoDetalles actualizados de la encuesta

posthog_list_session_recordings

Listar grabaciones de sesión en un proyecto de PostHog. Las grabaciones de sesión capturan las interacciones del usuario con tu aplicación.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringID del proyecto de PostHog
regionstringNoRegión en la nube de PostHog: us o eu (predeterminado: us)
limitnumberNoNúmero de resultados a devolver (predeterminado: 50)
offsetnumberNoNúmero de resultados a omitir para la paginación

Salida

ParámetroTipoDescripción
recordingsarrayLista de grabaciones de sesión

posthog_get_session_recording

Obtener detalles de una grabación de sesión específica en PostHog por ID.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringID del proyecto de PostHog
recordingIdstringID de la grabación de sesión a recuperar
regionstringNoRegión en la nube de PostHog: us o eu (predeterminado: us)

Salida

ParámetroTipoDescripción
recordingobjetoDetalles de la grabación de sesión

posthog_list_recording_playlists

Lista las listas de reproducción de grabaciones de sesión en un proyecto de PostHog. Las listas de reproducción te permiten organizar y seleccionar grabaciones de sesión.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
projectIdstringID del proyecto de PostHog
regionstringNoRegión en la nube de PostHog: us o eu (predeterminado: us)
limitnumberNoNúmero de resultados a devolver (predeterminado: 100)
offsetnumberNoNúmero de resultados a omitir para la paginación

Salida

ParámetroTipoDescripción
playlistsarrayLista de listas de reproducción de grabaciones de sesión

posthog_list_event_definitions

Lista todas las definiciones de eventos en un proyecto de PostHog. Las definiciones de eventos representan eventos rastreados con metadatos como descripciones, etiquetas y estadísticas de uso.

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringID del proyecto de PostHog
regionstringRegión en la nube de PostHog: us o eu
apiKeystringClave API personal de PostHog
limitnumberNoNúmero de resultados a devolver por página (predeterminado: 100)
offsetnumberNoEl índice inicial desde el cual devolver resultados
searchstringNoTérmino de búsqueda para filtrar definiciones de eventos por nombre

Salida

ParámetroTipoDescripción
countnumberNúmero total de definiciones de eventos
nextstringURL para la siguiente página de resultados
previousstringURL para la página anterior de resultados
resultsarrayLista de definiciones de eventos

posthog_get_event_definition

Obtén detalles de una definición de evento específica en PostHog. Devuelve información completa sobre el evento, incluyendo metadatos, estadísticas de uso y estado de verificación.

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringID del proyecto PostHog
eventDefinitionIdstringID de la definición de evento a recuperar
regionstringRegión de la nube PostHog: us o eu
apiKeystringClave API personal de PostHog

Salida

ParámetroTipoDescripción
idstringIdentificador único para la definición de evento
namestringNombre del evento
descriptionstringDescripción del evento
tagsarrayEtiquetas asociadas con el evento
volume_30_daynumberNúmero de eventos recibidos en los últimos 30 días
query_usage_30_daynumberNúmero de veces que este evento fue consultado en los últimos 30 días
created_atstringMarca de tiempo ISO cuando se creó el evento
last_seen_atstringMarca de tiempo ISO cuando se vio el evento por última vez
updated_atstringMarca de tiempo ISO cuando se actualizó el evento
updated_byobjectUsuario que actualizó el evento por última vez
verifiedbooleanSi el evento ha sido verificado
verified_atstringMarca de tiempo ISO cuando se verificó el evento
verified_bystringUsuario que verificó el evento

posthog_update_event_definition

Actualiza una definición de evento en PostHog. Puede modificar la descripción, etiquetas y estado de verificación para mantener esquemas de eventos limpios.

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringID del proyecto de PostHog
eventDefinitionIdstringID de la definición de evento a actualizar
regionstringRegión de la nube de PostHog: us o eu
apiKeystringClave API personal de PostHog
descriptionstringNoDescripción actualizada para el evento
tagsstringNoLista de etiquetas separadas por comas para asociar con el evento
verifiedbooleanNoSi se debe marcar el evento como verificado

Salida

ParámetroTipoDescripción
idstringIdentificador único para la definición del evento
namestringNombre del evento
descriptionstringDescripción actualizada del evento
tagsarrayEtiquetas actualizadas asociadas con el evento
volume_30_daynumberNúmero de eventos recibidos en los últimos 30 días
query_usage_30_daynumberNúmero de veces que este evento fue consultado en los últimos 30 días
created_atstringMarca de tiempo ISO cuando se creó el evento
last_seen_atstringMarca de tiempo ISO cuando se vio el evento por última vez
updated_atstringMarca de tiempo ISO cuando se actualizó el evento
updated_byobjectUsuario que actualizó el evento por última vez
verifiedbooleanSi el evento ha sido verificado
verified_atstringMarca de tiempo ISO cuando se verificó el evento
verified_bystringUsuario que verificó el evento

posthog_list_property_definitions

Lista todas las definiciones de propiedades en un proyecto de PostHog. Las definiciones de propiedades representan propiedades rastreadas con metadatos como descripciones, etiquetas, tipos y estadísticas de uso.

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringID del proyecto de PostHog
regionstringRegión de la nube de PostHog: us o eu
apiKeystringClave API personal de PostHog
limitnumberNoNúmero de resultados a devolver por página (predeterminado: 100)
offsetnumberNoEl índice inicial desde el cual devolver resultados
searchstringNoTérmino de búsqueda para filtrar definiciones de propiedades por nombre
typestringNoFiltrar por tipo de propiedad: event, person o group

Salida

ParámetroTipoDescripción
countnumberNúmero total de definiciones de propiedades
nextstringURL para la siguiente página de resultados
previousstringURL para la página anterior de resultados
resultsarrayLista de definiciones de propiedades

posthog_get_property_definition

Obtén detalles de una definición de propiedad específica en PostHog. Devuelve información completa sobre la propiedad, incluyendo metadatos, tipo, estadísticas de uso y estado de verificación.

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringID del proyecto de PostHog
propertyDefinitionIdstringID de la definición de propiedad a recuperar
regionstringRegión de la nube de PostHog: us o eu
apiKeystringClave API personal de PostHog

Salida

ParámetroTipoDescripción
idstringIdentificador único para la definición de propiedad
namestringNombre de la propiedad
descriptionstringDescripción de la propiedad
tagsarrayEtiquetas asociadas con la propiedad
is_numericalbooleanSi la propiedad es numérica
is_seen_on_filtered_eventsbooleanSi la propiedad se ve en eventos filtrados
property_typestringEl tipo de datos de la propiedad
typestringTipo de propiedad: evento, persona o grupo
volume_30_daynumberNúmero de veces que se vio la propiedad en los últimos 30 días
query_usage_30_daynumberNúmero de veces que se consultó esta propiedad en los últimos 30 días
created_atstringMarca de tiempo ISO cuando se creó la propiedad
updated_atstringMarca de tiempo ISO cuando se actualizó la propiedad
updated_byobjectUsuario que actualizó por última vez la propiedad
verifiedbooleanSi la propiedad ha sido verificada
verified_atstringMarca de tiempo ISO cuando se verificó la propiedad
verified_bystringUsuario que verificó la propiedad
examplestringValor de ejemplo para la propiedad

posthog_update_property_definition

Actualiza una definición de propiedad en PostHog. Puede modificar la descripción, etiquetas, tipo de propiedad y estado de verificación para mantener esquemas de propiedades limpios.

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringID del proyecto PostHog
propertyDefinitionIdstringID de definición de propiedad a actualizar
regionstringRegión de la nube PostHog: us o eu
apiKeystringClave API personal de PostHog
descriptionstringNoDescripción actualizada para la propiedad
tagsstringNoLista separada por comas de etiquetas para asociar con la propiedad
verifiedbooleanNoSi se debe marcar la propiedad como verificada
property_typestringNoEl tipo de datos de la propiedad (p. ej., String, Numeric, Boolean, DateTime, etc.)

Salida

ParámetroTipoDescripción
idstringIdentificador único para la definición de la propiedad
namestringNombre de la propiedad
descriptionstringDescripción actualizada de la propiedad
tagsarrayEtiquetas actualizadas asociadas con la propiedad
is_numericalbooleanSi la propiedad es numérica
is_seen_on_filtered_eventsbooleanSi la propiedad se ve en eventos filtrados
property_typestringEl tipo de datos de la propiedad
typestringTipo de propiedad: evento, persona o grupo
volume_30_daynumberNúmero de veces que se vio la propiedad en los últimos 30 días
query_usage_30_daynumberNúmero de veces que se consultó esta propiedad en los últimos 30 días
created_atstringMarca de tiempo ISO cuando se creó la propiedad
updated_atstringMarca de tiempo ISO cuando se actualizó la propiedad
updated_byobjectUsuario que actualizó la propiedad por última vez
verifiedbooleanSi la propiedad ha sido verificada
verified_atstringMarca de tiempo ISO cuando se verificó la propiedad
verified_bystringUsuario que verificó la propiedad
examplestringValor de ejemplo para la propiedad

posthog_list_projects

Lista todos los proyectos en la organización. Devuelve detalles del proyecto incluyendo IDs, nombres, tokens API y configuraciones. Útil para obtener IDs de proyectos necesarios para otros endpoints.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
regionstringNoRegión en la nube: us o eu (predeterminado: us)

Salida

ParámetroTipoDescripción
projectsarrayLista de proyectos con su configuración y ajustes

posthog_get_project

Obtener información detallada sobre un proyecto específico por ID. Devuelve la configuración completa del proyecto, ajustes y feature flags.

Entrada

ParámetroTipoObligatorioDescripción
projectIdstringID del proyecto (ID numérico o UUID)
apiKeystringClave API personal de PostHog
regionstringNoRegión en la nube: us o eu (predeterminado: us)

Salida

ParámetroTipoDescripción
projectobjectInformación detallada del proyecto con todos los ajustes de configuración

posthog_list_organizations

Listar todas las organizaciones a las que el usuario tiene acceso. Devuelve detalles de la organización incluyendo nombre, slug, nivel de membresía y características de producto disponibles.

Entrada

ParámetroTipoObligatorioDescripción
apiKeystringClave API personal de PostHog
regionstringNoRegión en la nube: us o eu (predeterminado: us)

Salida

ParámetroTipoDescripción
organizationsarrayLista de organizaciones con sus configuraciones y características

posthog_get_organization

Obtén información detallada sobre una organización específica por ID. Devuelve configuraciones completas de la organización, características, uso e información del equipo.

Entrada

ParámetroTipoObligatorioDescripción
organizationIdstringID de la organización (UUID)
apiKeystringClave API personal de PostHog
regionstringNoRegión en la nube: us o eu (predeterminado: us)

Salida

ParámetroTipoDescripción
organizationobjectInformación detallada de la organización con configuraciones y características

Notas

  • Categoría: tools
  • Tipo: posthog
On this page

On this page

Instrucciones de uso
Herramientas
posthog_capture_event
Entrada
Salida
posthog_batch_events
Entrada
Salida
posthog_list_events
Entrada
Salida
posthog_list_persons
Entrada
Salida
posthog_get_person
Entrada
Salida
posthog_delete_person
Entrada
Salida
posthog_query
Entrada
Salida
posthog_list_insights
Entrada
Salida
posthog_get_insight
Entrada
Salida
posthog_create_insight
Entrada
Salida
posthog_list_dashboards
Entrada
Salida
posthog_get_dashboard
Entrada
Salida
posthog_list_actions
Entrada
Salida
posthog_list_cohorts
Entrada
Salida
posthog_get_cohort
Entrada
Salida
posthog_create_cohort
Entrada
Salida
posthog_list_annotations
Entrada
Salida
posthog_create_annotation
Entrada
Salida
posthog_list_feature_flags
Entrada
Salida
posthog_get_feature_flag
Entrada
Salida
posthog_create_feature_flag
Entrada
Salida
posthog_update_feature_flag
Entrada
Salida
posthog_delete_feature_flag
Entrada
Salida
posthog_evaluate_flags
Entrada
Salida
posthog_list_experiments
Entrada
Salida
posthog_get_experiment
Entrada
Salida
posthog_create_experiment
Entrada
Salida
posthog_list_surveys
Entrada
Salida
posthog_get_survey
Entrada
Salida
posthog_create_survey
Entrada
Salida
posthog_update_survey
Entrada
Salida
posthog_list_session_recordings
Entrada
Salida
posthog_get_session_recording
Entrada
Salida
posthog_list_recording_playlists
Entrada
Salida
posthog_list_event_definitions
Entrada
Salida
posthog_get_event_definition
Entrada
Salida
posthog_update_event_definition
Entrada
Salida
posthog_list_property_definitions
Entrada
Salida
posthog_get_property_definition
Entrada
Salida
posthog_update_property_definition
Entrada
Salida
posthog_list_projects
Entrada
Salida
posthog_get_project
Entrada
Salida
posthog_list_organizations
Entrada
Salida
posthog_get_organization
Entrada
Salida
Notas
Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started