Como podemos ajudar?

Como criar variáveis em um chatbot
4 min
Criado por Maria Malheiro em 06/02/2024 08:51
Atualizado por Maria Malheiro em 26/02/2026 14:39
Importante: Antes de seguir com as instruções, confirme se a funcionalidade está disponível para o seu perfil de acesso.

As variáveis permitem armazenar e reutilizar informações ao longo da conversa no fluxo do chatbot. Com elas, é possível personalizar mensagens, guardar respostas de usuários, controlar etapas e muito mais. Existem dois tipos de variáveis: Contato e Contexto, veja a seguir cada uma delas. 

Variáveis de Contato 

Variáveis do contato armazenam informações durante uma conversa, dividindo-se em básicas, que são fixas e pré-existentes, e adicionais, que podem ser criadas para dados específicos do contexto ou identificação do contato. Ambas podem ter seus valores exibidos em mensagens e condições nos blocos através do atributo Identificador. Os valores preenchidos durante as conversas estarão disponíveis nos detalhes da conversa. Veja a seguir:

1. Variáveis Básicas

As variáveis básicas são informações comuns que todos os chatbots costumam pedir, como nome, e-mail, CPF, data de nascimento etc. Cada uma dessas variáveis tem um código específico para ser usado nas mensagens.

Veja abaixo os exemplos de variáveis básicas e seus códigos:

  • CEP: <?$cep?>

  • CPF: <?$cpf?>

  • Nome: <?$name?>

  • E-mail: <?$email?>

  • Gênero: <?$gender?>

  • Telefone: <?$phone?>

  • Data de Nascimento: <?$birth_date?>

Sempre que precisar usar uma dessas variáveis em uma mensagem, é só colocar o código correspondente, como <?$name?> para o nome do usuário. Pronto! Após incluir um desses códigos, a variável básica terá sido incluída. 


2. Variáveis Adicionais

As variáveis adicionais são personalizadas e você pode criá-las conforme a necessidade do chatbot. Por exemplo, se você quiser capturar uma informação específica, como a preferência do usuário, pode criar uma nova variável.

Como criar uma variável adicional

  1. Vá em Configurações no menu inferior do Construtor do seu chatbot.

  2. Clique na aba Variáveis.

  3. Escolha a opção Criar variável adicional.

  4. Dê um nome que explique bem o que essa variável vai armazenar.

  5. Defina o Identificador (código da variável).

  6. Por fim, clique em Salvar. Pronto! Variável adicional criada. 

Variáveis de Contexto 

As Variáveis de Contexto são utilizadas para controlar o fluxo da conversa e armazenar informações temporárias do sistema, sem impactar nos dados do contato.

Características principais

  • Não populam a ficha de contato do cliente.

  • Ficam disponíveis somente no contexto da conversa.

  • Podem ser visualizadas no bloco de contexto, dentro da área de detalhes da conversa.

Como criar uma Variável de Contexto

Ao selecionar a opção Variável de Contexto, preencha os seguintes campos:

1. Identificador

Informe o identificador da variável.

⚠️ Regras importantes:

  • Aceita apenas:

    • Letras

    • Números

    • _ (underline)

  • Não permite:

    • Espaços

    • Caracteres especiais

Preenchimento padrão
O campo já vem preenchido, por padrão, com a sintaxe utilizada no processo de variáveis de contexto: <? #name ?>

2. Tipo de valor

Selecione uma das opções:

  • Entrada do usuário.

  • Outro valor.

Essa definição determina como o valor da variável será preenchido durante a execução do fluxo. Pronto! Variável de contexto criada! 

Importante: Lembre-se sempre de publicar o seu chatbot após finalizar as configurações para que ele esteja ativo e acessível aos usuários. Sem a publicação, ele não estará disponível para interação. Caso você siga as instruções deste artigo e continue com dificuldades ou tenha questões relacionadas ao Zenvia Customer Cloud, entre em contato diretamente com nosso time de Suporte. Consulte o passo a passo no artigo: Como falar com o suporte técnico da Zenvia.