Formulários: criar e configurar
Um formulário recebe os dados de quem visita o seu site ou abre o seu link e grava tudo em Contatos: cria o contato quando ele não existe e atualiza quando já existe. Aqui você vê como criar o formulário, montar os campos e definir o que acontece com cada resposta.
# Onde fica
Módulo Marketing → Formulários.
A tela mostra um cartão por formulário, do alterado mais recentemente para o mais antigo. Em cada cartão:
- o nome e o endereço público, no formato
/f/identificador-da-empresa/slug; - a etiqueta Publicado ou Rascunho;
- a quantidade de campos e de submissões (respostas recebidas);
- o botão Editar e, quando o formulário está publicado, o ícone de copiar o link.
Passe o mouse sobre o cartão para ver o menu de três pontos: Editar, Duplicar e Excluir. Em formulário publicado o menu traz também Copiar link, Código embed, Copiar endpoint e Visualizar.
# Quem pode usar
Quem tem a página Formulários liberada em Permissões. O perfil Admin acessa sempre. Sem a permissão, o item não aparece no menu.
# Criar um formulário
- Clique em Novo Formulário.
- Digite o Nome do formulário.
- Clique em Criar.
O editor abre com o formulário em Rascunho e quatro campos prontos: Nome e Email (obrigatórios), Telefone e Empresa. O endereço (slug) é montado a partir do nome; se já existe um igual na sua empresa, ganha um número no fim, como contato-2.
O editor tem três abas à esquerda (Campos, Estilo e Config) e, à direita, o formulário como o visitante vai ver. O nome fica no topo e pode ser trocado a qualquer momento.
# Montar os campos
Na aba Campos, cada campo é um cartão.
- Clique em Adicionar campo.
- No seletor do topo do cartão, escolha para onde a resposta vai no contato:
- em Campos do contato: Nome, Email, Telefone ou Empresa;
- em Campos personalizados: qualquer campo personalizado ativo de contato;
- Criar novo campo, para criar um campo personalizado sem sair do editor.
- Ajuste Label (o texto acima do campo) e Placeholder (o exemplo dentro dele).
- Marque as opções do campo, descritas mais abaixo.
O tipo do campo vem do destino escolhido. Não é uma escolha à parte:
| Destino | Tipo do campo |
|---|---|
| Nome, Empresa | Texto |
| Telefone | Telefone, com seletor de país |
| Campo personalizado de texto | Texto |
| Campo personalizado de número | Número |
| Campo personalizado de data | Data |
| Campo personalizado de seleção | Seleção |
Em campo do tipo Seleção, edite as alternativas em Opções (uma por linha).
Para mudar a ordem, arraste o cartão pelo ícone de seis pontos. Para remover, clique na lixeira do cartão.
# Opções de cada campo
| Opção | O que faz |
|---|---|
| Obrigatório | O visitante só consegue enviar se preencher o campo. |
| Sobrescrever se existir | Vem marcada. Quando o contato já existe, a resposta substitui o valor atual. Desmarcada, a resposta só entra se o campo do contato estiver vazio. |
| Oculto | O campo não aparece no formulário publicado nem no código de incorporação. Só recebe valor por envio direto ao endpoint (ex.: utm_source). Campo oculto não pode ser obrigatório. |
# Criar um campo personalizado pelo editor
- No seletor do campo, clique em Criar novo campo.
- Preencha Nome do campo e escolha o Tipo: Texto, Número, Data ou Seleção.
- Em Número, escolha o Formato do número (Simples, USD, BRL ou %), se quiser. Em Seleção, liste as Opções (uma por linha).
- Clique em Criar.
O campo passa a existir para todos os contatos (ele também aparece em Configurações → Campos personalizados) e já fica ligado ao campo do formulário.
# Definir o que acontece com a resposta
Na aba Config:
| Campo | O que é |
|---|---|
| Slug (URL) | O fim do endereço público. Aceita letras minúsculas, números e hífen. Sem slug não dá para publicar. |
| Lista destino | Lista em que o contato entra ao responder. Com Nenhuma, ele não entra em lista. |
| Criar deal automaticamente | Cada resposta cria um negócio no Pipeline, além de criar ou atualizar o contato. Escolha o Pipeline e a Coluna. Se o contato já tem um negócio nesse pipeline, nenhum novo é criado. |
| Texto do botão | O texto do botão de envio. O padrão é Enviar. |
| Mensagem de sucesso | O que o visitante lê depois de enviar. |
| URL de redirecionamento | Só vale para envios pelo endpoint. Veja Formulários: receber dados do seu próprio site. |
| Tags automáticas | Tags aplicadas a todo contato que responder. |
O Logo do formulário e a Imagem de fundo, também nesta aba, estão em Formulários: aparência e layout.
# Testar e salvar
O formulário da direita é interativo: preencha e clique no botão para ver as validações e a mensagem de sucesso. Testar novamente limpa o teste. Nada disso é gravado em Contatos.
Clique em Salvar para gravar. Salvar nunca publica um rascunho: para colocar o formulário no ar, use Publicar. O passo a passo está em Formulários: publicar, incorporar e receber respostas.
Se você sair com mudanças pendentes, o diálogo Alterações não salvas oferece Continuar editando, Sair sem salvar e Salvar e sair.
# Duplicar e excluir
- Duplicar cria uma cópia em Rascunho, com
(cópia)no nome e um slug novo. Vêm junto os campos, o estilo, a lista, o texto do botão, a mensagem de sucesso, a URL de redirecionamento e a configuração de deal. As Tags automáticas e a Imagem de fundo não são copiadas. - Excluir pede confirmação e apaga o formulário e os envios recebidos por ele. Não dá para desfazer. Os contatos continuam em Contatos. Se algum QR Code aponta para o formulário, o diálogo avisa qual e o botão vira Excluir mesmo assim: depois da exclusão, quem escanear vê uma página de erro. Para evitar isso, mude o destino na tela de QR Codes antes de excluir.
# Regras e limites
- Todo formulário precisa de um campo com destino Email. Resposta sem e-mail válido é recusada com “Email inválido”, porque é pelo e-mail que o sistema reconhece o contato.
- Todo campo precisa de destino. Com um campo sem destino, o editor não salva.
- O slug é único dentro da sua empresa. Se você trocar o slug de um formulário publicado, o link antigo deixa de funcionar.
- O seletor de Lista destino mostra até 100 listas.
- Com Coluna sem escolha, o negócio entra na primeira coluna do pipeline.
- Clique em Salvar sempre que mexer na aba Config. Mudança só em Slug (URL), Lista destino, Texto do botão ou Mensagem de sucesso não aciona o aviso Alterações não salvas ao sair.
# Problemas comuns
| O que aparece | O que fazer |
|---|---|
| Escolha o destino de cada campo, ao salvar | Algum cartão está com a borda vermelha e o aviso “Escolha para onde este campo vai no contato”. Escolha o destino ou remova o campo. |
| Já existe um formulário com esse endereço (slug). Escolha outro. | Troque o Slug (URL) na aba Config. |
| Use uma URL completa começando com http:// ou https:// | Corrija a URL de redirecionamento ou deixe o campo vazio. |
| Este pipeline ainda não tem colunas. | Crie as colunas no Pipeline ou escolha outro pipeline. |
| Não foi possível verificar se há QR Codes usando este formulário, ao excluir | A checagem falhou. Confira a tela de QR Codes antes de confirmar a exclusão. |