> ## 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 HubSpot
> Saiba como conectar o HubSpot às suas landing pages do LanderLab para enviar leads diretamente para o seu CRM do HubSpot como contatos em tempo real.
## O que é o HubSpot e por que usar esta integração?
O HubSpot é uma plataforma de CRM usada para gerenciar contatos, negócios (deals), empresas e automações de marketing. Quando você conecta o HubSpot a uma landing page do LanderLab, cada lead que envia o seu formulário é criado instantaneamente como um contato no HubSpot, com todos os campos do formulário que você escolher mapeados para as propriedades de contato corretas do HubSpot.
O HubSpot usa **OAuth** para se conectar. Isso significa que, em vez de colar uma chave de API, você faz login diretamente na sua conta do HubSpot e autoriza o LanderLab a acessá-la. Você será redirecionado para o HubSpot para concluir a autorização e depois trazido de volta ao LanderLab para finalizar a configuração.
As integrações com o HubSpot **são salvas globalmente na sua conta**. Depois que você autoriza a sua conta do HubSpot, pode reutilizá-la em várias landing pages sem passar pelo fluxo de OAuth novamente.
***
## Como adicionar o HubSpot
A configuração do HubSpot tem duas fases: autorizar a sua conta do HubSpot via OAuth e, depois, configurar o mapeamento de campos dentro do LanderLab.
### Fase 1: Autorizar a sua conta do HubSpot
Vá até **Landing Pages** e clique no **nome da landing page** à qual você quer adicionar o HubSpot.
Clique em **Add Integration** para abrir o painel de integrações.
Na lista de integrações disponíveis, encontre **HubSpot** e clique nele.
Clique em **Add Account**. Você será redirecionado para a página de autorização do HubSpot.
Na página de autorização do HubSpot, você tem duas opções:
* **Sign in to your HubSpot account** - use esta opção se você já tiver uma conta do HubSpot
* **Create a new HubSpot account** - use esta opção se você ainda não tiver uma
Clique em **Sign in to your HubSpot account** e faça login com as suas credenciais.
Depois do login, o HubSpot mostrará uma tela de permissões listando os acessos que o LanderLab está solicitando, incluindo a capacidade de gerenciar e visualizar os seus dados de CRM, como contatos, empresas e negócios.
Revise as permissões e clique em **Connect** para autorizar o LanderLab.
O LanderLab solicita acesso ao CRM para poder criar e atualizar registros de contato no HubSpot quando um lead é enviado. Você pode revogar esse acesso a qualquer momento na sua conta do HubSpot, em **Settings > Integrations > Connected Apps**.
Depois da autorização, o HubSpot redirecionará você automaticamente de volta ao LanderLab. O assistente de configuração será aberto com a sua conta do HubSpot conectada e pronta para ser configurada.
***
### Fase 2: Configurar o mapeamento de campos
Quando você voltar ao LanderLab após o redirecionamento do OAuth, passará por um assistente de 3 passos para concluir a configuração.
#### Passo 1: Configurar a conexão
Dê a esta integração um nome fácil de reconhecer (ex.: "HubSpot - Leads de seguro de automóvel"). Isso ajuda você a identificá-la na lista de integrações da sua landing page.
Clique em **Continue** para avançar para o passo de mapeamento de campos.
#### Passo 2: Mapear seus campos
Você verá, à esquerda, uma lista com todos os campos do formulário da sua landing page e, à direita, um menu suspenso para selecionar a propriedade de contato correspondente no HubSpot.
Mapeie cada campo do formulário para a propriedade correspondente do HubSpot. No mínimo, mapeie o **Email**, pois ele é exigido pelo HubSpot para criar ou atualizar um contato.
| Campo do formulário | Propriedade do HubSpot |
| :---------------------------- | :--------------------- |
| Full Name | Full Name |
| Email | Email\* |
| Phone Number | Phone Number |
| (outros campos do formulário) | Select field |
Os campos que você não mapear não serão enviados ao HubSpot. Use as caixas de seleção à esquerda para incluir ou excluir campos individualmente.
O LanderLab também inclui campos de sistema, como **LL Lander URL**, **LL Visitor IP**, **LL Visitor User Agent**, **LL Submission Time UTC** e **LL Variant ID**. Você pode mapeá-los para propriedades de contato personalizadas no HubSpot se quiser armazenar dados de rastreamento junto com os registros de contato.
Clique em **Continue** para avançar para o passo de revisão.
#### Passo 3: Revisar e conectar
O último passo mostra um resumo completo da sua integração com o HubSpot, incluindo o nome da integração e todos os campos mapeados. Revise tudo com atenção antes de ativar.
Se algo parecer errado, clique em **Back** para voltar aos passos anteriores e fazer alterações.
Clique em **Connect HubSpot** para salvar e ativar a integração. A partir de então, cada lead enviado nesta landing page será criado como um contato no seu CRM do HubSpot em tempo real.
***
## Dicas para a integração com o HubSpot
* **O e-mail é obrigatório** - O HubSpot usa o e-mail como identificador exclusivo dos contatos. Sempre mapeie o campo de e-mail e certifique-se de que o seu formulário tenha um campo de e-mail.
* **Contatos existentes são atualizados** - Se um lead for enviado com um endereço de e-mail que já existe no HubSpot, o LanderLab atualizará o registro do contato existente em vez de criar um duplicado.
* **Mapeie o telefone com cuidado** - O HubSpot tem uma propriedade específica, Phone Number. Certifique-se de mapear o campo de telefone do seu formulário para a propriedade correta do HubSpot, para evitar que os dados acabem no lugar errado.
* **Teste com um envio real** - Depois de conectar, envie um lead de teste na sua landing page e verifique se o contato aparece no HubSpot, em **Contacts**, em poucos segundos.
* **Nova autorização** - Se algum dia você precisar reconectar a sua conta do HubSpot, basta adicionar uma nova integração com o HubSpot e passar pelo fluxo de OAuth novamente.