Pular para o conteúdo principal
A tela Formulários cria formulários públicos que abrem atendimento. A pessoa preenche, o contato é criado ou completado e o atendimento abre no canal que você escolheu, com as respostas num cartão que só a equipe vê. Crie um formulário por assunto (orçamento, suporte, trabalhe conosco) e divulgue pelo link, pelo QR code ou dentro do seu site.
Quem usa: Administrador; Supervisor (a tela aparece para ele por padrão e some quando o administrador desmarca Formulários em Permissões de Menu, no cadastro do usuário); Perfil Personalizado com o módulo Formulários e a permissão Gerenciar formulários (veja Equipes e Usuários). O Atendente não abre esta tela, mas recebe e responde normalmente os atendimentos que os formulários abrem.
Onde fica: no menu lateral, em Gestão Comercial → Operação → Formulários.

Como funciona

  • O formulário não é um canal novo e não conta como conexão do plano: o atendimento abre num canal de WhatsApp (não oficial ou oficial) ou de e-mail da sua empresa, e a resposta do cliente cai no mesmo atendimento.
  • Cada formulário tem os próprios campos, canal, destino, etiquetas e confirmação ao cliente.
  • Cada envio fica guardado na aba Respostas, com filtros e exportação para planilha.
  • A empresa pode ter até 100 formulários, cada um com até 50 campos. No limite, o botão Novo formulário fica desativado e a tela avisa Limite de 100 formulários por empresa atingido. Exclua um para criar outro.
  • Se os formulários não fizerem parte do plano da sua empresa, o item não aparece no menu ou a tela avisa Os formulários não fazem parte do plano da sua empresa.
  • Não confunda com o Formulário do WhatsApp (Flow), o formulário nativo do WhatsApp que o cliente preenche dentro da conversa, só nos canais oficiais: ele é enviado pelo atendimento (opção Flow do WhatsApp oficial), pelo Chat Flow, pela Agenda Mensagens e por templates com botão de formulário. Os formulários desta tela são páginas abertas pelo link /f/endereço.

Lista de formulários

A tela mostra um cartão para cada formulário: O menu de ações do cartão (ícone de três pontos) tem Editar, Respostas, Ativar ou Desativar e Excluir. Editar e Respostas também ficam no rodapé do cartão.
Excluir apaga o formulário e todas as respostas guardadas dele, e o link deixa de funcionar. Os cartões que já estão nos atendimentos continuam. Para só parar de receber envios, use Desativar: quem abrir o link vê que o formulário está indisponível, e as respostas já recebidas continuam guardadas.

Criar um formulário

1

Abra o editor

Em Gestão Comercial → Operação → Formulários, clique em Novo formulário.
2

Dê um nome

Preencha o Nome do formulário (por exemplo, “Orçamento”). É o nome que a equipe vê no cartão do atendimento e nas respostas; o título que o visitante vê fica na aba Aparência. O Endereço do formulário (o final do link) é sugerido a partir do nome e conferido na hora. Deixe Ativo ligado para receber envios.
3

Monte os campos

Na aba Campos, o formulário novo já vem com Nome e Telefone (WhatsApp), os dois obrigatórios. Clique em Adicionar campo para incluir outros.
4

Escolha o canal e o destino

Na aba Ao enviar, escolha o Canal do atendimento (sem canal, o formulário fica indisponível), o destino, as etiquetas e, se quiser, a oportunidade no funil e a confirmação ao cliente.
5

Ajuste a aparência

Na aba Aparência, coloque logo, cores e os textos que o visitante vê. A Prévia ao lado mostra o resultado e não envia nada (no celular, alterne entre Editar e Prévia).
6

Crie e divulgue

Clique em Criar formulário. As abas Compartilhar e Respostas ficam liberadas depois de criar: em Compartilhar estão o link, o QR code e o código para o seu site.
Sair do editor com alterações não salvas abre o aviso Sair sem salvar?, com Continuar editando e Descartar alterações. Depois de salvar, o quadro Revise antes de divulgar lista o que ainda atrapalha o formulário (por exemplo, canal desconectado, fila apagada ou canal oficial sem template de confirmação).

Aba Campos

O topo da aba mostra quantos campos o formulário tem (até 50). Clique em Adicionar campo, escolha o Tipo do campo e preencha as propriedades. Para mudar a ordem, arraste pelo ícone de pontos ou use Subir e Descer.

Tipos de campo

O formulário não tem campo para envio de arquivo.

Propriedades do campo

Mudar o tipo de um campo que já recebeu respostas não altera as respostas antigas. Remover um campo tira o campo do formulário, mas as respostas que já chegaram continuam guardadas com ele.

Guardar em

O tipo do campo precisa combinar com o dado: Telefone (WhatsApp) só recebe campo Telefone, E-mail só recebe campo E-mail e Aniversário só recebe campo Data; os demais dados aceitam Texto curto, Texto longo, Lista (uma opção) e Campo oculto. Número, Múltipla escolha e Caixa de confirmação vão só para Só no atendimento ou Campo personalizado do contato.
Contato que já existe só recebe o dado quando o campo dele está vazio: o que já está gravado nunca é trocado. Telefone e e-mail entram só no contato criado pelo envio.

Telefone e e-mail do contato

O canal escolhido em Ao enviar decide como o contato é identificado, e a aba Campos avisa o que falta:
  • Canal de WhatsApp (não oficial ou oficial): o formulário precisa de um campo Telefone guardado em Telefone (WhatsApp) e marcado como obrigatório. O atendimento abre e a confirmação sai por esse número, do jeito que a pessoa digitou, com o país, sem conferir se ele tem WhatsApp.
  • Canal de e-mail: o formulário precisa de um campo E-mail guardado em E-mail e marcado como obrigatório.
  • Com Reserva por e-mail: o formulário precisa dos dois campos, e a pessoa pode informar só o telefone ou só o e-mail.
Quando falta algo, a própria aba oferece os botões Adicionar campo de telefone, Adicionar campo de e-mail ou Tornar obrigatório. O Campo oculto guarda um valor que a pessoa não vê, como a origem da visita. Em Parâmetro do endereço, informe o nome do parâmetro lido do link, por exemplo utm_source: quem abrir .../f/orcamento?utm_source=instagram envia o valor instagram nesse campo. Sem o parâmetro no link, vale o Valor padrão. Os nomes embed, ref, lang, sent e error são usados pela própria página e não podem ser parâmetro. Nas respostas, o valor aparece marcado como oculto.

Regras por resposta

Nos campos Lista (uma opção) e Múltipla escolha, ligue Regra por resposta para escolher, em cada opção, a Fila desta resposta (ou Sem fila própria) e as Etiquetas desta resposta.
  • A fila da opção vale só para atendimento novo no destino Vai para a fila. Se a pessoa escolher várias opções com fila, vence a primeira, na ordem dos campos. Ela também vence a Fila escolhida em Ao enviar.
  • As etiquetas das opções escolhidas valem sempre, se somam às etiquetas do formulário e vão para o contato.
  • Nos destinos Começa no fluxo e Começa com o agente de IA, a fila das opções não é usada; as etiquetas continuam valendo.

Aba Aparência

A aba do navegador mostra o Título; sem título, mostra o Nome do formulário.
Na Descrição, na Ajuda de cada campo, no Texto ao lado da caixa e na Mensagem final, você pode colocar links: escreva [texto](https://...), como [política de privacidade](https://www.exemplo.com.br/privacidade), ou cole o endereço solto. Só endereços http e https viram link, e o link abre em nova aba.
Os textos que você escreve aparecem como estão, sem tradução. Os textos padrão da página (botão, avisos de erro, tela de enviado) seguem o idioma do link ou da Região da empresa.

Aba Ao enviar

Canal do atendimento

Em Canal, escolha onde o atendimento abre: a lista mostra só os canais aceitos, nos grupos WhatsApp e canais oficiais e E-mail, e marca os desconectados. O atendente responde por esse canal, e a resposta do cliente cai no mesmo atendimento.
  • Canal oficial: quem nunca falou com você (ou não fala há mais de 24 h) só recebe a confirmação por template aprovado.
  • Canal de e-mail: o atendimento abre pelo e-mail da pessoa e sempre vai para a fila (fluxo e agente de IA não rodam no e-mail).
  • Reserva por e-mail: com um canal de WhatsApp escolhido, você pode indicar um canal de e-mail para quem não informar o telefone. Quem informar o telefone vai para o canal principal; quem informar só o e-mail, para a reserva. Sem reserva, o telefone é obrigatório.
Com o canal desconectado, o formulário continua recebendo envios e abrindo atendimentos, mas a confirmação ao cliente e as respostas da equipe só saem quando o canal voltar.

Destino do atendimento novo

Nos destinos de fluxo e de agente, o campo vira Fila de reserva: recebe quem cair no canal de e-mail, quem tiver o robô bloqueado e o atendimento em que o fluxo ou o agente não puder começar. Com a reserva por e-mail, essa fila é obrigatória.
Se o contato já tiver um atendimento aberto ou pendente no mesmo canal, as respostas entram nele sem mudar fila nem dono, e o dono é avisado. Fila, fluxo, agente e oportunidade valem só para atendimento novo.

Etiquetas

As Etiquetas escolhidas vão para o contato (não para o atendimento) e se somam às que ele já tem e às etiquetas das respostas com regra.

Oportunidade no funil

Ligue Criar oportunidade e escolha o Funil e a Etapa para criar uma oportunidade para o contato quando o formulário abrir um atendimento novo. Ela nasce com valor zero, e as ações da etapa escolhida (mensagens, etiquetas) disparam como numa oportunidade criada à mão. Cada envio que abre um atendimento novo cria uma oportunidade nova, mesmo que o contato já tenha outra aberta. Veja o funil em CRM e Funil.

Confirmação ao cliente

Ligue Enviar confirmação para mandar uma mensagem automática a quem enviou, pelo canal em que o atendimento abriu. Ela sai uma vez por envio; as respostas completas ficam só no cartão do atendimento. Em Inserir variável, clique para colocar no texto: As mesmas variáveis servem para preencher as variáveis do template.
Com o Texto da confirmação vazio, sai a mensagem padrão “Recebemos o seu formulário. Em breve entraremos em contato.” (no idioma da Região da empresa). Ela não traz o nome da pessoa nem o do formulário: para incluí-los, escreva o texto e use {{primeiroNome}} e {{nomeFormulario}}.
O formulário é público: qualquer pessoa pode digitar o telefone de outra. Com Enviar confirmação ligado, a mensagem sai do número da sua empresa para o telefone informado, mesmo que ele não seja de quem preencheu. Em canais não oficiais (conectados por QR Code, como Baileys, Zapo ou Meow), isso vira mensagem não solicitada e aumenta o risco de denúncia e de bloqueio do número. Nesses canais, inclua uma Caixa de confirmação obrigatória em que a pessoa autoriza o contato (por exemplo, “Autorizo receber mensagens no WhatsApp informado”) ou deixe a confirmação desligada.

Aba Compartilhar

Em Endereço do formulário, defina a parte final do link (/f/endereço): de 3 a 80 letras sem acento, números e hífen. A tela confere na hora (Disponível ou Já está em uso por outro formulário.) e pode sugerir outro endereço em Usar. Em Link, use Copiar link ou abra o formulário.
O endereço é único em toda a plataforma: dois formulários, mesmo de empresas diferentes, nunca têm o mesmo endereço. Mudar o endereço quebra o link antigo: ao salvar, o link anterior deixa de funcionar, então atualize onde ele já foi divulgado (site, QR code impresso, redes sociais).

QR code

Quem aponta a câmera do celular abre o formulário, o que é bom para material impresso e balcão. Use Baixar QR code para ter a imagem em boa resolução.

Embutir no site

Cole o código na página do seu site onde o formulário deve aparecer. Não há arquivo para baixar: o código já contém tudo.
O formulário embutido funciona em páginas com endereço https. Em página sem https, o navegador não mostra o quadro: use o link ou o QR code.
Criou ou mudou um campo oculto? Salve e copie o código com script de novo: ele guarda a lista de parâmetros do momento em que foi copiado. Mudou o endereço do formulário? Copie o código de novo também.

Envio por outros sites e sistemas

Para usar o formulário HTML do seu próprio site ou um sistema que envia sem token, ligue Aceitar envios de outros sites (desligado por padrão: só a página do formulário e o código de embutir enviam). Com a opção ligada, aparecem:
  • Endereço de envio, com Copiar endereço: aceita o formulário HTML (método POST) e JSON.
  • HTML de exemplo: ponto de partida para o seu site. Ajuste o visual à vontade, mas mantenha os nomes dos campos e o campo hp_website (armadilha contra robôs, que deve ficar vazio e escondido).
Em Chaves dos campos, a aba lista a chave, o rótulo e o tipo de cada campo salvo, para usar como nome dos campos no seu HTML ou no JSON: As travas contra abuso continuam valendo (limite por endereço de rede e teto de 24 h).

Envio pela API

Para integrar um sistema com segurança, use a rota de formulários da API (com token): ela não depende da opção Aceitar envios de outros sites e devolve o atendimento criado. A aba mostra o formId e o slug deste formulário para usar na rota. Veja API de Formulários.

Limites contra abuso

Aba Respostas

A aba lista os envios do formulário, 25 por página (Anterior e Próxima).
  • Filtros: De, Até e Situação (Todas, Pendentes (recebido ou processando) ou uma situação), com Filtrar e Limpar. Atualizar recarrega a lista.
  • Cada envio mostra a data, a situação, a origem (Página, Site (embutido), Outro site ou API), o contato, o botão Ver atendimento, o resultado da confirmação e Ver respostas (os campos ocultos aparecem marcados como oculto).
O selo Parado marca o envio que ficou recebido por mais de 2 minutos ou processando por mais de 5 minutos.

O que acontece quando alguém envia

  1. Contato: é achado só pela identidade do canal (o telefone no WhatsApp, o e-mail no canal de e-mail) ou criado. Contato que já existe só tem preenchido o que estava vazio.
  2. Etiquetas: as do formulário e as das respostas com regra se somam às do contato.
  3. Atendimento: com um atendimento aberto ou pendente do contato no mesmo canal, as respostas entram nele. Sem isso, abre um atendimento novo no destino escolhido, com a oportunidade no funil, se configurada.
  4. Cartão e aviso: as respostas entram na conversa no cartão Formulário recebido, e a equipe é avisada como numa mensagem recebida.
  5. Confirmação: sai para o cliente, se estiver ligada.
Contato bloqueado não abre atendimento nem recebe mensagem: o envio fica como Ignorado.

No atendimento: o cartão Formulário recebido

Na conversa, o envio aparece como o cartão Formulário recebido, seguido do nome do formulário, com cada pergunta e a resposta (caixas de confirmação como Sim ou Não e datas no formato local). Só a equipe vê este cartão: ele não é enviado ao contato, por isso não dá para citar, encaminhar nem reagir a ele. Para falar com o contato, escreva normalmente na conversa. A Linha do tempo do contato também registra Enviou o formulário, com o nome do formulário.

A página do formulário

  • Idioma: os textos padrão (botão, avisos, tela de enviado) seguem o idioma da Região da empresa. Para escolher o idioma, acrescente ?lang= ao link, por exemplo .../f/orcamento?lang=es. A página tem português, inglês, espanhol, alemão, francês, italiano, japonês, chinês, árabe, hindi, indonésio, russo e turco.
  • Telefone: o campo traz a escolha do país, que começa no país da Região da empresa.
  • Depois do envio: a pessoa vê Enviado com a Mensagem final, ou vai para o endereço de Redirecionar para.
  • Indisponível: com o formulário desativado, sem canal ou com o canal apagado ou não aceito, quem abrir o link vê Formulário indisponível.
  • Avisos ao visitante: “Este formulário atingiu o limite de envios de hoje. Tente mais tarde.” (teto de 24 h), “Muitas tentativas. Aguarde alguns minutos e tente de novo.” (muitos envios em pouco tempo) e “A página ficou aberta por muito tempo. Envie de novo.” (página aberta por tempo demais antes do envio).
O Nome do formulário também vai dentro do código de embutir e aparece na aba do navegador quando o Título está vazio. Use um nome que possa ser visto por quem preenche.

Antes de achar que é erro

Abra a aba Respostas e veja a situação do envio. Suspeito: foi enviado mais rápido que o Tempo mínimo de preenchimento; use Abrir atendimento. Falhou: veja o motivo e use Tentar de novo. Ignorado: o contato está bloqueado. Se o contato já tinha um atendimento aberto ou pendente no mesmo canal, as respostas entraram nele, sem mudar fila nem dono.
Confira se Enviar confirmação está ligado e veja o resultado da confirmação na aba Respostas. No canal oficial, sem template, a confirmação só sai para quem falou com você nas últimas 24 h. Com o canal desconectado, a confirmação falha e não é reenviada sozinha.
Confira se a página do site tem endereço https (sem https, o navegador não mostra o quadro) e se o código foi copiado depois da última mudança do Endereço do formulário. Se o site não aceita script, use o Código sem script.
Eles começam na primeira mensagem do cliente, não no envio. Contato com o robô bloqueado vai para a Fila de reserva, e um atendimento que já estava aberto no mesmo canal não muda de destino.
A fila das opções só vale para atendimento novo no destino Vai para a fila, e vence a primeira opção escolhida que tiver fila, na ordem dos campos.
Contato que já existe só recebe o dado quando o campo dele está vazio, e telefone e e-mail entram só no contato criado pelo envio. Para guardar sempre a resposta mais nova, use Campo personalizado do contato em Guardar em.