# PostHog (/es/integrations/analytics/posthog)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 720 · updated: 2026-09-23 -->
Related: [Integraciones de Analytics](/es/integrations/analytics/overview.md), [Adobe Analytics](/es/integrations/analytics/adobe.md), [Amplitude](/es/integrations/analytics/amplitude.md), [Clarity](/es/integrations/analytics/clarity.md), [Clearbit](/es/integrations/analytics/clearbit.md), [Fathom](/es/integrations/analytics/fathom.md)

Añade lo siguiente a tu archivo `docs.json` para enviar Analytics a PostHog.

Solo necesitas incluir `apiHost` si alojas PostHog por tu cuenta. De forma predeterminada, Mintlify envía los eventos a tu proyecto de PostHog a través del proxy `https://ph.mintlify.com`.

<CodeGroup>
  <CodeBlockTabs defaultValue="Opciones de Analytics en docs.json" groupId="ejemplo+opciones-de-analytics-en-docs-json">
    <CodeBlockTabsList>
      <CodeBlockTabsTrigger value="Opciones de Analytics en docs.json">
        Opciones de Analytics en docs.json
      </CodeBlockTabsTrigger>

      <CodeBlockTabsTrigger value="Ejemplo">
        Ejemplo
      </CodeBlockTabsTrigger>
    </CodeBlockTabsList>

    <CodeBlockTab value="Opciones de Analytics en docs.json">
      ```json  
      "integrations": {
          "posthog": {
              "apiKey": "YOUR_POSTHOG_PROJECT_API_KEY",
              "apiHost": "optional",
              "sessionRecording": true
          }
      }
      ```
    </CodeBlockTab>

    <CodeBlockTab value="Ejemplo">
      ```json  
      "integrations": {
          "posthog": {
              "apiKey": "phc_TXdpocbYTeZVm5VJmMzHTMrCofBQu3e0kN7HGMNGTVW"
          }
      }
      ```
    </CodeBlockTab>
  </CodeBlockTabs>
</CodeGroup>

<div id="configuration-options">
  ### Opciones de configuración [#opciones-de-configuración]
</div>

<ParamField path="apiKey" type="string">
  La API key de tu proyecto de PostHog. Debe empezar con `phc_`.

  Esta clave es un token del lado del cliente pensado para ser público. Es la misma clave que tu navegador envía con cada evento de Analytics. Puedes confirmarla sin problema en el repositorio de tu documentación.
</ParamField>

<ParamField path="apiHost" type="string">
  La URL de tu instancia de PostHog. Solo es obligatorio si alojas PostHog por tu cuenta. De forma predeterminada es `https://ph.mintlify.com` (el proxy de PostHog de Mintlify).
</ParamField>

<ParamField path="sessionRecording" type="boolean" default="true">
  Activa o desactiva la grabación de sesiones. Establécelo en `false` para desactivar las grabaciones de sesiones y mantener Analytics habilitado.
</ParamField>

<div id="session-recordings">
  ## Grabaciones de sesiones [#grabaciones-de-sesiones]
</div>

Las grabaciones de sesiones se habilitan de forma predeterminada al configurar PostHog. Para desactivar las grabaciones de sesiones y mantener Analytics habilitado, establece `sessionRecording` en `false` en tu configuración.

```json title="Disable session recordings"
"integrations": {
    "posthog": {
        "apiKey": "phc_your-key",
        "sessionRecording": false
    }
}
```

Debes agregar la URL de tu sitio de documentación a la sección "Authorized domains for recordings" de PostHog antes de poder recibir grabaciones de sesión. La opción para agregar tu URL se encuentra en la configuración del proyecto de PostHog.
