Elas ajudam você a capturar, armazenar e reutilizar informações dinamicamente ao longo dos fluxos do seu bot. Ao usar variáveis, você pode criar interações mais personalizadas. Por exemplo, em vez de enviar uma mensagem genérica como "Olá! Como posso te ajudar hoje?", você pode saudar o usuário pelo nome com "Olá, Mayur! Como posso te ajudar hoje?".

Tipos de Variáveis

O ReplyCX suporta três tipos de variáveis:

1. Variável de Conversa

Variáveis de Conversa são usadas para armazenar informações temporárias necessárias apenas durante a sessão de conversa atual.

Características principais

  • Específicas da sessão e disponíveis apenas durante a conversa ativa.

  • Os valores não persistem após o término da conversa.

  • Reiniciadas automaticamente quando uma nova conversa começa.

  • Ideais para armazenar seleções temporárias, respostas ou informações relacionadas ao fluxo.

  • Ajudam a manter o contexto dentro de uma única interação, sem afetar conversas futuras.

Exemplo: Imagine um bot de pedidos de pizza perguntando "Qual tamanho você gostaria?" A resposta do cliente ("Grande") só importa para aquele pedido — depois que a conversa termina, não há motivo para lembrá-la. Uma variável de conversa lida com isso perfeitamente.

2. Variáveis de Contato

Variáveis de Contato são projetadas para armazenar informações específicas do usuário que permanecem disponíveis em múltiplas conversas. São ideais para personalização e manutenção do contexto do cliente a longo prazo.

Características principais

  • Persistem em todas as conversas com o mesmo contato.

  • Armazenadas no nível do contato, e não no nível da sessão.

  • Adequadas para armazenar informações como nomes, endereços de e-mail, preferências, status de lead, entre outros.

  • Podem ser atualizadas em qualquer momento.

  • O valor salvo mais recentemente é sempre o utilizado.

  • Permitem experiências de cliente personalizadas e contextualizadas.

Exemplo: Se um usuário informar o nome "Pratik", você pode salvá-lo em uma Variável de Contato. Em conversas futuras, o bot pode saudá-lo automaticamente com: "Bem-vindo de volta, Pratik!" — sem precisar perguntar o nome novamente.

3. Variável Secreta:

Variáveis Secretas são usadas para armazenar com segurança informações sensíveis, como chaves de API, tokens de autenticação e credenciais.

Características principais

  • Os valores são criptografados e armazenados com segurança.

  • Os valores secretos nunca são exibidos em texto simples.

  • Uma vez salvo, o valor não pode ser visualizado por ninguém, incluindo administradores.

  • Os valores existentes não podem ser recuperados ou lidos, e só podem ser substituídos por um novo valor.

  • Só podem ser referenciadas dentro de blocos de Requisição HTTP e JavaScript.

Casos de uso comuns

  • Chaves de API

  • Tokens OAuth

  • Segredos de Webhook

  • Credenciais de Autenticação

  • Tokens de Serviços de Terceiros

Exemplo: Se você precisar conectar seu bot a um CRM externo ou gateway de pagamento, pode armazenar a chave de API com segurança em uma Variável Secreta, em vez de expô-la dentro do fluxo do bot.

Criando Variáveis nas Configurações de Variáveis

Para criar uma variável a partir da página de configurações de Variáveis:

  1. Navegue até Configurações > Variáveis.

  2. Clique em Criar.

  3. Insira os detalhes necessários: • Nome da Variável • Descrição • Tipo de Variável

  4. Salve a variável. Todas as variáveis criadas no seu workspace podem ser gerenciadas nesta seção.

image.png
Editando Variáveis

Vá até Configurações > Variáveis e clique em Editar ao lado da variável que deseja alterar.
Observação: apenas a descrição e o tipo de dado podem ser editados — não o nome.

image.png
Excluindo Variáveis

As variáveis não podem ser excluídas permanentemente — elas só podem ser arquivadas.
Para arquivar uma, vá até Configurações > Variáveis e clique em Arquivar ao lado da variável que deseja remover do uso ativo.

image.png
Usando uma variável

Você pode invocar uma variável digitando # para visualizar o menu suspenso de variáveis em todo o construtor de bots.

image.png

Exemplo
Se você tiver uma Variável de Contato chamada first_name, pode usá-la em uma mensagem como:
"Olá #first_name, obrigado por entrar em contato com a gente."

Adicionando valor padrão às variáveis

Você pode adicionar um valor padrão à variável, para que, caso não haja um valor presente, um valor padrão seja exibido ao usuário. Para adicionar o valor padrão, abra o canvas do construtor de bots e clique na tag da variável. Em seguida, você pode inserir o valor de fallback.

image.png
Tipos de dados nas variáveis

Você pode armazenar os seguintes tipos de dados em variáveis:

Tipo de dado

Descrição

Texto

Armazena qualquer entrada de texto.

Número

Armazena apenas dígitos numéricos de 0 a 9.

Booleano

Armazena apenas 0, 1, true, false.

Data

Armazena formatos de data como DD/MM/AAAA e MM/DD/AAAA

E-mail

Armazena endereços de e-mail.

Telefone

Armazena números de telefone.

Regex

Armazena entradas com base na sua regra de validação.

Personalizando Mensagens de Erro de Variáveis

Melhore a experiência do seu visitante substituindo o erro genérico padrão ("Inválido! Por favor, insira uma entrada válida") por uma mensagem personalizada e amigável (ex.: "Por favor, insira um e-mail corporativo válido para continuar").

Mensagens de erro personalizadas estão disponíveis para variáveis que usam formatos de validação específicos: Número, Booleano, Data, E-mail, Telefone e Regex.

Como definir uma mensagem de erro personalizada:

  1. Navegue até Configurações > Variáveis no menu à esquerda.

  2. Localize a variável que deseja modificar e clique em Editar.

  3. Digite sua resposta personalizada no campo Mensagem de Erro.

  4. Clique em Salvar para aplicar as alterações.

  5. Teste o fluxo do seu bot para confirmar que a nova mensagem de erro é exibida corretamente quando dados inválidos são inseridos.

Recuperando objetos JSON de uma variável

Se você estiver armazenando objetos JSON em variáveis e quiser se referir a um campo específico do objeto JSON, pode seguir a abordagem abaixo:

  • Crie uma variável do tipo TEXTO

  • Armazene o objeto JSON nessa variável

  • Use # seguido pelo nome da sua variável e acrescente o campo ao qual deseja se referir.

  • Pressione Enter para que o chip da variável seja criado

Por exemplo:

// Suponha que este seja o seu objeto JSON
[
  { "account_id": "A1", "user": "John" },
  { "account_id": "A2", "user": "Sara" },
  { "account_id": "A3", "user": "Mike" },
  { "account_id": "A4", "user": "Tina" }
]
// Se eu quiser me referir ao segundo objeto, ou seja, account_id=A2
#name[1].account_id#TypeScript
Variáveis de sistema oferecidas

Aqui estão as variáveis de sistema oferecidas por padrão:

Variável

Descrição

name

Nome do visitante

email

E-mail do visitante

phone

Número de telefone do visitante

ip_address

Endereço IP do visitante

city

Cidade detectada através do endereço IP do visitante

state

Estado detectado através do endereço IP do visitante

zipcode

CEP detectado através do endereço IP do visitante

country

País detectado através do endereço IP do visitante

timezone

Fuso horário do navegador do visitante

os

Sistema operacional do visitante

referrer_url

Domínio de referência do visitante.

unsubscribed_phone_numbers

Se o número de telefone está descadastrado do envio de mensagens outbound.

utm_source

Utm source

utm_medium

Utm medium

utm_campaign

Utm campaign

utm_content

Utm content

utm_term

Utm term

bot

Nome do bot com o qual o visitante interagiu.

browser_language

Idioma configurado no navegador.

browser

Nome do navegador.

channel

Nome do canal onde a conversa ocorreu.

contact_created_by

Quem criou o contato.

conversation_url

Link para a conversa.

country_code

Código ISO do país de onde a conversa se originou.

created_at

Data em que a conversa foi criada.

gcal_selected_slot_day

Dia selecionado ao agendar a reunião no Google Calendar.

gcal_selected_slot_time

Horário selecionado ao agendar a reunião no Google Calendar.

timezone

Fuso horário do dispositivo.

url

URL da página onde o usuário está interagindo com o bot.

chat_history

Inclui a transcrição da conversa até o momento.

Boas Práticas para Gerenciamento de Variáveis

Para manter seu workspace organizado e garantir que os fluxos do seu bot sejam fáceis de construir e manter, siga estas práticas essenciais ao criar variáveis:

  1. Use Nomes Descritivos: Escolha nomes claros e intuitivos que indiquem imediatamente qual dado está sendo coletado. (Por exemplo, use "userEmail" ou "orderTotal" em vez de nomes vagos como "var1" ou "data".)

  2. Mantenha Convenções de Nomenclatura: Siga um formato consistente para todos os nomes das suas variáveis. Isso facilita a busca, identificação e gerenciamento, especialmente ao colaborar com uma equipe.

  3. Adicione Descrições Claras: Aproveite o campo de descrição para documentar exatamente para que a variável é usada e seu papel específico no fluxo de trabalho do seu bot.

  4. Revise e Refine Regularmente: À medida que seu bot cresce e evolui, audite periodicamente sua lista de variáveis. Remova variáveis não utilizadas e garanta que as existentes ainda atendam corretamente ao propósito pretendido.

Was this helpful?