> For the complete documentation index, see [llms.txt](https://docs.sprinthub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinthub.com/topicos/configuracoes-do-sistema/formularios-externos/formularios-do-meta.md).

# Formulários do Meta

É possível integrar os formulários de cadastro do **Facebook e Instagram** com a SprintHub. Dessa forma, os leads preenchidos nos formulários serão enviados automaticamente para a plataforma, permitindo que sua equipe acompanhe e trabalhe esses contatos sem a necessidade de cadastro manual.

{% embed url="<https://youtu.be/LxZFMBE7MoM?si=M9EGaJBFKcgcpyV6>" %}

***

### Antes de começar

Antes de realizar a integração do formulário, é necessário que as **contas da Meta estejam integradas à SprintHub**.

> **Importante:** certifique-se de que a integração com as contas Meta já esteja configurada antes de iniciar este procedimento.

Para mais informações, consulte o artigo sobre **Contas da Meta**.

{% content-ref url="/pages/FFOWRpkyoEPCjBNftTs0" %}
[Contas da Meta](/topicos/configuracoes-do-sistema/configuracoes-de-contas/contas-da-meta.md)
{% endcontent-ref %}

***

### Acessando os formulários

Para começar, acesse:

**Configurações do Sistema → Formulários Externos**

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FySGiKbrxqZQUqDqmFA3n%2Fimage.png?alt=media&amp;token=77e53f07-4313-4dbf-8cd8-b83ef42d2dcf" alt=""><figcaption></figcaption></figure>

Em seguida, localize os formulários disponíveis e selecione o formulário que deseja integrar.

Clique no ícone de **seta →** para acessar as configurações do formulário.

***

## Configurando o formulário

Ao acessar as configurações, você poderá definir como os dados enviados pelo formulário serão cadastrados e tratados na SprintHub.

As configurações são divididas em algumas etapas importantes:

* Mapeamento dos campos;
* Rastreamento por UTMs;
* URL de destino;
* Tags e segmentos;
* Ações realizadas após a entrada do lead;
* Tratamento de leads que já existem na plataforma.

***

### 1. Mapeamento dos campos

O primeiro passo é realizar o **mapeamento dos campos do lead**.

Essa configuração determina quais informações preenchidas pelo usuário no formulário serão cadastradas nos campos correspondentes da SprintHub.

Por exemplo, o nome preenchido no formulário será associado ao campo **Nome** do lead na SprintHub.

> **Importante:** é necessário ter, no mínimo, o campo **Nome** configurado para que o lead possa ser cadastrado e localizado na SprintHub.

Certifique-se de que os campos estejam corretamente configurados. Caso contrário, informações importantes poderão não ser cadastradas e sua equipe poderá perder a oportunidade de entrar em contato com o lead.

***

## 2. Rastreamento por UTMs

Outra configuração importante é o **rastreamento por UTMs**.

Caso o formulário redirecione o lead para um site que possua rastreamento da SprintHub, é possível configurar a **URL de destino** e as **UTMs** utilizadas no formulário.

Dessa forma, a SprintHub consegue relacionar a visita realizada pelo usuário ao lead posteriormente cadastrado.

Essa configuração é importante para o acompanhamento de resultados e para a criação de **relatórios e dashboards personalizados**.

Com os dados de UTM, é possível analisar informações como:

* UTM Campaign;
* UTM Source;
* UTM Term;
* UTM Medium.

Assim, você consegue identificar quais campanhas, fontes e meios estão gerando mais leads.

#### Adicionando mais rastreamentos

É possível adicionar **mais de um rastreamento** para o mesmo formulário, permitindo trabalhar com diferentes configurações de origem.

***

## 3. Ações adicionais

Na seção de **Ações adicionais**, é possível definir o que acontecerá com o lead após o preenchimento do formulário.

Entre as opções disponíveis estão:

#### Adicionar tag ao lead

É possível adicionar uma tag ao lead utilizando o **nome da campanha de anúncio** como parâmetro.

Dessa forma, a SprintHub criará uma tag relacionada à campanha responsável pela geração do lead.

#### Adicionar o lead a um segmento

Também é possível definir um **segmento** para receber automaticamente os novos leads cadastrados pelo formulário.

Tags e segmentos podem ser utilizados posteriormente em **relatórios e análises**.

Além disso, os segmentos podem ser utilizados para iniciar **fluxos de automação**.

Por exemplo, após o lead entrar no segmento, é possível iniciar ações como:

* Acionar um chatbot;
* Enviar um e-mail;
* Executar outras ações automatizadas.

Para saber mais sobre automações, consulte o artigo **Aprenda a criar automações**.

## O que fazer quando o lead já existe?

Durante o envio do formulário, pode acontecer de as informações pertencerem a um lead que já está cadastrado na SprintHub.

Nesse caso, você poderá definir qual comportamento a plataforma deverá adotar.

#### Criar um novo Lead

Será criado um novo lead na SprintHub.

Caso seja necessário, a duplicidade poderá ser tratada posteriormente.

#### Atualizar Lead existente

Os dados enviados pelo formulário serão utilizados para **atualizar o lead já existente**, substituindo as informações correspondentes.

#### Não atualizar o Lead

O lead existente não será atualizado.

Será registrado no **histórico do lead** que um novo envio de formulário foi realizado.

Após concluir todas as configurações, clique em **Salvar mudanças**.

***

## 4. Condições

As **Condições** permitem definir critérios que o contato precisa atender para que as Ações Extras sejam executadas.

Caso as condições configuradas sejam atendidas, as ações definidas serão executadas para o contato.

Se **nenhuma condição for adicionada**, as Ações Extras serão executadas normalmente para todos os contatos que enviarem o formulário.

Para adicionar um critério, clique em **Nova Condição**.

***

## 5. Ações Extras

As **Ações Extras** são executadas após o processamento do formulário.

Os campos preenchidos pelo contato no formulário ficam disponíveis como **tokens**, permitindo utilizar essas informações nas ações configuradas.

Para adicionar uma ação, clique em **Nova Ação**.

Cada ação será apresentada com sua respectiva **descrição**, facilitando a identificação do que será realizado após o processamento do formulário.

> **Importante:** as Ações Extras são processadas após o envio do formulário e podem utilizar os dados preenchidos pelo contato por meio de tokens.

***

## Testando a integração

Depois de configurar o formulário, é possível realizar um teste para verificar se o lead está sendo enviado corretamente para a SprintHub.

### Exemplo: formulário do Instagram

No exemplo utilizado, foi criado um formulário diretamente pelo aplicativo do **Instagram**.

Nesse caso, foi adicionado o botão **"Saiba mais"** ao perfil. Ao clicar no botão, o usuário é direcionado para o formulário.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FvvGSllxfNscSfBoUFT3v%2Fimage.png?alt=media&amp;token=e57ca359-f516-4c62-8bcb-78bb0f2ddcb7" alt=""><figcaption></figcaption></figure>

> **Importante:** para utilizar essa configuração, utilize o aplicativo do Instagram.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FkigvxT1B3Zq6M57qKDdk%2Fimage.png?alt=media&amp;token=bbb44808-3624-42e1-b6b1-d24477dc6eb8" alt=""><figcaption></figcaption></figure>

Após o preenchimento do formulário, podemos verificar se o cadastro foi recebido corretamente pela SprintHub.

#### Verificando o segmento

Primeiro, acesse o segmento configurado para receber os leads do formulário, neste exemplo:

**Formulário Instagram**

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FPcCQsZQ1GqW3JfxsBFMf%2Fimage.png?alt=media&amp;token=b4020ef5-d5ac-4bc2-b91a-2f2281d8f203" alt=""><figcaption></figcaption></figure>

É possível verificar que o novo lead foi cadastrado.

Ao acessar o segmento, também é possível verificar a **data de criação do lead**.

Ao acessar o lead, consulte o **histórico**.

No histórico será possível verificar que:

* O lead veio do preenchimento do formulário do Instagram;
* Foi adicionado ao segmento configurado;
* Foi criado automaticamente no CRM.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2F6zf24JiQbfEhsyZ9eOwK%2Fimage.png?alt=media&amp;token=dff08054-1b21-42a6-94c4-fac486ef1d4d" alt=""><figcaption></figcaption></figure>

#### Verificando no CRM

Também é possível acessar o **CRM** para verificar a oportunidade criada automaticamente.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FHzN7ERDnLMlh4YBxLvhd%2Fimage.png?alt=media&amp;token=8eae0dd3-2cdf-4810-88cb-98dde6066231" alt=""><figcaption></figcaption></figure>

***

## Testando um formulário do Facebook

Para realizar um teste com um formulário do Facebook, utilize a ferramenta disponibilizada pela Meta:

[Facebook Lead Ads Testing Tool](https://developers.facebook.com/tools/lead-ads-testing?utm_source=chatgpt.com)

Ao acessar a ferramenta, selecione:

1. A **Página**;
2. O **formulário** que deseja testar.

Depois, clique em **Criar Cadastro**.

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FBx2v5hMw4yIdd9otDKnj%2Fimage.png?alt=media&amp;token=0181d030-996e-4538-b061-329a068c78fe" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FCLriK6dljZrTL9ZiZ2FD%2Fimage.png?alt=media&amp;token=d2d53f2e-fbdf-4bbb-b076-4525c3387cf9" alt=""><figcaption></figcaption></figure>

O Facebook enviará um cadastro de teste para a SprintHub.

Para realizar um novo teste, basta excluir o cadastro criado anteriormente e repetir o procedimento.

***

## Conclusão

A integração dos formulários do Facebook e Instagram com a SprintHub permite automatizar a entrada de novos leads na plataforma.

Além do cadastro automático, é possível utilizar **UTMs, tags, segmentos e automações** para organizar os contatos, identificar a origem dos leads e iniciar ações automaticamente após o preenchimento do formulário.