> ## 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.

# Configurar la integración con Attio

> Conecta Attio a LanderLab con un access token y envía cada lead de tus landing pages a Attio como un registro de persona, en tiempo real.

Conecta Attio a LanderLab para enviar automáticamente cada nuevo lead a tu workspace de Attio en el momento en que alguien envía un formulario. Sin exportaciones manuales, sin retrasos.

## ¿Qué es Attio y por qué usar esta integración?

Attio es un CRM basado en registros y listas flexibles, que se usa para gestionar personas, empresas y negocios a medida que cambia tu modelo de datos. Cuando conectas Attio a una landing page de LanderLab, cada lead que envía tu formulario se guarda como un registro de **persona** (person) en tu workspace de Attio.

Attio se conecta con un **access token** que creas en los ajustes de tu workspace de Attio. Lo pegas en LanderLab una sola vez, luego mapeas los campos de tu formulario y lo pones en marcha.

> [!NOTE]
>
> Las integraciones con Attio **se guardan globalmente en tu cuenta**. Una vez que conectas una cuenta de Attio, puedes reutilizarla en varias landing pages sin volver a introducir el access token. También puedes añadir más de una cuenta de Attio en la misma pantalla.

## Requisitos previos

Antes de empezar, asegúrate de tener:

* Una cuenta de LanderLab con al menos una landing page que tenga un campo de email
* Un workspace de Attio en el que puedas crear access tokens
* Un **access token** de Attio con los scopes que se indican más abajo

## Paso 1: Crear tu access token de Attio

**1. Abre los ajustes de tu workspace de Attio**

En Attio, haz clic en el **nombre de tu workspace** en la esquina superior izquierda y abre **Workspace settings**.

**2. Ve a Developers**

En la barra lateral izquierda, abre **Developers** y crea una integración (o abre una existente) para generar un **access token**.

**3. Activa los scopes necesarios**

LanderLab necesita estos scopes en el token:

* `record_permission` - lectura y escritura
* `object_configuration` - lectura
* `list_configuration` - lectura
* `list_entry` - lectura y escritura

> [!NOTE]
>
> LanderLab muestra esta misma lista en el cuadro de diálogo donde pegas el token, así que puedes comprobarla sobre la marcha.

**4. Copia tu access token**

Copia el access token y guárdalo en un lugar seguro para el siguiente paso.

## Paso 2: Conectar tu cuenta de Attio

**1. Accede a tu landing page**

En LanderLab, ve a **Landing Pages** y abre la landing page a la que quieres añadir Attio.

**2. Abre Add Integration**

Haz clic en **Add Integration** para abrir el panel de integraciones.

**3. Encuentra Attio**

Busca **Attio** o abre la categoría **CRM** y haz clic en **Add account** en la tarjeta de Attio.

![Añadir la cuenta de Attio desde el panel de integraciones de LanderLab](https://mintcdn.com/landerlab-babdc23f/m13igmPBUQjx6RS-/images/attio-add-account.webp?fit=max\&auto=format\&n=m13igmPBUQjx6RS-\&q=85\&s=b463fa111f32783387653d9b3e9c094a)

**4. Introduce tus credenciales**

Rellena los siguientes campos:

* **Name** - Un nombre para esta cuenta (p. ej. "Attio"). Solo se usa para identificar la cuenta dentro de LanderLab.
* **Access Token** - Pega el access token que creaste en Attio.

Haz clic en **Add Attio** para guardar la cuenta.

![Cuadro de diálogo de Attio con Name, Access Token y los scopes necesarios](https://mintcdn.com/landerlab-babdc23f/m13igmPBUQjx6RS-/images/attio-access-token.webp?fit=max\&auto=format\&n=m13igmPBUQjx6RS-\&q=85\&s=b594083dcf299c1275c65e04edb6b547)

## Paso 3: Configurar la integración

Después de guardar tu cuenta, se abre un asistente de configuración. Tiene tres pasos: dar un nombre a la integración, mapear los campos y, por último, revisar y conectar.

### Dar un nombre a la integración

**1. Define un nombre**

Dale a esta integración un nombre fácil de reconocer (p. ej. "Attio - Leads de automoción"). Te ayuda a encontrarla en la lista de integraciones de tu landing page.

**2. Haz clic en Continue**

Haz clic en **Continue** para pasar al mapeo de campos.

### Mapear los campos

LanderLab muestra los campos de tu formulario a la izquierda y, a la derecha, un menú desplegable para elegir el **Attio field** correspondiente.

> [!WARNING]
>
> Attio identifica a las personas por su dirección de email. Mapea el campo de email de tu formulario antes de conectar; de lo contrario, Attio no podrá crear ni asociar el registro de persona.

**1. Mapea el email**

Mapea el campo **email** de tu formulario al campo **Email** de Attio.

**2. Mapea el nombre**

Mapea el campo de nombre de tu formulario a **Name** para que el registro de persona sea fácil de leer en Attio.

**3. Mapea los campos adicionales**

Mapea cualquier otro campo que quieras enviar. LanderLab también incluye campos de seguimiento que puedes transmitir:

* LL Lander URL
* LL Visitor IP
* LL Visitor User Agent
* LL Submission Time UTC
* LL Session Time
* LL Variant ID

Los campos que dejes sin mapear no se enviarán a Attio.

**4. Haz clic en Continue**

Haz clic en **Continue** para pasar al paso de revisión.

### Revisar y conectar

**1. Revisa el mapeo**

El último paso muestra todo lo que se enviará a Attio por cada lead, incluido cada campo mapeado. Revísalo con atención. Si algo no cuadra, haz clic en **Back** para hacer cambios.

**2. Haz clic en Connect Attio**

Haz clic en **Connect Attio** para guardar y activar la integración. A partir de ahora, cada lead enviado en esta landing page se enviará a Attio en tiempo real como un registro de persona.

## Consejos para la integración con Attio

* **Comprueba primero los scopes** - La mayoría de las conexiones fallidas se deben a un scope que falta. Confirma que los cuatro scopes están activados en el token antes de pegarlo en LanderLab.
* **Reutiliza tu cuenta** - Como Attio se guarda globalmente, solo introduces el access token una vez. Conecta la misma cuenta a otras landing pages en unos pocos clics.
* **Transmite datos de seguimiento** - Mapea campos como LL Lander URL y LL Variant ID para saber de qué página y de qué variante vino cada lead.
* **Prueba con un envío real** - Después de conectar, envía un lead de prueba y comprueba que el registro de persona aparece en Attio en unos segundos.

## Solución de problemas

> **No se acepta mi access token**
>
> Comprueba que copiaste el token completo y que no ha sido revocado en Attio. Después confirma los scopes: `record_permission` (lectura y escritura), `object_configuration` (lectura), `list_configuration` (lectura) y `list_entry` (lectura y escritura).

> **Los leads no aparecen en Attio**
>
> Confirma que la integración está activa en tu landing page y que el campo de email está mapeado. Comprueba también que tu access token sigue siendo válido en Attio, ya que revocarlo o regenerarlo hace que el antiguo deje de funcionar.

> **Veo un error de permisos al enviar leads**
>
> Normalmente significa que falta un scope. Abre el token en **Workspace settings > Developers** en Attio, activa los cuatro scopes indicados arriba y actualiza el token en LanderLab si has generado uno nuevo.

> **No encuentro Developers en los ajustes de mi workspace de Attio**
>
> Puede que tu rol de miembro no permita crear access tokens. Pide a un administrador del workspace que cree el token por ti o que te dé el acceso necesario.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.