Formulários

Conecte ao CRM o formulário do seu site, landing page ou sistema, e transforme cada envio em uma oportunidade.

Funciona com qualquer formulário que consiga enviar os dados para um endereço na internet: landing page, site institucional, Typeform ou sistema próprio. Cada formulário cadastrado ganha uma URL exclusiva, e cada envio vira uma oportunidade nova no WhatsApp que você escolher.

Pré-requisitos

Um WhatsApp conectado. Sem ele, o CRM não deixa criar o formulário, porque é esse número que vai atender os leads.

Criar um formulário

Em Integrações, no card Formulários (seção Captação e Rastreamento), clique em Novo formulário.
Dê um nome, por exemplo "Site institucional" ou "LP Black Friday".
Em WhatsApp(s) de destino, selecione um ou mais números. Com mais de um, os leads se alternam entre eles em rodízio.
Clique em Criar formulário.

Conectar o seu formulário

Na aba Como conectar:

Copie a URL do bloco URL única do seu formulário.
Entregue ao responsável pelo site ou sistema, ou cole no campo de "webhook" da sua ferramenta de formulário (Elementor, Webflow, Typeform, Greatpages e outras).
Confira os nomes dos campos. O CRM precisa pelo menos do nome e do telefone do contato.

Se o seu formulário usa nomes diferentes dos padrão, ou se você quer guardar uma resposta num campo do cadastro do cliente, configure isso na aba Campos. Veja Campos do formulário.

A chave de acesso já está dentro da URL. Trate como uma senha: quem tiver a URL pode criar oportunidades na sua conta. Passe direto ao responsável pela integração e não publique em lugares abertos.

Peça ajuda a uma IA

No fim da aba Como conectar, em Precisa de ajuda? Peça à IA, escolha a Plataforma da sua landing page e clique em Copiar prompt. O texto já leva a sua URL e os campos certos.

Se o site foi feito com IA (Lovable, Bolt, v0 e outras), escolha Site feito com IA e cole o prompt no chat da própria ferramenta. Ela faz a integração.
Nas outras plataformas, cole no ChatGPT, Claude, Gemini ou outra IA, e ela explica o passo a passo.

Acompanhar os envios

A aba Visão geral mostra as submissões recebidas e permite trocar os WhatsApps de destino. Cada envio também registra a origem do lead: o formulário aparece em Meus Anúncios, ao lado dos anúncios pagos, com os parâmetros UTM que tiver enviado.

Atribuição dos leads recebidos

A oportunidade segue a distribuição de leads configurada na conexão de WhatsApp que recebeu o lead. Não há regra separada por formulário.

Gerar nova URL ou excluir

Se a URL vazou, clique no ícone Gerar nova URL ao lado dela, na aba Como conectar. Para remover um formulário, use a ação de excluir na lista de formulários. As submissões já recebidas continuam salvas no CRM.

Excluir ou gerar nova URL é definitivo: a URL antiga para de funcionar na hora, e os envios que continuarem indo para ela são rejeitados (os leads se perdem). Atualize ou desligue o formulário antes.

Referência técnica

Seção técnica

Para quem vai programar a integração. Se você só usa o CRM, pode pular esta parte.

O formulário deve enviar um POST para a URL do formulário, em JSON ou como formulário comum (application/x-www-form-urlencoded ou multipart/form-data).

Campo	Descrição	Exemplo	Obrigatório
`name`	Nome do contato	`Maria Beatriz`	Sim
`phone`	Telefone (WhatsApp)	`(81) 99267-3319`	Sim
`email`	E-mail	`[email protected]`	Não
`message`	Mensagem do lead	`Quero saber mais sobre…`	Não

Esses são os nomes padrão. Se o formulário enviar outros nomes, mapeie na aba Campos.

Os parâmetros utm_source, utm_medium, utm_campaign, utm_content, utm_term, gclid e fbclid são reconhecidos sozinhos e alimentam Meus Anúncios.

Campos sem destino na aba Campos são anotados na conversa, até 10 por envio. Veja o que acontece com cada envio.

{
  "name": "Maria Beatriz",
  "phone": "(81) 99267-3319",
  "email": "[email protected]",
  "message": "Quero saber mais sobre o plano Pro.",
  "utm_source": "google",
  "cargo": "Gerente de Marketing",
  "empresa": "Acme S.A."
}

Para testar sem o formulário, rode no terminal:

curl -X POST https://api.crmvirtus.com/webhooks/forms/<código-do-formulário> \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Teste de integração",
    "phone": "(81) 99999-9999",
    "message": "Teste de integração"
  }'

Uma nova oportunidade aparece no atendimento. Finalize como Desqualificar depois, para não poluir suas métricas. Veja Finalizar Oportunidades.

Formulários

Nesta página