mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
2ccd573b95
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
266 lines
8.1 KiB
Plaintext
266 lines
8.1 KiB
Plaintext
---
|
|
title: "Integraciones"
|
|
description: "Conecta plataformas de analítica, widgets de chat y servicios de terceros a tu sitio Mintlify mediante la configuración de integraciones en docs.json."
|
|
keywords: ["integrations", "analytics", "google analytics", "posthog", "segment", "intercom", "hotjar", "mixpanel", "amplitude", "docs.json"]
|
|
boost: 3
|
|
---
|
|
|
|
Usa el campo `integrations` en `docs.json` para conectar plataformas de analítica de terceros, herramientas de chat y otros servicios a tu sitio de documentación.
|
|
|
|
## Ajustes
|
|
|
|
Configura todas las integraciones como propiedades del objeto `integrations` en tu archivo `docs.json`:
|
|
|
|
```json docs.json
|
|
"integrations": {
|
|
"ga4": {
|
|
"measurementId": "G-XXXXXXXXXX"
|
|
}
|
|
}
|
|
```
|
|
|
|
### Analítica
|
|
|
|
<ResponseField name="integrations.adobe" type="object">
|
|
Integración con Adobe Analytics.
|
|
|
|
<Expandable title="integrations.adobe">
|
|
<ResponseField name="launchUrl" type="string (uri)" required>
|
|
Tu URL de lanzamiento de Adobe Analytics.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.amplitude" type="object">
|
|
Integración con Amplitude Analytics.
|
|
|
|
<Expandable title="integrations.amplitude">
|
|
<ResponseField name="apiKey" type="string" required>
|
|
Tu clave de API de Amplitude.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.clarity" type="object">
|
|
Integración con Microsoft Clarity para grabación de sesiones y mapas de calor.
|
|
|
|
<Expandable title="integrations.clarity">
|
|
<ResponseField name="projectId" type="string" required>
|
|
Tu ID de proyecto de Microsoft Clarity.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.fathom" type="object">
|
|
Integración con Fathom Analytics.
|
|
|
|
<Expandable title="integrations.fathom">
|
|
<ResponseField name="siteId" type="string" required>
|
|
Tu ID de sitio de Fathom.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.ga4" type="object">
|
|
Integración con Google Analytics 4.
|
|
|
|
<Expandable title="integrations.ga4">
|
|
<ResponseField name="measurementId" type="string matching ^G" required>
|
|
Tu ID de medición de Google Analytics 4. Debe comenzar con `G`.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.gtm" type="object">
|
|
Integración con Google Tag Manager.
|
|
|
|
<Expandable title="integrations.gtm">
|
|
<ResponseField name="tagId" type="string matching ^G" required>
|
|
Tu ID de contenedor de Google Tag Manager. Debe comenzar con `G`.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.heap" type="object">
|
|
Integración con Heap Analytics.
|
|
|
|
<Expandable title="integrations.heap">
|
|
<ResponseField name="appId" type="string" required>
|
|
Tu ID de aplicación de Heap.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.hightouch" type="object">
|
|
Integración de activación de datos de Hightouch.
|
|
|
|
<Expandable title="integrations.hightouch">
|
|
<ResponseField name="writeKey" type="string" required>
|
|
Tu write key de Hightouch.
|
|
</ResponseField>
|
|
<ResponseField name="apiHost" type="string">
|
|
Tu host de API de Hightouch.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.hotjar" type="object">
|
|
Integración con Hotjar para mapas de calor y grabación de sesiones.
|
|
|
|
<Expandable title="integrations.hotjar">
|
|
<ResponseField name="hjid" type="string" required>
|
|
Tu ID de sitio de Hotjar.
|
|
</ResponseField>
|
|
<ResponseField name="hjsv" type="string" required>
|
|
Tu versión de script de Hotjar.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.logrocket" type="object">
|
|
Integración con LogRocket para reproducción de sesiones.
|
|
|
|
<Expandable title="integrations.logrocket">
|
|
<ResponseField name="appId" type="string" required>
|
|
Tu ID de aplicación de LogRocket.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.mixpanel" type="object">
|
|
Integración con Mixpanel para analítica de producto.
|
|
|
|
<Expandable title="integrations.mixpanel">
|
|
<ResponseField name="projectToken" type="string" required>
|
|
Tu token de proyecto de Mixpanel.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.pirsch" type="object">
|
|
Integración con Pirsch para analítica respetuosa con la privacidad.
|
|
|
|
<Expandable title="integrations.pirsch">
|
|
<ResponseField name="id" type="string" required>
|
|
Tu ID de sitio de Pirsch.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.plausible" type="object">
|
|
Integración con Plausible para analítica respetuosa con la privacidad.
|
|
|
|
<Expandable title="integrations.plausible">
|
|
<ResponseField name="domain" type="string" required>
|
|
Tu dominio de Plausible.
|
|
</ResponseField>
|
|
<ResponseField name="server" type="string">
|
|
Tu servidor de Plausible, si lo alojas tú mismo.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.posthog" type="object">
|
|
Integración con PostHog para analítica de producto.
|
|
|
|
<Expandable title="integrations.posthog">
|
|
<ResponseField name="apiKey" type="string matching ^phc_" required>
|
|
Tu clave de API de PostHog. Debe comenzar con `phc_`.
|
|
</ResponseField>
|
|
<ResponseField name="apiHost" type="string (uri)">
|
|
Tu host de API de PostHog. Requerido si alojas PostHog tú mismo.
|
|
</ResponseField>
|
|
<ResponseField name="sessionRecording" type="boolean">
|
|
Si se habilita la grabación de sesiones. El valor predeterminado es `false`.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.segment" type="object">
|
|
Integración con Segment como plataforma de datos de clientes.
|
|
|
|
<Expandable title="integrations.segment">
|
|
<ResponseField name="key" type="string" required>
|
|
Tu write key de Segment.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
### Chat y soporte
|
|
|
|
<ResponseField name="integrations.frontchat" type="object">
|
|
Integración con el widget de chat de Front.
|
|
|
|
<Expandable title="integrations.frontchat">
|
|
<ResponseField name="snippetId" type="string" required>
|
|
Tu ID de snippet de chat de Front. Longitud mínima: 6.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.intercom" type="object">
|
|
Integración con Intercom para mensajería con clientes.
|
|
|
|
<Expandable title="integrations.intercom">
|
|
<ResponseField name="appId" type="string" required>
|
|
Tu ID de aplicación de Intercom. Longitud mínima: 6.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
### Enriquecimiento de datos
|
|
|
|
<ResponseField name="integrations.clearbit" type="object">
|
|
Integración con Clearbit para enriquecimiento de datos de visitantes.
|
|
|
|
<Expandable title="integrations.clearbit">
|
|
<ResponseField name="publicApiKey" type="string" required>
|
|
Tu clave de API pública de Clearbit.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
### Configuración de la plataforma
|
|
|
|
<ResponseField name="integrations.telemetry" type="object">
|
|
Configuración de telemetría de Mintlify.
|
|
|
|
<Expandable title="integrations.telemetry">
|
|
<ResponseField name="enabled" type="boolean">
|
|
Si se habilita la telemetría de Mintlify. Cuando se establece en `false`, las funciones de feedback también se deshabilitan y no aparecen en las páginas de tu documentación.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
<ResponseField name="integrations.cookies" type="object">
|
|
Configuración de cookies para tu sitio de documentación.
|
|
|
|
<Expandable title="integrations.cookies">
|
|
<ResponseField name="key" type="string">
|
|
Nombre de la clave de cookie.
|
|
</ResponseField>
|
|
<ResponseField name="value" type="string">
|
|
Valor de la cookie.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
## Ejemplo
|
|
|
|
```json docs.json
|
|
"integrations": {
|
|
"ga4": {
|
|
"measurementId": "G-XXXXXXXXXX"
|
|
},
|
|
"posthog": {
|
|
"apiKey": "phc_XXXXXXXXXX"
|
|
},
|
|
"intercom": {
|
|
"appId": "abc12345"
|
|
},
|
|
"telemetry": {
|
|
"enabled": true
|
|
}
|
|
}
|
|
```
|