# Definir Variável **Definir variável**: Cria ou atualiza uma variável no fluxo.  No Flowbuilder, o bloco "Definir Variável" permite que você crie ou atualize variáveis dentro do seu fluxo de automação. Isso é útil para armazenar informações temporárias, personalizar a interação com o usuário ou controlar o fluxo com base em dados dinâmicos.  ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/da620569-2861-4ee9-be7a-ce37f317a1fa/0d3a00a2-bdcb-4b94-aa90-58bfc9a66888/ENQUREROKYo0REROKYo0REROKYo0REROKYo0REROKYo0REROKYo0REROKYo0REROKYo0REROKYo0REROKYo0REROKYo0REROKYo0REROKYo0RERKIUiv8HT3hgFq0HevAAAAAASUVORK5CYII%3D?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=0139545dd9934b38849329eede0ec3ab252249e87fcea7a1b52646423bf3ceeb&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =621x854")  Como Funciona   O que é:   Definir Variável é uma ação que permite definir ou atualizar o valor de uma variável específica dentro do seu fluxo de trabalho.   Quando Usar:   Para armazenar respostas do usuário que serão usadas mais tarde no fluxo.   Para personalizar mensagens ou ações com base em informações específicas.   Para controlar o comportamento do fluxo com base em condições ou estados definidos por variáveis.   Como Configurar:   Localizar o Bloco:   No Flowbuilder, procure pelo bloco chamado "Definir Variável" ou algo similar. Adicionar ao Fluxo: Arraste e solte o bloco "Definir Variável" no ponto do seu fluxo onde você deseja definir ou atualizar uma variável. Configurações do Bloco:  1. **Título do Bloco:** Dê um nome ao bloco para facilitar a identificação dentro do seu fluxo, como "Definir variável".  2. **Variável à ser definida:** Aqui você escolhe ou cria a variável que deseja definir. No exemplo, há uma interface de seleção onde você pode buscar ou selecionar a variável.  3. **Valor definido:** Insira o valor que você quer atribuir à variável. No exemplo, o valor é "Atendente", mas você pode deixar em branco se quiser manter o valor atual da variável. Há também uma lista de sugestões (**datalist-variable-value**) com opções como "Cliente" e "Atendente".  4. **Ação na Variável?** Esta opção permite escolher se você quer realizar alguma ação adicional sobre a variável, como concatenar, incrementar, etc. No exemplo, a opção está definida como "Nenhuma...", indicando que nenhuma ação adicional será realizada além da definição do valor.  * **Substituir Valor** * **O que faz:** Procura um trecho no valor atual da variável usando uma **Expressão Regular (RegEx)** e o substitui por um novo texto. * **Campos Principais:** * `Expressão Regular`: Informe o padrão de RegEx que identifica o texto a ser substituído. * `Substituir por`: Informe o novo texto que substituirá as ocorrências encontradas pela `Expressão Regular`. Para remover o texto encontrado, deixe este campo vazio. * **Recursos Auxiliares :** * Botões de atalho como "Remover espaços em branco", "Remover dígitos numéricos", "Deixar apenas dígitos numéricos", etc., podem estar disponíveis. Eles geralmente preenchem o campo `Expressão Regular` com padrões comuns e podem ajustar o campo `Substituir por` (ex: vazio para remoções). * **Interface de Teste :** * `Valor para testes`: Campo para inserir um texto de exemplo. * `Resultado`: Mostra como o texto ficaria após a aplicação da RegEx e da substituição. * *Exemplo (Remover hífens de um código):* * Variável: `codigo_antigo` (valor atual: "XYZ-123-ABC") * Expressão Regular: `-` * Substituir por: (campo deixado vazio) * *Resultado:* A variável `codigo_antigo` se tornará "XYZ123ABC". * **Extrair Valor** * **O que faz:** Permite retirar (extrair) uma porção específica do valor de uma variável usando uma **Expressão Regular (RegEx)**. O valor extraído, que corresponde ao texto capturado por um grupo de captura na RegEx (geralmente o primeiro), substitui o valor original da variável ou é salvo nela. * **Campo Principal:** * `Expressão Regular`: Informe o padrão de RegEx que define qual parte do texto da variável deve ser extraída. Utilize parênteses `()` no padrão para criar o grupo de captura desejado. * **Recursos Auxiliares:** * Botões de atalho como "Extrair CPF", "Extrair CNPJ", "Extrair e-mail", "Extrair data", etc., podem estar disponíveis para preencher o campo `Expressão Regular` com padrões de captura comuns. * **Interface de Teste:** * `Valor para testes`: Campo para inserir um texto de exemplo. * `Resultado`: Mostra o valor que seria extraído com base na RegEx e no valor de teste. * *Exemplo (Extrair o número de um CPF em uma frase):* * Variável: `dados_usuario` (valor atual: "O CPF do cliente é 123.456.789-00 e ele mora em SP.") * Expressão Regular: `(\d{3}\.\d{3}\.\d{3}-\d{2})` (O padrão de CPF está dentro de parênteses, formando um grupo de captura) * *Resultado (na variável* `*dados_usuario*` *ou em uma nova):* `123.456.789-00` * **Somar valor** * **O que faz:** Adiciona um valor numérico ao valor atual da variável. A variável deve conter um número. * **Campo Adicional:** * `Qual o valor para a operação`: Informe o número que você deseja somar ao valor atual da variável. * *Exemplo:* * Variável: `pontos_fidelidade` (valor atual: `250`) * Qual o valor para a operação: `50` * *Resultado:* A variável `pontos_fidelidade` se tornará `300`. * **Subtrair valor** * **O que faz:** Subtrai um valor numérico do valor atual da variável. A variável deve conter um número. * **Campo Adicional:** * `Qual o valor para a operação`: Informe o número que você deseja subtrair do valor atual da variável. * *Exemplo:* * Variável: `quantidade_estoque` (valor atual: `100`) * Qual o valor para a operação: `10` * *Resultado:* A variável `quantidade_estoque` se tornará `90`. **Salvar:** Após configurar, clique em **Salvar** para aplicar as mudanças. Se precisar cancelar, há um botão de **Cancelar** disponível.  **Teste de RegEx** Para garantir que a sua RegEx irá extrair o valor desejado corretamente, utilize a ferramenta de testes integrada. Ao usar a ação **"Substituir Valor” ou “Extrair Valor"**, clique no ícone indicado pela seta para abrir a janela de validação. ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/da620569-2861-4ee9-be7a-ce37f317a1fa/f2ea0f08-6dbc-4314-9f9a-9986dbf42513/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=7ba411a2e46844001a552ae56b59f04a8466156aedacb8413b0742f32a601fee&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =613x530") 1. Na tela **"Extrair Valores"**, você pode: * Digitar sua própria expressão regular. * Usar atalhos para padrões comuns, como **CPF, CNPJ, CEP e e-mail**. * Inserir um texto no campo **"Valor para testes"**. * Conferir o **"Resultado"** da extração imediatamente. 2. Essa verificação permite ajustar e confirmar o comportamento da sua RegEx de forma rápida e precisa. ![](https://s3.us-east-2.amazonaws.com/convert-company-outline/uploads/da620569-2861-4ee9-be7a-ce37f317a1fa/d45e0ae6-1027-40bd-9a99-93e935bda2de/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAWNEQDAE74GWO55AJ%2F20260922%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20260922T151500Z&X-Amz-Expires=86400&X-Amz-Signature=14b74f3b284b28260c2ad9ff8aa379a26e591c382af931b76a1fc5504c4e2bc4&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =493x533") --- **Documents** - [Manuais de produtos](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/manuais-de-produtos-9Zwzl1ufq8) - [Treinamentos em vídeo](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/treinamentos-em-video-RtQVBvFmgW) - [Versões de produtos](https://docs.convert.app.br/s/7287dde1-b04f-4cad-9d2b-72f5c721e7d1/doc/versoes-de-produtos-TH4Y8GFXxO)