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:

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.

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

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

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.