# Formulário de coleta de dados

Este bloco permite adicionar um formulário para coletar dados, por exemplo, número de telefone, nome, respostas a perguntas etc., e configurar botões para ir para mensageiros no chatbot.

Você pode configurar facilmente a aparência dos botões dos mensageiros usando as configurações padrão dos botões neste bloco.

<figure><img src="/files/6413633a8f44095d53384c9ca01014253b9aa66d" alt=""><figcaption></figcaption></figure>

### Como criar um Formulário para coletar solicitações

Ao adicionar um formulário, três tipos de campos de coleta de dados são criados de uma vez devido às configurações predefinidas no formulário:

1\) Nome;

2\) E-mail;

3\) Número de celular.

<figure><img src="/files/0065484a399cc4ee31f71c26177b69c9d8629864" alt=""><figcaption></figcaption></figure>

Se precisar adicionar outras perguntas ao formulário, clique no botão "Adicionar mais pergunta":

<figure><img src="/files/81b9d1c97cf3b745885f6a1f3f3f893e9d6d0aba" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
O **Pergunta** e **Variável** os campos são obrigatórios e são marcados com \*.
{% endhint %}

Para acessar as configurações da pergunta, clique na seta na barra da pergunta:

<figure><img src="/files/a6acaa10afc69bba0a33afd5baad3b3d07d76cc8" alt=""><figcaption></figcaption></figure>

Depois você verá as configurações expandidas da pergunta:

<figure><img src="/files/fd40533463f7f94b8a54f229ed676c4a30eb1baa" alt=""><figcaption></figcaption></figure>

**Pergunta obrigatória** **alternar**&#x20;

A pergunta pode ser tornada obrigatória. Nesse caso, não haverá transição para os mensageiros até que o usuário insira o valor. Para isso, ative a caixa de seleção Pergunta obrigatória:

<figure><img src="/files/220245a4d7b8206c22f571e1ee5d293a0bc27692" alt=""><figcaption></figcaption></figure>

Você pode **excluir uma pergunta** clicando no ícone de lixeira ao lado do botão de opção Pergunta obrigatória:

<figure><img src="/files/d7a25f37c0c6fed95717aeac3caa32dedeeb9d13" alt=""><figcaption></figcaption></figure>

&#x20;**Botão Adicionar mais pergunta**

Se precisar fazer várias perguntas em um formulário, você pode adicionar perguntas clicando no botão Adicionar mais pergunta.

Ao clicar no botão Fazer perguntas, o formulário padrão é aberto com o tipo de campo Lista suspensa. Depois, você pode alterá-lo para qualquer um dos disponíveis.

**Tipo de campo.** Você pode escolher uma das opções de pergunta disponíveis:

* **Lista suspensa** - a lista de respostas será exibida como um campo com uma lista
* **Escolha múltipla** - a resposta pode conter várias opções - escolha múltipla da lista de possíveis respostas
* **Selecionar uma opção** - apenas uma resposta pode ser selecionada da lista de possíveis respostas.
* Um **campo de texto** - é um campo no qual o cliente deve inserir o valor por conta própria.

Os seguintes tipos de campos podem ser usados no formulário apenas uma vez para o minilanding real:

* **Name**&#x20;
* **E-mail**
* **Telefone celular**

Se a pergunta estiver marcada como **obrigatória** pergunta, o cliente não poderá fechar o formulário sem responder a esta pergunta.

&#x20;**tipo de campo Lista suspensa**

Nesta pergunta, as possíveis respostas ficam ocultas no menu suspenso. Clicar no campo abre um menu com opções de resposta. Você pode adicionar uma nova resposta clicando no botão Adicionar resposta.

Este recurso também oferece a possibilidade de adicionar "Sua resposta" à pergunta "Escolhendo uma das opções" - isso permitirá que você receba dos clientes não apenas respostas no formato predefinido, mas também conheça novas opções que os usuários possam inventar.

No campo Variável, especifique o nome da variável, levando em conta as recomendações para sua criação. A resposta será salva em uma variável e enviada ao bot.

<figure><img src="/files/e5b4b51610068fcf9d2c8bf2ea599da56be5ec2a" alt=""><figcaption></figcaption></figure>

#### tipo de campo Campo de texto

Você pode selecionar este tipo se o usuário precisar fornecer uma resposta livre.&#x20;

No campo Variável, especifique o nome da variável, levando em conta as recomendações para sua criação. A resposta será salva em uma variável e enviada ao bot.

<figure><img src="/files/eb65bfc31deb9fbd3f6f36a9115debf2120f0f53" alt=""><figcaption></figcaption></figure>

#### tipo de campo Seleção de várias opções

Nesta pergunta, o usuário pode escolher uma ou várias respostas possíveis. A página de mini landing exibe todas as respostas de uma vez. Ao lado delas há caixas de seleção quadradas para escolha.\
\
Você pode adicionar uma nova resposta clicando no botão + Adicionar resposta.

No campo Variável, especifique o nome da variável, levando em conta as recomendações para sua criação. A resposta será salva em uma variável e enviada ao bot.

<figure><img src="/files/67bad16103387fcb3631373d44529916286526df" alt=""><figcaption></figcaption></figure>

#### tipo de campo Seleção de uma opção

Nesta pergunta, o usuário pode escolher apenas uma das respostas disponíveis. A página de mini landing exibe todas as respostas de uma vez. Há caixas de seleção redondas ao lado delas, mas você só pode escolher uma resposta.\
\
Você pode adicionar uma nova resposta clicando no botão + Adicionar resposta.

No campo Variável, especifique o nome da variável, levando em conta as recomendações para sua criação. A resposta será salva em uma variável e enviada ao bot.

<figure><img src="/files/ad3361ae5f99538bc2f74a96d9bba5fa9f19bac5" alt=""><figcaption></figcaption></figure>

#### tipo de campo: Nome

O nome do usuário é inserido neste campo. Durante a transição para o bot, o nome do site será gravado na variável do cliente **`name_from_ml`**

<figure><img src="/files/45420bd09e8434936844c17ab615cf70ee33f234" alt=""><figcaption></figcaption></figure>

**Inscrição**. Se você não preencher este campo, o nome padrão será indicado acima do campo de entrada do número. Você pode inserir suas descrições para que o usuário informe seus dados.

Como o nome do cliente é exibido no site?:

<figure><img src="/files/c4b1a7f785b6bb869d3cf9ae4ccc4675e7090696" alt=""><figcaption></figcaption></figure>

#### tipo de campo: E-mail

O endereço de e-mail do usuário é registrado neste campo. Ao mudar para o bot, o nome do site será gravado na variável do cliente **`email`**

<figure><img src="/files/3b7c99112ba9c5305ba77e1641ae155109dac507" alt=""><figcaption></figcaption></figure>

**Inscrição.** Se você não preencher este campo, o endereço de e-mail padrão será indicado acima do campo de entrada do número. Você pode inserir suas descrições para que o usuário informe seus dados.

Como os dados recebidos são exibidos no bot durante a navegação a partir de uma mini landing page:

![](/files/c4b1a7f785b6bb869d3cf9ae4ccc4675e7090696)

#### tipo de campo: Telefone celular

O número de telefone do usuário é registrado neste campo. Durante a transição para o bot, o número de telefone do usuário do site será gravado na variável do cliente **`phone`**

![](/files/965af359092522fb406cb35d712a0b22f48fda39)

Há configurações adicionais na mini landing page.

**Telefones personalizados.** Você pode especificar quais códigos de país serão exibidos para seleção ao inserir um número de telefone.

<figure><img src="/files/e296a6de12f0db41754fe2d309549696ae4c034e" alt=""><figcaption><p>Códigos de país personalizados (configuráveis). </p></figcaption></figure>

**O código de país padrão** é +7 Rússia. Neste campo, você pode alterar esse código para outro país, se necessário.

**A alternância de Detecção do código do país pelo endereço IP** .

<figure><img src="/files/d7d8f44a953f0037556e70e968a40138ac0530eb" alt=""><figcaption><p>Detecção do código do país pelo endereço IP</p></figcaption></figure>

Ao ativar a opção "Detecção do código do país pelo endereço IP", o código do país é determinado automaticamente pelo número de telefone a partir do banco de dados de IP (campo 1 na captura de tela, "Telefones personalizados"). Se o código do país não for encontrado, então é inserido o código especificado no campo "Código do país padrão" (campo 2 na captura de tela acima).

Assim, se você especificar, por exemplo, o Cazaquistão no campo "Telefones personalizados" e ativar a detecção automática do código do país por endereço IP, então o código será primeiro procurado pelo número de telefone no banco de dados de Telefones Personalizados (endereços IP). Se o número for encontrado, o código do país será obtido do número de telefone; caso contrário, do campo "Código do país padrão", ou seja, o código do país padrão.

{% hint style="info" %}
Devido a restrições de tempo no nível do país, essa configuração pode não funcionar corretamente.
{% endhint %}

**Inscrição.** Se você não preencher este campo, o número de telefone padrão será indicado acima do campo de entrada do número. Você pode inserir suas descrições para que o usuário informe o número de telefone.

&#x20;

<figure><img src="/files/146d33d6a4c35dea77bbf8095cc64ae319679f4e" alt=""><figcaption><p>Exemplo de configuração do rótulo acima do número de telefone</p></figcaption></figure>

### Como criar um formulário em um botão

{% hint style="warning" %}
Este recurso não funciona para a página de inscrição do VKontakte. O formulário será adicionado automaticamente à página.
{% endhint %}

Neste caso, vamos usar a seção pop-up.

{% hint style="info" %}
saiba mais sobre a seção pop-up no artigo de mesmo nome. link [explicamos no artigo de mesmo nome.](broken://pages/e261cb751068ca20efd9d25971f31f4e4cdb2b4c)&#x20;
{% endhint %}

Mude para o modo de edição da página do site e encontre o botão "+" para adicionar a seção "Pop-up":

<figure><img src="/files/4e3e76e9ac8b6fd37d68f4da2226c3a108bcc98e" alt=""><figcaption></figcaption></figure>

Depois, a seção será adicionada à página do site:

<figure><img src="/files/dbbf7cd99c1c76e91430b7f5ab58d10d1e3015ff" alt=""><figcaption></figcaption></figure>

Agora você precisa preencher o pop-up clicando no botão correspondente na seção:

<figure><img src="/files/2bd351759218db172bd363b62703c4cdbea2b7e2" alt=""><figcaption></figcaption></figure>

Em seguida, selecione a seção que deseja adicionar ao pop-up — esta é a seção "Formulário":

<figure><img src="/files/ef870e6546e6093879aa51a9f2889457244a1f66" alt=""><figcaption></figcaption></figure>

Ao clicar, o formulário será adicionado ao pop-up, e uma janela será aberta à direita para preencher o conteúdo do formulário:

Agora preencha o conteúdo do formulário conforme descrito nas seções acima.

<figure><img src="/files/8ab6479be84db9a74475280c0d3348c87f0cf7d6" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Você pode adicionar qualquer número de seções ao pop-up, criando assim um mini site que abre quando você clica no botão.
{% endhint %}

Agora vamos especificar o ID do pop-up como um link no botão (o botão pode ser qualquer um):

<figure><img src="/files/1bb9e17da4f7ed054b280c50df6717d314314c8d" alt=""><figcaption></figcaption></figure>

Em seguida, vá para a seção do menu (o cabeçalho da página do site) e especifique o valor do pop-up no botão com a função de link:

1. Clique em "Editar" na seção necessária (pode ser tanto a seção "Menu" quanto a seção "Botões"):

<figure><img src="/files/c2f1cc5d550864652ba782ff6e08b675a79a74cd" alt=""><figcaption></figcaption></figure>

Depois, a barra da direita será aberta com a edição do conteúdo:

<figure><img src="/files/518b82aad3b1df8a0301f568eeb3357460b7abf7" alt=""><figcaption></figcaption></figure>

2. Em seguida, crie um botão com a função "Link":

<figure><img src="/files/b0400e3a78a7d148dd2b23818fb3a924169e88f4" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Atenção!

A ação é "Na janela atual", caso contrário o botão pop-up não será aberto.
{% endhint %}

Pronto! Agora você pode abrir o formulário pelo botão do menu ou por outro botão na página do site:

<figure><img src="/files/68492741add5be2ea3c4c1a130990c6480818171" alt=""><figcaption></figcaption></figure>

### Como adicionar um negócio ao MavibotCRM a partir do site

{% hint style="warning" %}
Isso só funciona se o canal do Whatsapp ou o e-mail estiver conectado ao projeto: verifique se o cliente está no banco de dados e adicione a ele um novo negócio ou um novo cliente, e um negócio será criado para ele.

Se ambos os canais estiverem conectados, um cliente do Whatsapp é criado!
{% endhint %}

<figure><img src="/files/e212df1254a5d8cd5bac605981a90a63e4fbd278" alt=""><figcaption></figcaption></figure>

### Política de privacidade

Adicionar um link para sua política de privacidade é fácil e simples:

ative as caixas de seleção e adicione um link para a página da política ou deixe as configurações padrão.

<figure><img src="/files/90d58bca494d1c67e2cb8549739a3431786b5d6e" alt=""><figcaption></figcaption></figure>

Exibir a política de privacidade

Por padrão, essas configurações estão desativadas. Para ativá-las, marque a opção na **caixa de seleção Política de Privacidade.**\
Você também pode verificar se é necessário marcar a caixa "Eu concordo com a política de privacidade" na landing page. Para isso, marque a caixa nas configurações da landing page em "**Exibir a caixa de seleção já marcada:"**

<figure><img src="/files/92e8701b8a2f2985e2995388522a294e995aea2c" alt=""><figcaption></figcaption></figure>

#### Botões

Nesta seção, você pode configurar a exibição dos botões no site.

#### Estilo do botão (menu suspenso) &#x20;

Exibir botões apenas com ícones dos mensageiros (somente ícone) ou adicionar o nome do mensageiro (Ícone com texto).

<figure><img src="/files/7f012e4cb6d18c2426de81d2d4dd9c96f72001fb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Se você selecionar o tipo de botão Ícone com texto, poderá alterar o texto do botão.&#x20;
{% endhint %}

Você também pode escolher quais botões dos mensageiros conectados ao Mavibot serão exibidos no site. Para isso, marque as caixas de seleção.

{% hint style="warning" %}
Atenção!&#x20;

Se o seu projeto não tiver canais conectados, os botões dos mensageiros no formulário não serão exibidos.
{% endhint %}

#### Os botões deste formulário usarão dados de todos os formulários do site (uma alternância)

Ao criar uma página grande, você pode precisar usar o formulário de coleta de dados com botões de mensageiro várias vezes para alternar para o bot. Para facilitar, essa alternância foi criada para que os dados possam ser transmitidos de qualquer um dos formulários para o bot.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/pt/websites/sites/blocks/forms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.