Disponível para o perfil: Administrador

Os Formulários são páginas públicas que você monta no Fullchat e compartilha por link, QR code ou dentro do seu site. Quando alguém preenche e envia, o contato é criado (ou completado) e um atendimento abre no canal escolhido, com as respostas num cartão que só a equipe vê.

Use para captar pedidos de orçamento, abrir chamados de suporte, receber candidatos a vagas ou qualquer contato que hoje chega por um formulário solto do site e precisa ser repassado à mão.

Pré-requisitos:

O plano da empresa precisa incluir Formulários.
Pelo menos um canal conectado de WhatsApp (API Oficial) ou de e-mail. É nele que o atendimento abre.
Filas e etiquetas já cadastradas. Se for usar, também o fluxo do Chat Flow, o agente de IA e o funil.

Como funciona

Cada formulário tem os próprios campos, canal, fila e etiquetas. Crie um por assunto (orçamento, suporte, vagas).
O formulário não é um canal novo e não conta como conexão do plano. O atendimento abre no WhatsApp, no WhatsApp oficial ou no e-mail que você escolher, e quando o cliente responde, a mensagem cai nesse mesmo atendimento.
Cada envio fica guardado na aba Respostas, com filtro e exportação para planilha.

O caminho de um envio:

A pessoa abre o link (ou o formulário no seu site), preenche e clica em Enviar.
O Fullchat procura o contato pela identidade do canal: o telefone, no WhatsApp; o e-mail, no canal de e-mail. Se não achar, cria o contato.
Se o contato não tem atendimento aberto naquele canal, abre um atendimento novo em Pendentes, no destino escolhido (fila, fluxo ou agente de IA), com as etiquetas e, se ligado, uma oportunidade no funil.
Se o contato já tem atendimento aberto ou pendente naquele canal, as respostas entram nele, sem mudar fila nem responsável, e o responsável é avisado.
A equipe recebe o aviso como numa mensagem recebida. Se ligada, a confirmação sai para o cliente.

Como acessar

Acesse Gestão Comercial → Operação → Formulários no menu lateral.

A tela lista os formulários em cartões. Cada cartão mostra o nome, a situação (Ativo), o endereço (com botão de copiar), o canal, o destino, os Envios em 24 h (com o uso do teto diário), o Total de envios, a data do último envio e os botões Editar e Respostas.

Como criar um formulário

Clique em Novo formulário (canto superior direito).
Preencha o nome e o endereço:

Campo	Descrição
Nome do formulário	Nome interno, para você achar o formulário na lista. Ex.: Orçamento, Suporte, Trabalhe conosco. Também vira o título da página se você não preencher um em Aparência
Endereço do formulário	Final do link público. Ex.: `orcamento` gera `
Ativo	Liga ou desliga o formulário. Desligado, quem abre o link vê Formulário indisponível

Configure as abas Campos, Aparência e Ao enviar (seções abaixo).
Clique em Criar formulário (canto superior direito). O formulário é salvo e a tela abre direto na aba Compartilhar, com o link pronto. Nas próximas edições, o botão passa a se chamar Salvar.

À direita, a Prévia mostra o formulário como o cliente vai ver, atualizada a cada mudança. A prévia não envia nada.

Aba	Para que serve
Campos	Perguntas do formulário, tipos de campo, onde cada resposta é guardada e regras por resposta
Aparência	Logo, cores, estilo, textos, redirecionamento e mensagem final
Ao enviar	Canal, fila/fluxo/agente de IA, etiquetas, oportunidade no funil e confirmação ao cliente
Compartilhar	Link, QR code, código para o site, envio por outros sites e limites contra abuso. Liberada depois de criar o formulário
Respostas	Envios recebidos, filtros e exportação. Liberada depois de criar o formulário

Revise antes de divulgar. Depois de salvar, o topo da tela mostra esse aviso quando alguma configuração pode impedir o funcionamento esperado. Ex.: "Canal oficial sem template de confirmação: a confirmação só sai para quem falou com você nas últimas 24 h". O aviso é conferido a cada salvamento.

Campos

Na aba Campos você monta as perguntas do formulário. Ele já começa com dois campos obrigatórios: Nome (guardado no nome do contato) e Telefone (WhatsApp) (guardado no telefone do contato). Você pode ter até 50 campos por formulário.

Clique em Adicionar campo e escolha o tipo.
Use o ícone de pontos (arrastar) ou as setas ↑ ↓ para mudar a ordem.
Clique na seta ⌄ do campo para abrir as opções dele; o ícone da lixeira remove o campo.

O canal decide o campo de identificação. Com um canal de WhatsApp escolhido em Ao enviar, o topo da aba avisa que o atendimento abre pelo telefone informado no campo Telefone (WhatsApp). Sem canal, o formulário não recebe envios.

Tipos de campo

Tipo	Para que serve
Texto curto	Uma linha, como nome ou empresa
Texto longo	Várias linhas, como uma mensagem
E-mail	Confere o formato do e-mail
Telefone	Com o país e o DDD; pode virar o telefone do contato
Número	Só números, com mínimo e máximo
Data	Escolha de um dia no calendário
Lista (uma opção)	A pessoa escolhe uma opção
Múltipla escolha	A pessoa marca uma ou mais opções
Caixa de confirmação	Uma caixa para marcar, como o aceite de privacidade
Campo oculto	Invisível para quem preenche: guarda a origem do acesso (ex.: `utm_source`)

Opções de cada campo

Opção	Descrição
Tipo	Pode ser trocado depois de adicionado
Chave	Código do campo (ex.: `f_xk085m`), usado no envio pela API e nas variáveis da confirmação. Aceita letras minúsculas sem acento, números e sublinhado. Depois de salvar, a chave não muda mais
Rótulo	A pergunta que aparece para a pessoa. Ex.: "Qual o nome da sua empresa?"
Obrigatório	A pessoa só consegue enviar com o campo preenchido. Campos não obrigatórios aparecem com (opcional)
Texto de exemplo	Aparece apagado dentro do campo vazio
Largura	Quanto da linha o campo ocupa (ex.: Linha inteira)
Ajuda	Explicação curta embaixo do campo
Tamanho máximo	Limite em letras nos campos de texto. Vazio = 500 no texto curto e 5.000 no texto longo
Guardar em	Onde a resposta fica guardada (veja abaixo)

Onde a resposta é guardada (Guardar em)

Opção	O que acontece
Só no atendimento	A resposta fica no cartão do atendimento e em Respostas, sem mudar o contato
Um dado do contato (ex.: Contato: Nome, Contato: Empresa)	A resposta preenche esse dado no cadastro, só se ele estiver vazio
Campo personalizado do contato	Informe o Nome do campo personalizado. A resposta vai para o campo personalizado do contato com esse nome, e uma resposta nova substitui a anterior

Tipos que não combinam com nenhum dado do contato, como Múltipla escolha, só aceitam Só no atendimento ou Campo personalizado do contato.

Opções de lista e regra por resposta

Nos campos Lista (uma opção) e Múltipla escolha, cadastre as opções em Opções (até 50). Clique em Adicionar opção para incluir uma por vez, ou cole uma lista com uma opção por linha para criar várias de uma vez.

Ligue Regra por resposta para mandar cada resposta para um lugar:

Fila desta resposta: a fila em que o atendimento abre quando a pessoa escolhe essa opção. Sem fila própria = usa a fila escolhida em Ao enviar.
Etiquetas desta resposta: etiquetas somadas às etiquetas gerais do formulário.

Exemplo: num formulário de orçamento com a pergunta "Qual serviço precisa?", a opção Site abre o atendimento na fila Comercial e a opção Tráfego na fila Financeiro.

Campo oculto

O campo oculto não aparece para quem preenche. Ele recebe um valor pelo link do formulário, para você saber de onde veio cada envio (Instagram, anúncio, site parceiro).

Opção	Descrição
Rótulo	Não aparece para o visitante: serve para a equipe reconhecer o valor nas respostas
Parâmetro do endereço	Nome do parâmetro lido no link. Ex.: `utm_source`
Valor padrão	Valor guardado quando o link não traz o parâmetro
Guardar em	Só no atendimento ou Campo personalizado do contato

Formulário embutido no site: depois de criar um campo oculto, copie de novo o código com script em Compartilhar. O código guarda a lista de parâmetros do momento em que foi copiado.

Aparência

Na aba Aparência você deixa o formulário com a cara da sua marca e define o que a pessoa vê depois de enviar. Acompanhe cada mudança na Prévia.

Seção	Campo	Descrição
Imagens	Logo	Endereço (URL) da imagem ou escolha pela galeria (ícone ao lado)
	Imagem de capa	Endereço (URL) da imagem ou escolha pela galeria
Cores	Cor principal	Cor do botão e dos destaques
	Cor de fundo	Cor da página em volta do formulário
Estilo	Esquema	Tema do formulário. Ex.: Automático ou Escuro
	Cantos	Arredondamento dos campos e do botão. Ex.: Pouco arredondados ou Retos
	Largura	Largura do formulário na página. Ex.: Estreito ou Largo
Textos	Título	Título no topo do formulário. Vazio = usa o nome do formulário
	Descrição	Texto curto embaixo do título
	Texto do botão	Ex.: "Enviar resposta". Vazio = Enviar, no idioma de quem abre
	Redirecionar para	Endereço para onde a pessoa vai depois de enviar. Ex.: uma página de obrigado do seu site. Vazio = mostra a mensagem final
	Mensagem final	Aparece depois do envio. Vazio = mensagem padrão de recebido

Ao enviar

Na aba Ao enviar você define o que acontece com cada envio: em qual canal o atendimento abre, para onde ele vai, quais etiquetas recebe, se vira oportunidade no funil e se o cliente recebe uma confirmação.

Canal do atendimento

Campo	Descrição
Canal	Em qual canal o atendimento abre: WhatsApp, WhatsApp oficial ou e-mail. O canal define se o formulário precisa do telefone ou do e-mail
Reserva por e-mail	Canal de e-mail usado como alternativa ao telefone. Sem reserva, o telefone é obrigatório. Só tem opções se houver um canal de e-mail conectado

Sem canal, o formulário fica indisponível para quem abrir o link e não recebe envios.

Destino do atendimento novo

Opção	O que acontece
Vai para a fila	O atendimento entra na fila escolhida (ou na fila da resposta, se houver regra por resposta) e a equipe atende
Começa no fluxo	O fluxo do Chat Flow começa quando o cliente responder
Começa com o agente de IA	O agente de IA atende quando o cliente responder, já sabendo as respostas do formulário

Em Fila, escolha a fila ou deixe Fila padrão do canal.

Contato com atendimento já aberto: se o contato já tem um atendimento aberto ou pendente nesse canal, as respostas entram nele sem mudar fila nem responsável, e o responsável é avisado. Fila, fluxo, agente e oportunidade valem só para atendimento novo.

Etiquetas

Clique em Adicionar para escolher as etiquetas aplicadas ao contato em todo envio. Elas se somam às etiquetas das respostas com regra.

Oportunidade no funil

Ligue Criar oportunidade e escolha o Funil e a Etapa. Vale só para atendimento novo. As ações da etapa escolhida (mensagens, etiquetas) disparam para a oportunidade.

Confirmação ao cliente

Ligue Enviar confirmação para mandar uma mensagem ao cliente depois do envio. Ela sai uma vez por envio, pelo canal em que o atendimento abriu.

Campo	Descrição
Template da confirmação	Só no WhatsApp oficial. Opcional. As variáveis do template aceitam `{{nome}}`, `{{primeiroNome}}`, `{{respostas}}`, `{{nomeFormulario}}`, `{{protocolo}}` e a chave de cada campo entre chaves duplas (ex.: `{{f_xk085m}}`)
Texto da confirmação	Mensagem enviada ao cliente. Vazio = mensagem padrão de recebido, com o nome da pessoa e do formulário
Inserir variável	Clique para inserir no texto: Nome, Primeiro nome, Respostas, Nome do formulário, Protocolo e os campos do formulário (os de borda tracejada)

WhatsApp oficial: quem nunca falou com o seu número, ou não fala há mais de 24 horas, só recebe a confirmação por template aprovado (regra da Meta). Sem template, a confirmação só sai se a conversa estiver aberta, e o Texto da confirmação só é usado nesse caso.

A aba Compartilhar é liberada depois que você cria o formulário, e a tela abre nela automaticamente ao salvar pela primeira vez.

Endereço e link

Aqui você edita o Endereço do formulário e copia o link com Copiar link (o ícone ao lado abre o formulário numa aba nova). O link também fica no topo da tela, com os botões de copiar e abrir.

QR code

Clique em Baixar QR code para salvar a imagem em boa resolução, para impressão ou tela.

Embutir no site

Há dois códigos para colar no HTML do seu site. Clique em Copiar código ao lado do escolhido e cole na página do site.

Código	Quando usar
Código com script (recomendado)	Ajusta a altura sozinho, repassa os parâmetros da página para os campos ocultos (como `utm_source`) e leva a pessoa para o link de redirecionamento
Código sem script	Para sites que não aceitam script. Abre o formulário num quadro de altura fixa e não repassa parâmetros

Criou um campo oculto novo? Copie o código com script de novo e troque no site. O código guarda a lista de parâmetros do momento em que foi copiado.

Envio por outros sites e sistemas

Opção	Descrição
Aceitar envios de outros sites	Desligado (padrão): só a página do formulário e o código de embutir enviam; envio de outra origem é recusado. Ligado: aceita o envio de um formulário HTML do seu site ou de um sistema sem token
Chaves dos campos	Lista a chave, o tipo e se é obrigatório de cada campo, além das chaves das opções de lista (ex.: `o_kp070` = Site). Use essas chaves para montar o envio

Para integrar um sistema com segurança (com token), use o envio pela API (seção Envio pela API, abaixo). A tela mostra o formId e o slug do formulário para usar na rota.

Limites contra abuso

Campo	Descrição
Teto de envios em 24 h	Máximo de envios aceitos por dia. Padrão 500; de 1 a 10.000. O uso aparece no cartão do formulário, na lista
Tempo mínimo de preenchimento (segundos)	Envios feitos em menos tempo ficam como Suspeito e não abrem atendimento. Padrão 3 segundos. Envio suspeito legítimo pode ser aberto pela aba Respostas

Respostas

Cada envio do formulário fica guardado na aba Respostas. Você também chega nela pelo botão Respostas do cartão do formulário, na lista.

Filtros e exportação

De e Até: período dos envios.
Situação: filtra pela etapa do processamento (veja a tabela abaixo).
Clique em Filtrar para aplicar e em Atualizar para buscar envios novos.
Exportar CSV: baixa a planilha com as respostas do filtro atual, até 10.000. Valores que começam com =, +, - ou @ ganham um apóstrofo na frente para a planilha não tratá-los como fórmula.

Situação	Significado
Recebido / Processando	O envio chegou e está sendo tratado. O filtro Pendentes mostra os dois juntos
Processado	Atendimento aberto ou atualizado
Falhou	O envio não abriu atendimento por um erro
Suspeito	Preenchido mais rápido que o tempo mínimo de preenchimento. Não abre atendimento sozinho
Ignorado	Contato bloqueado: não abre atendimento nem recebe mensagem

O que cada envio mostra

A situação, a origem (ex.: Página) e se a confirmação foi enviada ou não.
Data, hora e o nome de quem enviou.
Ver respostas: abre cada pergunta com a resposta. Campos ocultos aparecem com a indicação (oculto), e as opções marcadas numa Múltipla escolha aparecem separadas por vírgula.
Ver atendimento: abre o atendimento criado.

Como o envio chega no atendimento

O atendimento novo entra em Pendentes, na fila definida pelo formulário ou pela regra da resposta, com as etiquetas aplicadas. Na lista de atendimentos, a prévia mostra Formulário: [nome do formulário].

Dentro do atendimento, as respostas aparecem num cartão Formulário recebido · [nome do formulário], com cada pergunta e resposta. O cartão é só para a equipe: o cliente não o recebe. Para responder, clique em Atender este ticket, como em qualquer atendimento pendente.

Envio pela API

Use a rota formSubmit da API para mandar respostas de um sistema seu (CRM, site com back-end, automação) direto para um formulário. O resultado é o mesmo do envio pela página: o contato é achado ou criado, as etiquetas são aplicadas e o atendimento abre no canal e no destino do formulário, com a oportunidade no funil e a confirmação ao cliente, se ligadas.

Diferenças para o envio pela página:

A rota não passa pelas travas contra robôs da página (tempo mínimo de preenchimento, limite por IP e teto diário).
Não depende da opção Aceitar envios de outros sites.
Devolve o atendimento e o contato criados.

Você vai precisar de: o token da API da empresa (veja API), o formId ou o slug do formulário e as chaves dos campos, mostrados na aba Compartilhar.

Requisição

{
  "formId": 12,
  "answers": {
    "f_nome": "Maria Souza",
    "f_telefone": "+5511999998888",
    "f_email": "maria@exemplo.com",
    "f_assunto": "o_financeiro"
  }
}

Campo	Descrição
formId ou slug	Identifica o formulário (o slug é o endereço do link `/f/endereço`). Se vierem os dois, vale o formId
answers	As respostas, usando as chaves dos campos da aba Compartilhar. Campo oculto também vai pela chave
ref	Opcional. Endereço da página de origem; é guardado só com origem e caminho

Tipo de campo	Formato do valor
Lista (uma opção)	A chave da opção (ex.: `o_kp070`). O texto da opção também é aceito
Múltipla escolha	Uma lista de chaves de opção
Caixa de confirmação	`true` ou `false`
Data	`AAAA-MM-DD`
Telefone	Com `+` e o código do país (ex.: `+5511999998888`). Sem o `+`, vale o país da Região da empresa

Resposta da API

A resposta sai depois do processamento: { ok, submissionId, status, ticketId, contactId, errorCode }.

status	Significado
processed	Atendimento aberto ou atualizado
failed	O envio fica em Respostas com o motivo em `errorCode` e pode ser refeito por lá com Tentar de novo
skipped	Contato bloqueado (`ERR_FORM_CONTACT_BLOCKED`)

Erros da API

Código	Erro	Causa
400	`ERR_FORM_ID_OR_SLUG_REQUIRED`	Faltou o formId e o slug
400	`ERR_FORM_INVALID`	`answers` ausente ou fora do formato. Com `details.fields`, traz um código por chave de campo: `required`, `tooLong`, `invalidEmail`, `invalidPhone`, `invalidNumber`, `outOfRange`, `invalidDate`, `invalidOption` ou `mustAccept`
400	`ERR_FORM_CONTACT_REQUIRED`	Faltou o telefone ou o e-mail que o formulário exige para achar o contato
402	`ERR_FEATURE_NOT_IN_PLAN`	O plano da empresa não tem Formulários
404	`ERR_API_CONFIG_NOT_FOUND`	O ApiID da URL não existe nesta empresa
404	`ERR_FORM_NOT_FOUND`	Formulário inexistente, desativado, de outra empresa ou sem canal ativo
413	`ERR_FORM_TOO_LARGE`	Respostas acima de 32 KB

Veja a rota completa em Referência da API, no grupo Formulários.

Cuidados

O formulário é público: qualquer pessoa pode digitar o telefone (ou e-mail) de outra. Por isso, num contato que já existe, o formulário só preenche o que estava vazio. Nada que já está gravado é trocado, e as etiquetas se somam.
Mudar o endereço quebra o link antigo. Quem tiver o link anterior (num QR impresso, num post, no site) cai numa página que não existe mais. Defina o endereço antes de divulgar.
Excluir o formulário apaga as respostas guardadas. Os cartões que já estão nos atendimentos continuam. Exporte as respostas antes de excluir, se precisar delas.
Contato bloqueado não abre atendimento nem recebe mensagem: o envio fica como Ignorado.

Possíveis erros e soluções

Quem abre o link vê "Formulário indisponível"

Causa: o formulário está desligado em Ativo, ou nenhum canal foi escolhido em Ao enviar. Solução: escolha o canal, ligue o Ativo e salve.

O link antigo parou de funcionar

Causa: o Endereço do formulário foi alterado. Solução: divulgue o link novo ou volte o endereço para o anterior.

A confirmação aparece como "Confirmação não enviada" em Respostas

Causa: no WhatsApp oficial sem Template da confirmação, a confirmação só sai para quem falou com o seu número nas últimas 24 horas. Solução: escolha um template aprovado em Ao enviar → Confirmação ao cliente.

O envio está em Respostas, mas não abriu atendimento

Causa: o envio ficou como Suspeito (preenchido rápido demais) ou Ignorado (contato bloqueado). Solução: se for legítimo, abra o atendimento pela aba Respostas. Para contato bloqueado, desbloqueie antes.

O atendimento não foi para a fila (ou o fluxo/agente) escolhido

Causa: o contato já tinha um atendimento aberto ou pendente no canal (as respostas entram nele sem mudar fila nem responsável), ou uma Regra por resposta mandou para outra fila. Solução: confira as regras na aba Campos. Se for atendimento já aberto, é o comportamento esperado: transfira, se precisar.

O nome ou outro dado do contato não foi atualizado

Causa: comportamento esperado. Num contato que já existe, o formulário só preenche dados vazios. Campos com Guardar em: Só no atendimento nunca mudam o contato. Solução: atualize o contato direto no cadastro dele.

O campo oculto não chega pelo formulário do site

Causa: o código de embutir foi copiado antes de o campo oculto ser criado, ou o site usa o Código sem script, que não repassa parâmetros. Solução: copie o Código com script de novo em Compartilhar e troque no site.

O formulário do meu site (ou outro sistema) não consegue enviar

Causa: Aceitar envios de outros sites está desligado, e envios que não vêm da página do formulário são recusados. Solução: ligue a opção em Compartilhar, ou integre pelo envio pela API (com token).