--- title: "Coletar dados" slug: "coletar-dados" updated: 2024-01-12T13:45:46Z published: 2024-01-12T13:45:46Z canonical: "docs.omnisiga.ai/coletar-dados" --- > ## 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. # Coletar dados A caixa Coletar dados como já diz o nome é utilizada para armazenar algum dado a partir de uma resposta do cliente pelo chat. Esse dado pode ser re-utilizado durante o atendimento de várias formas de acordo com o tipo de dado coletado como por exemplo: - coletar o nome do cliente e identificá-lo - efetuar cadastros com dados mais relevantes (endereço, telefone, email) - efetuar consultas à sistemas integrados ![coletadatos.PNG](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/coletadatos%281%29.PNG) ## Nome e Variável Ao inserir uma nova caixa de coleta de dados será exibida a janela de cadastro onde iremos efetuar a configuração. Após definir um nome para a caixa é necessário também escolher um nome para a criação de uma **variável** onde iremos armazenar o dado coletado. Para o nome da caixa o ideal é definir um nome que deixe bem claro o que será efetuado neste passo do fluxo. Já para o nome da variável é sugerido criar nomes mais simples e intuitívo o uso deste dado ao longo do restante da configuração do fluxo. No exemplo a seguir iremos criar uma caixa de Coletar Dados chamada "Coleta Nome" e o nome da variável será "nome". ![coletanome.PNG](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/coletanome%281%29.PNG) A caixa de Coletar Dados também conta com um campo para mensagens de texto. Neste campo é indicado inserir um texto onde fique bem claro qual é o dado solicitado ao cliente. No exemplo acima estamos solicitando que o cliente digite o seu nome. Quando o cliente enviar a mensagem este dado será coletado e armazenado na variável chamada **nome** que estamos cadastrando. Da mesma forma que a caixa de [Mensagem Simples](/v1/docs/mensagem-simples-1), podem ser enviadas uma ou mais mensagens de texto. ## Validação A configuração de validação é utilizada para conferir se o dado inserido pelo cliente no chat é o tipo de dado que está sendo solicitado. Por exemplo na configuração de coleta de dados em que solicitamos o nome, será feita a validação do dado utilizando a opção **Validar texto**. Ao selecionar o tipo de dado, são exibidas mais opções para complementar a validação. Nesta configuração iremos utilizar as opções **Campo não vazio**, **Tamanho máximo(30)** e **Tamanho mínimo(3)**. O que significa que para escrever o nome estamos esperando que o cliente não envie uma mensagem vazia e que o seu nome tenha entre 3 e 30 caracteres na mensagem. ![validatexto.PNG](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/validatexto.PNG) ## Navegação + validação Quando se configura algum tipo de validação para uma informação inserida no chat são esperados somente 2 resultados diante do dado inserido: **Sucesso** ou **Erro**. **Sucesso**: O dado enviado pelo cliente no chat passou na validação. **Erro**: O dado enviado pelo cliente no chat não passou na validação. Com isso em mente é necessário efetuar a parte de navegação após validar o dado onde iremos efetuar a navegação do cliente para uma próxima etapa do fluxo em caso de Sucesso ou enviar o cliente para uma outra etapa do fluxo (ou até mesmo repetir a mesma etapa) em caso de falha na validação. Ex.: ![navegavalida.PNG](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/navegavalida.PNG) Em nosso exemplo caso a validação retorne um Erro (mensagem vazia, menos de 3 ou mais de 30 caracteres) o cliente é enviado novamente para a caixa de "Coleta Nome". Com isso a mensagem será novamente exibida para que seja inserido novamente o dado. E finalmente caso a validação retorne como Sucesso, o cliente é enviado para a caixa de "Opções" para dar prosseguimento no atendimento. ![validaconfexemplo.gif](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/validaconfexemplo.gif) ## Exibir os dados Após efetuar a coleta de um dado é possível utilizá-lo durante todo o restante do fluxo de atendimento. Para isso é necessário utilizar a variável onde o dado foi armazenado. No exemplo abaixo vamos utilizar a variável **nome** na mensagem de texto que é exibida durante a seleção das opções disponíveis. ![usavariavel.PNG](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/usavariavel.PNG) Com esta configuração após o cliente informar o seu nome e navegar para a caixa "Opções" será exibido o nome coletado e logo abaixo as opções disponíveis para prosseguir no atendimento. ![exemplonomechat.gif](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/exemplonomechat.gif)