> ## 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 a integração com o Attio

> Conecte o Attio ao LanderLab com um access token e envie cada lead das suas landing pages ao Attio como um registro de pessoa, em tempo real.

Conecte o Attio ao LanderLab para enviar automaticamente cada novo lead para o seu workspace do Attio no momento em que alguém enviar um formulário. Sem exportações manuais, sem atrasos.

## O que é o Attio e por que usar esta integração?

O Attio é um CRM baseado em registros e listas flexíveis, usado para gerenciar pessoas, empresas e negócios conforme o seu modelo de dados muda. Quando você conecta o Attio a uma landing page do LanderLab, cada lead que envia o seu formulário é salvo como um registro de **pessoa** (person) no seu workspace do Attio.

O Attio se conecta com um **access token** que você cria nas configurações do seu workspace do Attio. Você o cola no LanderLab uma única vez, depois é só mapear os campos do formulário e colocar no ar.

> [!NOTE]
>
> As integrações com o Attio **são salvas globalmente na sua conta**. Depois que você conecta uma conta do Attio, pode reutilizá-la em várias landing pages sem precisar informar o access token novamente. Você também pode adicionar mais de uma conta do Attio na mesma tela.

## Pré-requisitos

Antes de começar, verifique se você tem:

* Uma conta do LanderLab com pelo menos uma landing page que tenha um campo de e-mail
* Um workspace do Attio no qual você possa criar access tokens
* Um **access token** do Attio com os scopes listados abaixo

## Passo 1: Criar o seu access token do Attio

**1. Abra as configurações do seu workspace do Attio**

No Attio, clique no **nome do seu workspace** no canto superior esquerdo e abra **Workspace settings**.

**2. Acesse Developers**

Na barra lateral esquerda, abra **Developers** e crie uma integração (ou abra uma existente) para gerar um **access token**.

**3. Ative os scopes necessários**

O LanderLab precisa destes scopes no token:

* `record_permission` - leitura e escrita
* `object_configuration` - leitura
* `list_configuration` - leitura
* `list_entry` - leitura e escrita

> [!NOTE]
>
> O LanderLab mostra essa mesma lista na janela em que você cola o token, então dá para conferir enquanto faz a configuração.

**4. Copie o seu access token**

Copie o access token e guarde-o em um lugar seguro para o próximo passo.

## Passo 2: Conectar a sua conta do Attio

**1. Acesse sua landing page**

No LanderLab, acesse **Landing Pages** e abra a landing page à qual você quer adicionar o Attio.

**2. Abra Add Integration**

Clique em **Add Integration** para abrir o painel de integrações.

**3. Encontre o Attio**

Pesquise **Attio** ou abra a categoria **CRM** e clique em **Add account** no card do Attio.

![Adicionando a conta do Attio pelo painel de integrações do LanderLab](https://mintcdn.com/landerlab-babdc23f/m13igmPBUQjx6RS-/images/attio-add-account.webp?fit=max\&auto=format\&n=m13igmPBUQjx6RS-\&q=85\&s=b463fa111f32783387653d9b3e9c094a)

**4. Informe as suas credenciais**

Preencha os seguintes campos:

* **Name** - Um nome para esta conta (ex.: "Attio"). Ele só é usado para identificar a conta dentro do LanderLab.
* **Access Token** - Cole o access token que você criou no Attio.

Clique em **Add Attio** para salvar a conta.

![Janela do Attio com Name, Access Token e os scopes necessários](https://mintcdn.com/landerlab-babdc23f/m13igmPBUQjx6RS-/images/attio-access-token.webp?fit=max\&auto=format\&n=m13igmPBUQjx6RS-\&q=85\&s=b594083dcf299c1275c65e04edb6b547)

## Passo 3: Configurar a integração

Depois que você salva a sua conta, um assistente de configuração é aberto. Ele tem três passos: dar um nome à integração, mapear os campos e, por fim, revisar e conectar.

### Dar um nome à integração

**1. Defina um nome**

Dê a esta integração um nome fácil de reconhecer (ex.: "Attio - Leads de automóveis"). Isso ajuda você a encontrá-la na lista de integrações da sua landing page.

**2. Clique em Continue**

Clique em **Continue** para avançar para o mapeamento de campos.

### Mapear os campos

O LanderLab mostra os campos do seu formulário à esquerda e, à direita, um menu suspenso para escolher o **Attio field** correspondente.

> [!WARNING]
>
> O Attio identifica as pessoas pelo endereço de e-mail. Mapeie o campo de e-mail do seu formulário antes de conectar; caso contrário, o Attio não conseguirá criar nem associar o registro da pessoa.

**1. Mapeie o e-mail**

Mapeie o campo de **e-mail** do seu formulário para o campo **Email** do Attio.

**2. Mapeie o nome**

Mapeie o campo de nome do seu formulário para **Name**, assim o registro da pessoa fica fácil de ler no Attio.

**3. Mapeie os campos extras**

Mapeie quaisquer outros campos que você queira enviar. O LanderLab também inclui campos de rastreamento que você pode repassar:

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

Os campos que você deixar sem mapeamento não serão enviados ao Attio.

**4. Clique em Continue**

Clique em **Continue** para avançar para o passo de revisão.

### Revisar e conectar

**1. Revise o mapeamento**

O último passo mostra tudo o que será enviado ao Attio para cada lead, incluindo cada campo mapeado. Revise com atenção. Se algo parecer errado, clique em **Back** para fazer alterações.

**2. Clique em Connect Attio**

Clique em **Connect Attio** para salvar e ativar a integração. A partir de agora, cada lead enviado nesta landing page será enviado ao Attio em tempo real como um registro de pessoa.

## Dicas para a integração com o Attio

* **Confira os scopes primeiro** - A maioria das conexões que falham é por causa de um scope faltando. Confirme que os quatro scopes estão ativados no token antes de colá-lo no LanderLab.
* **Reutilize a sua conta** - Como o Attio fica salvo globalmente, você só informa o access token uma vez. Conecte a mesma conta a outras landing pages com poucos cliques.
* **Repasse dados de rastreamento** - Mapeie campos como LL Lander URL e LL Variant ID para saber de qual página e de qual variante veio cada lead.
* **Teste com um envio real** - Depois de conectar, envie um lead de teste e confirme se o registro da pessoa aparece no Attio em poucos segundos.

## Solução de problemas

> **O meu access token não é aceito**
>
> Verifique se você copiou o token completo e se ele não foi revogado no Attio. Depois confirme os scopes: `record_permission` (leitura e escrita), `object_configuration` (leitura), `list_configuration` (leitura) e `list_entry` (leitura e escrita).

> **Os leads não estão aparecendo no Attio**
>
> Confirme se a integração está ativa na sua landing page e se o campo de e-mail está mapeado. Verifique também se o seu access token continua válido no Attio, pois revogar ou gerar um novo token invalida o antigo.

> **Vejo um erro de permissão quando os leads são enviados**
>
> Isso geralmente significa que falta um scope. Abra o token em **Workspace settings > Developers** no Attio, ative os quatro scopes listados acima e atualize o token no LanderLab se você gerou um novo.

> **Não consigo encontrar Developers nas configurações do meu workspace do Attio**
>
> A sua função de membro pode não permitir criar access tokens. Peça a um administrador do workspace que crie o token para você ou que libere o acesso necessário.


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