---
title: "Atribuir formulario cliente"
slug: "atribuir-formulario-cliente"
updated: 2026-10-23T17:11:37Z
published: 2026-10-23T17:11:37Z
canonical: "docs.omnisiga.ai/atribuir-formulario-cliente"
---

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

# Atribuir formulario cliente

A caixa **Atribuir Formulário do Cliente** associa um formulário já cadastrado à conversa atual e cria um link exclusivo para que o cliente o preencha. O link é gerado para a sessão em andamento e pode ser salvo em uma variável do fluxo.

A caixa **não envia o link sozinha** e também **não aguarda o preenchimento**. Ela prepara o formulário e segue para a próxima etapa configurada. Para completar o atendimento, normalmente são necessárias estas etapas:

1. atribuir o formulário;
2. enviar o link ao cliente por uma caixa de mensagem;
3. aguardar o envio do formulário com a caixa **Aguardar Formulário**.

Use a caixa, por exemplo, para:

- coletar dados cadastrais sem fazer várias perguntas na conversa;
- solicitar informações complementares antes de continuar o atendimento;
- enviar uma ficha de atualização de dados;
- receber uma autorização, pesquisa ou declaração do cliente;
- pré-preencher no formulário informações que já foram coletadas no fluxo.

> **Não confunda:** a caixa **Atribuir Formulário do Atendente** é destinada ao preenchimento pelo atendente durante um atendimento humano. A caixa deste guia cria um formulário que será preenchido pelo **cliente**.

## Onde encontrar

### Cadastrar ou revisar o formulário

Antes de usar a caixa, o formulário precisa existir no cadastro de formulários:

1. Acesse **Configuração > Recursos > Formulário do Cliente**.
2. Clique em **Novo formulário** ou abra um formulário existente.
3. Informe o nome do formulário.
4. Monte os campos que o cliente deverá preencher.
5. Salve o formulário.

Os nomes internos dos campos do formulário são importantes quando você quiser utilizar **Campos pré-preenchidos** ou extrair as respostas para variáveis depois. Se alterar um formulário que já está em uso, salve a alteração antes de voltar ao editor do fluxo.

### Adicionar a caixa ao fluxo

1. Acesse **Configuração > Fluxos**.
2. Crie um fluxo ou abra uma versão existente no editor.
3. Na barra de ferramentas, abra o grupo **Variáveis**.
4. Adicione a caixa **Atribuir Formulário do Cliente** ao diagrama.
5. Selecione a caixa para abrir o painel de configuração.
6. Preencha os campos e clique em **Aplicar**.
7. Salve a versão do fluxo.

## Como a caixa funciona

O comportamento esperado é:

```
Atribuir Formulário do Cliente
          │
          ├── cria o formulário para a conversa atual
          ├── gera o link e salva na variável escolhida
          └── segue para a próxima caixa
                         │
                         ▼
              Mensagem com o link
                         │
                         ▼
                Aguardar Formulário
                         │
                         ├── cliente envia → fluxo continua
                         └── cliente ainda não envia → permanece aguardando
```

Quando a caixa é executada:

1. o OmniSIGA localiza o formulário selecionado;
2. cria uma instância do formulário para a sessão atual;
3. aplica os valores de **Campos pré-preenchidos**, quando configurados;
4. gera o endereço que será aberto pelo cliente;
5. grava esse endereço na variável informada em **Variável salvar URL**;
6. encaminha o fluxo para o destino definido em **Após atribuir formulário, ir para**.

O link deve ser utilizado na mesma conversa em que foi gerado. Não copie manualmente um link de uma conversa para outra nem tente montar a URL por conta própria.

## Campos da caixa

### Nome do elemento

Identifica a caixa no diagrama. Use um nome que explique o objetivo da etapa, por exemplo:

- `Atribuir atualização cadastral`;
- `Gerar formulário de autorização`;
- `Solicitar dados para o contrato`.

Um nome descritivo facilita a manutenção do fluxo e a seleção da caixa nos campos de navegação.

### Formulário

Selecione o formulário que o cliente deverá preencher.

A lista apresenta os formulários cadastrados para a organização. É possível digitar parte do nome para localizar um formulário. Se o formulário recém-criado não aparecer:

- confirme se ele foi salvo;
- verifique se o nome digitado corresponde ao cadastro;
- feche e abra novamente o painel da caixa para atualizar a lista.

Escolha o formulário correto antes de configurar os campos pré-preenchidos. A seleção do formulário determina quais campos podem ser sugeridos nessa etapa.

### Variável salvar URL

Informe o nome da variável que receberá o link gerado para a conversa. Por exemplo:

```
linkFormulario
```

Depois, use exatamente esse mesmo nome na caixa que enviará o link:

```
Preencha o formulário para continuar: {{linkFormulario}}
```

Recomendações para esse campo:

- use um nome sem espaços e fácil de identificar;
- não reutilize a mesma variável para dois formulários diferentes na mesma sequência;
- confira a grafia do nome em todas as caixas seguintes;
- preencha este campo sempre que o cliente precisar receber o endereço do formulário.

> **Atenção:** deixar o campo vazio ou usar outro nome na mensagem impede que o link seja apresentado corretamente ao cliente.

### Campos pré-preenchidos

Permite enviar ao formulário valores que o fluxo já conhece antes de o cliente abri-lo. Cada linha possui:

- **Campo do formulário** — o nome interno do campo que será preenchido;
- **Valor ou `{{variavel}}`** — um valor fixo ou uma variável que será resolvida durante a conversa.

Exemplos:

| Campo do formulário | Valor ou variável | Resultado esperado |
| --- | --- | --- |
| `nomeCompleto` | `{{nomeCliente}}` | abre o formulário com o nome já preenchido; |
| `email` | `{{emailContato}}` | usa o e-mail coletado anteriormente; |
| `origem` | `Chatbot` | grava um valor fixo no campo; |
| `numeroProtocolo` | `{{protocolo}}` | mostra o protocolo da sessão. |

Os campos sugeridos pelo editor dependem do formulário selecionado. Use o **nome interno** do campo, e não apenas o texto do rótulo que aparece para o cliente.

O valor entre `{{ }}` precisa existir antes de a caixa ser executada. Se a variável ainda não tiver sido definida, o campo poderá ficar vazio ou não ser preenchido como esperado.

> **Privacidade:** só pré-preencha informações que o cliente possa visualizar e revisar. Evite colocar dados sensíveis no formulário sem necessidade.

### Após atribuir formulário, ir para

Escolha a caixa que será executada depois que o formulário for preparado. O destino mais comum é uma caixa **Mensagem simples** que envia o link ao cliente.

Exemplo de sequência:

```
Atribuir atualização cadastral
          │
          ▼
Enviar link do formulário
```

Se o campo ficar sem destino explícito, confira as conexões do diagrama para garantir que a conversa não fique sem continuidade.

## Configuração recomendada

### 1. Preparar o formulário

Crie o formulário com todos os campos necessários e salve-o. Para cada campo que poderá receber dados anteriores, confirme o seu nome interno no construtor do formulário.

### 2. Criar a etapa de atribuição

No fluxo:

1. adicione **Atribuir Formulário do Cliente**;
2. selecione o formulário;
3. informe uma variável para guardar o link, como `linkFormulario`;
4. configure os campos pré-preenchidos, se necessário;
5. direcione a caixa para uma etapa de mensagem;
6. clique em **Aplicar**.

### 3. Enviar o link ao cliente

Adicione uma **Mensagem simples** depois da atribuição e utilize a variável configurada:

```
Para continuar, preencha o formulário neste link: {{linkFormulario}}
```

No Webchat, também é possível transformar o link em um texto clicável:

```
Para continuar, <a href="{{linkFormulario}}" target="_blank" rel="noopener noreferrer">clique aqui</a>.
```

Em canais que não interpretam HTML, envie a variável como URL simples. Consulte também o guia [Enviar formulário do cliente com texto clicável no Webchat](/documentacao-formulario-link-clicavel-webchat.md).

### 4. Aguardar o preenchimento

Depois da mensagem, adicione **Aguardar Formulário**:

- escreva a mensagem exibida enquanto o formulário estiver pendente;
- habilite **Extrair variáveis automaticamente** se quiser usar as respostas em etapas seguintes;
- defina o próximo passo depois do envio do formulário.

O fluxo só continua depois que o cliente abre o link, preenche os campos obrigatórios e envia o formulário. A caixa **Aguardar Formulário** é a etapa responsável por retomar a conversa.

### 5. Salvar e testar

1. Salve o fluxo.
2. Publique ou ative a versão utilizada pelo canal.
3. Inicie uma nova conversa.
4. Confirme se a mensagem apresenta o link ou o texto clicável.
5. Abra o formulário e verifique os campos pré-preenchidos.
6. Envie o formulário.
7. Confirme se as respostas ficaram disponíveis e se o fluxo seguiu para a próxima etapa.

Faça o teste em uma nova sessão depois de publicar o fluxo. Uma conversa já iniciada pode estar executando uma versão anterior ou já ter passado pela etapa de atribuição.

## Exemplo completo — atualização cadastral

**Objetivo:** enviar um formulário para que o cliente revise seus dados e, depois do envio, confirmar a atualização.

### Formulário cadastrado

Nome: `Atualização cadastral`

Campos do formulário:

- `nomeCompleto`;
- `email`;
- `telefone`;
- `endereco`.

### Configuração da caixa

| Campo | Valor de exemplo |
| --- | --- |
| **Nome do elemento** | `Atribuir atualização cadastral` |
| **Formulário** | `Atualização cadastral` |
| **Variável salvar URL** | `linkFormulario` |
| **Campos pré-preenchidos** | `nomeCompleto` = `{{nomeCliente}}`; `email` = `{{emailContato}}` |
| **Após atribuir formulário, ir para** | `Enviar link da atualização` |

### Estrutura do fluxo

```
Coletar ou localizar dados do cliente
          │
          ▼
Atribuir atualização cadastral
          │
          ▼
Enviar link da atualização
          │
          ▼
Aguardar Formulário
          │
          ▼
Confirmar atualização
```

Conteúdo da caixa **Enviar link da atualização**:

```
Revise seus dados e envie o formulário para continuar: {{linkFormulario}}
```

Na caixa **Aguardar Formulário**, habilite **Extrair variáveis automaticamente** se as respostas precisarem ser usadas em uma etapa seguinte, como uma caixa **Adicionar ou atualizar contato**, uma decisão ou uma integração.

## Diferença entre as caixas relacionadas

| Caixa | Função | Quem interage |
| --- | --- | --- |
| **Atribuir Formulário do Cliente** | Cria o formulário da sessão e gera o link para acesso. | O fluxo, ao preparar o formulário. |
| **Mensagem simples** | Envia ao cliente o link gerado. | O cliente recebe a mensagem. |
| **Aguardar Formulário** | Pausa o fluxo e retoma depois do envio. | O cliente preenche e envia. |
| **Atribuir Formulário do Atendente** | Disponibiliza um formulário para uso no atendimento humano. | O atendente. |

A atribuição e a espera são etapas diferentes. Adicionar somente **Atribuir Formulário do Cliente** não faz a conversa parar até o cliente responder.

## Boas práticas

- Use nomes de variáveis claros, como `linkFormulario`, `nomeCliente` e `emailContato`.
- Mantenha o mesmo nome da variável em **Variável salvar URL** e na mensagem que apresenta o link.
- Envie o link imediatamente depois de criar o formulário, antes de aguardar a resposta.
- Use **Aguardar Formulário** logo depois da mensagem que contém o link.
- Use nomes internos de campos consistentes e sem ambiguidades para facilitar o pré-preenchimento e a extração de respostas.
- Pré-preencha somente dados necessários e revise se o cliente poderá visualizar essas informações.
- Não monte a URL manualmente nem reutilize o endereço gerado em outra conversa.
- Teste o fluxo tanto com os campos pré-preenchidos quanto com os campos deixados para o cliente informar.
- Teste o caminho de abandono ou de não envio conforme a estratégia do atendimento; enquanto o formulário não for enviado, o fluxo permanecerá na espera.

---