> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configura la integración con GoHighLevel

> Aprende a conectar GoHighLevel a tus landing pages de LanderLab para sincronizar los leads como contactos y disparar workflows en tiempo real.

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/z2Nyn8JYMMirC6py/images/LL-GHL.png?fit=max&auto=format&n=z2Nyn8JYMMirC6py&q=85&s=3a555558695f500bfe94a2352d94ac18" alt="Logotipos de LanderLab y GoHighLevel" width="1200" height="600" data-path="images/LL-GHL.png" />
</Frame>

## Qué es GoHighLevel y por qué usar esta integración

GoHighLevel (GHL) es una plataforma todo en uno de CRM y automatización de marketing que usan agencias y performance marketers para gestionar contactos, pipelines y workflows automatizados. Cuando conectas GoHighLevel a una landing page de LanderLab, cada lead que envía tu formulario llega al instante a tu subcuenta de GHL como contacto nuevo. También puedes disparar un workflow de GHL al mismo tiempo para inscribir al lead en cualquier automatización que tengas configurada.

La conexión con GoHighLevel funciona en dos fases. Primero añades tu subcuenta de GoHighLevel a LanderLab con tu Location ID y tu API Key. Después conectas esa cuenta a tu landing page y configuras la acción, el workflow, las etiquetas y el mapeo de campos.

<Note>
  Las integraciones de GoHighLevel **se guardan de forma global en tu cuenta**. Cuando añades tu subcuenta de GHL, puedes reutilizarla en varias landing pages sin volver a introducir tus credenciales.
</Note>

***

## Antes de empezar

Necesitarás dos datos de tu cuenta de GoHighLevel:

**Location ID**

El Location ID es el identificador único de tu subcuenta de GHL. Para encontrarlo:

1. Inicia sesión en tu subcuenta de GoHighLevel
2. Ve a **Settings**, en la esquina inferior derecha
3. Haz clic en **Business Profile** en la barra lateral izquierda
4. Tu **Location ID** aparece en esa página

**API Key**

LanderLab necesita una clave de API de GHL con estos permisos (scopes) activados:

* `workflows.read`
* `contacts.read`
* `contacts.write`
* `customFields.readonly`
* `customFields.write`

Para generar una clave de API con estos permisos, ve a tu subcuenta de GHL, entra en **Settings**, haz clic en **Private Integrations** y crea una integración privada nueva con los permisos de la lista. Copia el token generado.

<Warning>
  GHL ya no permite generar claves de API nuevas desde los ajustes estándar de Agency o Sub-account en las cuentas que no las hayan usado antes. Usa **Private Integrations** para generar tu token.
</Warning>

***

## Cómo añadir GoHighLevel

### Fase 1: añade tu cuenta de GoHighLevel

<Steps>
  <Step title="Ve a tu landing page">
    Ve a **Landing Pages** y haz clic en el **nombre de la landing page** en la que quieres añadir GoHighLevel.
  </Step>

  <Step title="Abre la pestaña de integraciones">
    Haz clic en **Add Integration** para abrir el panel de integraciones.
  </Step>

  <Step title="Selecciona GoHighLevel">
    En la lista de integraciones disponibles, busca **GoHighLevel** (con la etiqueta "Sync leads with GoHighLevel as they come in") y haz clic en él.
  </Step>

  <Step title="Rellena las credenciales de tu cuenta">
    Introduce estos datos:

    | Campo           | Descripción                                                                                           |
    | :-------------- | :---------------------------------------------------------------------------------------------------- |
    | **Name**        | Una etiqueta para identificar esta conexión de cuenta (por ejemplo, "GHL cuenta principal").          |
    | **Location ID** | El ID único de tu subcuenta de GHL. Lo encontrarás en **Settings > Business Profile** en GoHighLevel. |
    | **API Key**     | Tu token de Private Integration de GoHighLevel con los permisos necesarios activados.                 |
  </Step>

  <Step title="Haz clic en Add GoHighLevel">
    Haz clic en **Add GoHighLevel** para autenticarte y guardar tu cuenta. LanderLab verificará las credenciales y se conectará a tu subcuenta de GHL.
  </Step>
</Steps>

***

### Fase 2: configura la acción, el workflow, las etiquetas y el mapeo de campos

Cuando hayas añadido tu cuenta, el asistente pasa a la configuración de la integración.

#### Paso 1: configura la acción y las etiquetas

<Steps>
  <Step title="Ponle un nombre a la integración">
    Dale a esta integración una etiqueta fácil de reconocer (por ejemplo, "GHL leads de seguros de salud"). Te ayuda a identificarla en la lista de integraciones de tu landing page.
  </Step>

  <Step title="Selecciona una acción">
    Elige qué debe ocurrir en GoHighLevel cuando se envía un lead. Tienes dos opciones:

    | Acción                        | Descripción                                                                                                                                                                                           |
    | :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Save contact**              | Crea el lead como contacto nuevo en tu subcuenta de GHL. No se dispara ningún workflow.                                                                                                               |
    | **Save and trigger workflow** | Crea el contacto y lo inscribe inmediatamente en el workflow de GHL que selecciones. Úsalo para iniciar automatizaciones como secuencias de email, seguimientos por SMS o asignaciones a un pipeline. |
  </Step>

  <Step title="Selecciona un workflow (si procede)">
    Si has elegido **Save and trigger workflow**, aparecerá un desplegable **Workflow**. Selecciona el workflow de GHL que quieres disparar con cada lead nuevo. El workflow tiene que existir ya en tu subcuenta de GoHighLevel.
  </Step>

  <Step title="Añade etiquetas (opcional)">
    En el campo **Tags**, elige etiquetas existentes o escribe para crear otras nuevas. Las etiquetas se aplican a cada contacto creado desde esta landing page y son útiles para segmentar los leads por campaña, oferta o fuente de tráfico.
  </Step>

  <Step title="Haz clic en Continue">
    Haz clic en **Continue** para pasar al mapeo de campos.
  </Step>
</Steps>

#### Paso 2: mapea tus campos

<Steps>
  <Step title="Mapea los campos del formulario con las propiedades de contacto de GoHighLevel">
    A la izquierda verás todos los campos del formulario de tu landing page y, a la derecha, un desplegable para seleccionar la propiedad de contacto de GoHighLevel correspondiente.

    Mapea cada campo del formulario con su propiedad de GHL. Como mínimo, mapea **Email** o **Phone**, porque GHL necesita al menos uno de los dos para crear un contacto.

    | Campo del formulario          | Propiedad de GoHighLevel |
    | :---------------------------- | :----------------------- |
    | Full Name                     | Full Name                |
    | Email                         | Email\*                  |
    | Phone Number                  | Phone                    |
    | (otros campos del formulario) | Select field             |

    Los campos que no mapees no se enviarán a GoHighLevel. Usa las casillas de la izquierda para incluir o excluir campos concretos.

    <Tip>
      LanderLab también incluye campos de sistema como **LL Lander URL**, **LL Visitor IP**, **LL Visitor User Agent**, **LL Submission Time UTC** y **LL Variant ID**. Puedes mapearlos con campos personalizados de GoHighLevel si quieres guardar datos de seguimiento junto con los registros de contacto.
    </Tip>
  </Step>

  <Step title="Haz clic en Continue">
    Haz clic en **Continue** para pasar a la revisión.
  </Step>
</Steps>

#### Paso 3: revisa y conecta

<Steps>
  <Step title="Revisa tu integración">
    El último paso muestra un resumen completo de tu integración con GoHighLevel: el nombre de la integración, la acción seleccionada, el workflow (si procede), las etiquetas aplicadas y todos los campos mapeados. Revísalo todo con atención antes de activarla.

    Si algo no está bien, haz clic en **Back** para volver a los pasos anteriores y hacer cambios.
  </Step>

  <Step title="Haz clic en Connect GoHighLevel">
    Haz clic en **Connect GoHighLevel** para guardar y activar la integración. A partir de ese momento, cada lead enviado en esta landing page se sincronizará con tu subcuenta de GoHighLevel en tiempo real.
  </Step>
</Steps>

***

## Consejos para la integración con GoHighLevel

* **Necesitas el email o el teléfono**: GoHighLevel necesita al menos uno de los dos para crear un contacto. Asegúrate de que tu formulario recoge al menos uno y de que está mapeado.
* **Los contactos existentes se actualizan**: si un lead se envía con un email o teléfono que ya existe en GHL, el registro de contacto existente se actualizará en lugar de crear un duplicado.
* **Usa workflows para las automatizaciones**: si quieres que los leads nuevos reciban automáticamente un SMS de seguimiento, se añadan a un pipeline o empiecen una secuencia de emails, selecciona **Save and trigger workflow** y elige el workflow correspondiente.
* **Asegúrate de que tu workflow está activo**: GHL solo inscribe contactos en workflows publicados y activos. Un workflow en pausa o en borrador no se disparará aunque lo selecciones aquí.
* **Prueba con un envío real**: después de conectarlo, envía un lead de prueba en tu landing page y comprueba que el contacto aparece en tu subcuenta de GoHighLevel, dentro de **Contacts**, en pocos segundos. Si has disparado un workflow, revisa la inscripción del contacto en el workflow para confirmar que ha empezado.