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:Criar um formulário
Abra o editor
Dê um nome
Monte os campos
Escolha o canal e o destino
Ajuste a aparência
Crie e divulgue
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
Propriedades do campo
Guardar em
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.
Campos ocultos e parâmetros do link
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 exemploutm_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
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.
Destino do 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.{{primeiroNome}} e {{nomeFormulario}}.Aba Compartilhar
Endereço e link
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.
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.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).
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 que acontece quando alguém envia
- 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.
- Etiquetas: as do formulário e as das respostas com regra se somam às do contato.
- 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.
- Cartão e aviso: as respostas entram na conversa no cartão Formulário recebido, e a equipe é avisada como numa mensagem recebida.
- Confirmação: sai para o cliente, se estiver ligada.
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).
Antes de achar que é erro
O envio chegou, mas o atendimento não abriu
O envio chegou, mas o atendimento não abriu
A confirmação não chegou ao cliente
A confirmação não chegou ao cliente
O link mostra Formulário indisponível
O link mostra Formulário indisponível
O formulário embutido não aparece no meu site
O formulário embutido não aparece no meu site
O fluxo ou o agente de IA não começou
O fluxo ou o agente de IA não começou
A fila escolhida numa opção não foi usada
A fila escolhida numa opção não foi usada
O cadastro do contato não mudou
O cadastro do contato não mudou

