> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.pandazap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Formulários: Crie, Divulgue e Receba Respostas como Atendimentos

> Monte formulários públicos com os campos que precisar, divulgue por link, QR code ou no seu site e receba cada envio como um atendimento no canal escolhido, com contato, etiquetas, oportunidade e confirmação ao cliente.

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.

> [!NOTE]
>
> **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](https://ajuda.pandazap.com/platform/teams-users.md)). 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](https://ajuda.pandazap.com/platform/chat-flow.md#formulário-do-whatsapp-flow), pela [Agenda Mensagens](https://ajuda.pandazap.com/platform/automacoes-adicionais.md#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:

| Elemento | O que mostra |
| - | - |
| Nome | O **Nome do formulário**. Clique nele para editar. |
| Link | O endereço `/f/endereço`, com os botões para abrir o formulário em outra aba e **Copiar link**. |
| **Ativo** ou **Desativado** | A situação do formulário. |
| Canal | O canal escolhido, com aviso quando há algo a corrigir: **Sem canal escolhido**, **O canal foi apagado**, **Tipo de canal não aceito** ou **Canal desconectado**. O ícone de ajuda ao lado do aviso explica o que fazer. |
| Destino | **Vai para a fila**, **Começa no fluxo** ou **Começa com o agente de IA**. |
| **Envios em 24 h** | Os envios do último dia e quanto do teto de 24 h já foi usado (por exemplo, "12 de 500 no teto de 24 h"). Com o teto atingido, aparece **Teto de 24 h atingido**. |
| **Total de envios** | Todos os envios recebidos pelo formulário. |
| Selos | **pendentes**, **com falha** e **suspeitos**. Clique num selo para abrir a aba **Respostas** já filtrada. |
| Último envio | A data e a hora do último envio, ou **Nenhum envio ainda**. |

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.

> [!WARNING]
>
> **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

| 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`) |

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

### Propriedades do campo

| Propriedade | O que faz |
| - | - |
| **Rótulo** | A pergunta que aparece para a pessoa. No **Campo oculto**, o rótulo não aparece para o visitante: serve para a equipe reconhecer o valor nas respostas. |
| **Chave** | Nome técnico do campo: é ele que vai no envio por outros sites e pela API. O sistema sugere uma chave; se quiser trocar, use de 2 a 40 letras minúsculas sem acento, números e sublinhado, começando com letra. Depois de salvar, a chave não muda mais. |
| **Obrigatório** | A pessoa só consegue enviar com o campo preenchido (na **Caixa de confirmação**, só depois de marcar a caixa). |
| **Texto de exemplo** | Aparece apagado dentro do campo vazio. |
| **Ajuda** | Explicação curta embaixo do campo. |
| **Largura** | **Linha inteira** ou **Meia linha**. Dois campos de meia linha ficam lado a lado no computador; no celular, todos ocupam a linha inteira. |
| **Mínimo** e **Máximo** | No **Número**. Vazio = sem limite. |
| **Tamanho máximo** | No **Texto curto** (até 500 letras) e no **Texto longo** (até 5.000). |
| **Opções** | Na **Lista (uma opção)** e na **Múltipla escolha**, até 50 opções. Cole uma lista com uma opção por linha para criar várias de uma vez. |
| **Texto ao lado da caixa** | Na **Caixa de confirmação**, por exemplo "Li e aceito a política de privacidade". Vazio = o rótulo do campo. |
| **Parâmetro do endereço** e **Valor padrão** | No **Campo oculto** (veja abaixo). |
| **Guardar em** | Onde a resposta fica além do cartão do atendimento e da aba **Respostas** (veja abaixo). |

> [!NOTE]
>
> 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

| Opção | O que acontece |
| - | - |
| **Só no atendimento** | A resposta fica no cartão do atendimento e em **Respostas**, sem mudar o contato. |
| **Dado do contato** | A resposta vai para um dado do cadastro do contato: **Nome**, **Primeiro nome**, **Sobrenome**, **E-mail**, **Telefone (WhatsApp)**, **CPF**, **Aniversário**, **Empresa**, **CEP**, **Rua**, **Número do endereço**, **Complemento**, **Bairro**, **Cidade** ou **Estado (UF)**. Cada dado só pode ser usado por um campo. |
| **Campo personalizado do contato** | A resposta vai para o campo personalizado do contato com o nome escrito em **Nome do campo personalizado** (ex.: "Interesse"). Uma resposta nova substitui a anterior. |

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**.

> [!NOTE]
>
> 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**.

### 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 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

| Seção | Opções |
| - | - |
| **Imagens** | **Logo** (topo do formulário) e **Imagem de capa** (faixa no alto). Use **Escolher da galeria** ou cole um endereço que comece com https. O logo aparece sem a margem transparente do arquivo. |
| **Cores** | **Cor principal** (botão e destaques) e **Cor de fundo** (página em volta do formulário), no formato #RRGGBB; **Voltar à cor padrão** desfaz. Se a cor escolhida ficar difícil de ler, a página ajusta o tom do botão e dos links. |
| **Estilo** | **Esquema** (**Automático** segue o modo claro ou escuro do aparelho de quem abre; **Claro**; **Escuro**), **Cantos** (**Retos**, **Pouco arredondados** ou **Bem arredondados**) e **Largura** (**Estreito**, bom para poucos campos, ou **Largo**, para campos lado a lado; no celular, os dois ocupam a tela inteira). |
| **Textos** | **Título** (vazio = o nome do formulário), **Descrição** (texto curto embaixo do título), **Texto do botão** (vazio = **Enviar**, no idioma de quem abre), **Mensagem final** (aparece depois do envio; vazio = "Recebemos as suas respostas. Obrigado!") e **Redirecionar para** (endereço https para onde a pessoa vai depois do envio, como a página de obrigado do seu site; com ele preenchido, a mensagem final não aparece). |

A aba do navegador mostra o **Título**; sem título, mostra o **Nome do formulário**.

> [!TIP]
>
> 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.

> [!NOTE]
>
> 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.

> [!NOTE]
>
> 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

| Destino | O que acontece |
| - | - |
| **Vai para a fila** | Entra na **Fila** escolhida (ou na fila da resposta com regra) e a equipe atende. Vazio = **Fila padrão do canal**. |
| **Começa no fluxo** | O **Fluxo** escolhido fica pronto no atendimento e começa na primeira mensagem do cliente. |
| **Começa com o agente de IA** | O **Agente de IA** escolhido fica pronto no atendimento, com as respostas do formulário, e começa na primeira mensagem do cliente. Agentes só de base de conhecimento não aparecem na lista. |

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.

> [!NOTE]
>
> 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](https://ajuda.pandazap.com/platform/crm-pipeline.md).

### 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.

| Campo | Quando aparece | Como usar |
| - | - | - |
| **Template da confirmação** | Canal oficial | Escolha um template aprovado e preencha todas as variáveis dele (variável vazia faz a Meta recusar o envio). Sem template, a confirmação só sai se a conversa estiver aberta nas últimas 24 h. |
| **Assunto do e-mail** | Canal de e-mail ou com reserva por e-mail | Assunto da confirmação enviada por e-mail. Vazio = "Recebemos o seu formulário". |
| **Texto da confirmação** | Sempre | O texto da mensagem (até 2.000 caracteres). No canal oficial, ele só é usado sem template e com a conversa aberta nas últimas 24 h. Quem cair na reserva por e-mail recebe a confirmação por e-mail, com o assunto e este texto. |

Em **Inserir variável**, clique para colocar no texto:

| Variável | O que entra |
| - | - |
| `{{nome}}` | Nome da pessoa |
| `{{primeiroNome}}` | Primeiro nome |
| `{{respostas}}` | As respostas do formulário |
| `{{nomeFormulario}}` | Nome do formulário |
| `{{protocolo}}` | Protocolo |
| A chave do campo entre chaves duplas | A resposta daquele campo, como `{{empresa}}` para um campo com a chave `empresa`. Na lista, as variáveis com borda tracejada são os campos deste formulário. |

As mesmas variáveis servem para preencher as variáveis do template.

> [!NOTE]
>
> 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}}`.

> [!WARNING]
>
> 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

### 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.

> [!WARNING]
>
> 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.

| Código | O que faz |
| - | - |
| **Código com script (recomendado)** | Ajusta a altura sozinho, repassa os parâmetros dos campos ocultos (como `utm_source`) e leva a pessoa para o link de **Redirecionar para**. A tela mostra os **Parâmetros repassados**. |
| **Código sem script** | Para sites que não aceitam script: altura fixa e sem repassar parâmetros. |

> [!NOTE]
>
> 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.

> [!TIP]
>
> 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:

| Tipo | Valor enviado |
| - | - |
| **Lista (uma opção)** e **Múltipla escolha** | O identificador da opção (o texto da opção também é aceito). Na múltipla escolha, repita a chave uma vez para cada opção. |
| **Caixa de confirmação** | Marcado = `true` (ou `on`). |
| **Data** | Formato AAAA-MM-DD. |
| **Telefone** | Com o país, por exemplo +55 11 99999-9999. Sem o +, vale o país da Região da empresa. |

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](https://ajuda.pandazap.com/api/forms.md).

### Limites contra abuso

| Campo | Padrão | O que faz |
| - | - | - |
| **Teto de envios em 24 h** | 500 (de 1 a 10.000) | Acima do teto, novos envios pela página e por outros sites são recusados até a contagem das últimas 24 h baixar. Envios pela API e os suspeitos não contam. |
| **Tempo mínimo de preenchimento (segundos)** | 3 (de 0 a 60) | Envio feito mais rápido que isso (comum em robôs e no preenchimento automático do navegador) fica guardado como **Suspeito** em **Respostas**, sem abrir atendimento nem mandar mensagem. Com 0, nenhum envio é marcado como suspeito pelo tempo. A página do formulário espera esse tempo sozinha antes de enviar. |

## 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**).

| Situação | O que significa |
| - | - |
| **Recebido** | Chegou e vai abrir o atendimento em instantes |
| **Processando** | Abrindo o atendimento |
| **Processado** | Atendimento aberto ou atualizado |
| **Falhou** | Não abriu o atendimento; veja o motivo e tente de novo |
| **Suspeito** | Enviado rápido demais e guardado sem abrir atendimento |
| **Ignorado** | Contato bloqueado; nada foi aberto nem enviado |

O selo **Parado** marca o envio que ficou recebido por mais de 2 minutos ou processando por mais de 5 minutos.

| Ação | Quando aparece | O que faz |
| - | - | - |
| **Tentar de novo** | Envio **Falhou** ou **Parado** | Processa o envio de novo. |
| **Abrir atendimento** | Envio **Suspeito** | Faz tudo o que um envio normal faz: contato, etiquetas, atendimento, oportunidade e confirmação ao cliente. |
| **Exportar CSV** | Sempre | Baixa a planilha com as respostas do filtro atual, até 10.000, com as colunas **Data**, **Situação**, **Erro**, **Origem**, **Contato**, **Atendimento**, **Confirmação** e uma coluna por campo. Valores que começam com =, +, - ou @ ganham um apóstrofo na frente para a planilha não tratá-los como fórmula. |

| Resultado da confirmação | O que significa |
| - | - |
| **Confirmação enviada** | Entregue ao canal do atendimento para envio. Com o canal fora do ar ela pode não chegar ao cliente: confira na conversa. |
| **Confirmação não enviada** | Nada foi enviado ao cliente: no WhatsApp oficial sem template a janela de 24 h estava fechada, ou faltou o texto, o e-mail do cliente ou um template válido. O atendimento abriu normalmente. |
| **Confirmação falhou** | O canal recusou ou não conseguiu enviar (por exemplo, canal desconectado). O atendimento abriu normalmente, e a confirmação não é reenviada sozinha. |

## 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).

> [!TIP]
>
> 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

> [accordion] O envio chegou, mas o atendimento não abriu
>
> 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.

> [accordion] A confirmação não chegou ao cliente
>
> 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.

> [accordion] O link mostra Formulário indisponível
>
> O formulário pode estar **Desativado**, sem canal ou com um canal apagado ou não aceito: a lista de formulários mostra o aviso no cartão. Escolha o canal em **Ao enviar**, ative o formulário e salve.

> [accordion] O formulário embutido não aparece no meu site
>
> 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**.

> [accordion] O fluxo ou o agente de IA não começou
>
> 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.

> [accordion] A fila escolhida numa opção não foi usada
>
> 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.

> [accordion] O cadastro do contato não mudou
>
> 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**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.