Central de Ajuda V-Pro CRM   /   Marketing e Vendas   /   Leads

Configurar Formulário Web to Lead

Atualizado em 27 December 2025 07:29 pm

O recurso Web to Lead permite criar formulários online baseados nos campos de Leads e campos personalizados do V-Pro CRM, possibilitando a captura de Leads diretamente a partir do seu site, landing pages ou campanhas digitais.

Os formulários são incorporados via iframe e, após o envio, os dados são automaticamente registrados no CRM.


Criar um novo formulário Web to Lead

  1. Acesse Configurações → Leads → Web to Lead

  2. Clique em Novo Formulário

  3. Preencha as configurações iniciais do formulário

  4. Salve para liberar as próximas etapas de configuração

O construtor do formulário só ficará disponível após o salvamento inicial.


Configurações do formulário

  • Nome do formulário
    Nome interno para identificação. Também aparece no perfil do Lead.

  • Idioma
    Utilizado apenas para mensagens de validação do formulário.

  • Texto do botão de envio
    Texto exibido no botão (ex.: Solicitar orçamento, Entrar em contato).

  • Mensagem após envio com sucesso
    Texto exibido após o envio correto do formulário.

  • Permitir Leads duplicados
    Caso desativado, o sistema pode criar uma tarefa em vez de inserir um Lead duplicado, permitindo análise manual pelo responsável.

  • Fonte
    Fonte padrão do Lead criado pelo formulário.

  • Status
    Status atribuído automaticamente ao Lead após o envio.

  • Responsável
    Define automaticamente o colaborador responsável pelo Lead.

  • Notificações
    Envia notificações internas e e-mails conforme as opções selecionadas.

  • reCAPTCHA
    Ativa o Google reCAPTCHA para prevenção de spam (necessita chaves configuradas).


Abas disponíveis após a criação

Após salvar o formulário, duas novas abas ficam disponíveis:

Form Builder

Área onde o formulário é montado visualmente.

  • Arraste campos do perfil de Lead para a área do formulário

  • Campos personalizados também podem ser utilizados

  • Campos do tipo Hyperlink não são suportados

  • Cada campo só pode ser adicionado uma vez

Código de Integração

Código em iframe para incorporar o formulário ao site.

  • Cada formulário possui uma chave única

  • É possível ajustar largura e altura diretamente no código


Personalização dos campos

Cada campo pode ser personalizado com:

  • Rótulo

  • Texto de ajuda

  • Placeholder

  • Definição como obrigatório

Passe o mouse sobre o campo no construtor para editar ou remover.


Estilização do formulário (CSS)

Para personalizar o visual, crie ou edite o arquivo:

assets/css/custom.css

Exemplo: alterar borda dos campos

body.web-to-lead input {
  border-color: red;
}

Exemplo: alterar botão de envio

body.web-to-lead #form_submit {
  background: red;
}

body.web-to-lead #form_submit:hover,
body.web-to-lead #form_submit:active {
  background: green;
}

Redirecionar usuário após o envio

Para redirecionar o usuário para uma URL personalizada após o envio:

  1. Acesse via FTP ou cPanel:

    application/helpers/
    
  2. Crie (ou edite) o arquivo:

    my_functions_helper.php
    
  3. Adicione o código abaixo:

<?php
hooks()->add_action('web_to_lead_form_submitted','my_web_to_lead_form_submitted_redirect_to_custom_url');

function my_web_to_lead_form_submitted_redirect_to_custom_url($data){
    echo json_encode(array(
        'success' => true,
        'redirect_url' => 'http://seusite.com/pagina-de-obrigado'
    ));
    die;
}

Exibir logotipo no formulário

Adicione o parâmetro abaixo à URL do formulário:

?with_logo=1

Exemplo:

https://seudominio.com/forms/wtl/CHAVE_DO_FORMULARIO?with_logo=1

Compartilhar formulário por link direto

É possível compartilhar o formulário sem iframe (email, WhatsApp, SMS).

Use os parâmetros:

?with_logo=1&styled=1

Isso aplica um layout otimizado para visualização direta.


Criar formulários com múltiplas colunas

É possível criar layouts com até 12 colunas por linha, usando classes CSS nos campos.

Exemplo: duas colunas

  • Adicione a classe:

form-col-6

em dois campos consecutivos (6 + 6 = 12).

Exemplo: três colunas

form-col-4

em três campos consecutivos (4 + 4 + 4 = 12).

As colunas não aparecem no construtor, apenas na visualização final.

Para telas menores, utilize classes adicionais como:

form-col-xs-6

Boas práticas importantes

  • Nunca deixe o formulário sem campos obrigatórios

  • O campo Nome deve permanecer obrigatório

  • Utilize sempre HTTP com HTTP ou HTTPS com HTTPS ao incorporar o iframe

  • Evite misturar protocolos para prevenir bloqueios do navegador


O uso correto do Web to Lead garante captura eficiente de Leads, integração direta com o CRM e maior controle sobre o funil comercial no V-Pro CRM.