Variáveis e contexto

Variáveis guardam informação durante a conversa. Você define algumas, outras vêm do sistema.

Como definir uma variável

Três formas:

1. Pelo bloco "Definir variável"

Arraste, escolha o nome (ex.: cidade) e o valor (constante ou outra variável).

2. Como saída de um bloco de entrada

Todo bloco que pede algo ao cliente (Texto, Número, Botões, etc.) tem um campo Salvar resposta em. Coloque o nome da variável.

3. Como saída de um Webhook

No bloco Webhook, depois de configurar a URL, tem uma seção Variables onde você mapeia campos da resposta JSON para variáveis. Exemplo: data.user.name → nome_cliente.

Como usar uma variável

Em qualquer campo de texto: {{nome_da_variavel}}. Exemplos:

Olá {{nome}}, sua nota é {{score}}/10.

Em condições, use o nome direto (sem {{}}):

idade >= 18
status == "ativo"
score > 5 && cidade == "São Paulo"

Variáveis embutidas

Você pode ler dados do contato e da conversa sem definir nada:

Variável	Conteúdo
{{contact.name}}	Nome do contato
{{contact.email}}	E-mail
{{contact.phone_number}}	Telefone
{{contact.id}}	ID interno do contato
{{conversation.id}}	ID da conversa atual
{{conversation.inbox.name}}	Nome da inbox
{{conversation.assignee.name}}	Nome do atendente atribuído (se houver)
{{account.name}}	Nome da sua conta Cosmobots
{{now}}	Timestamp atual (ISO 8601)
{{today}}	Data atual (YYYY-MM-DD)

Escopo

• Sessão — toda variável vive enquanto a conversa está ativa no bot.
• Persistência — quando o bot encerra (End session), as variáveis somem. Para guardar de verdade, escreva em atributos do contato com o bloco "Atualizar contato" ou via Webhook.

Atributos do contato (persistente)

Diferente de variáveis de sessão, atributos ficam no contato para sempre. Use o bloco Atualizar contato para escrever, e leia em fluxos futuros via {{contact.custom_attributes.nome_do_atributo}}.

Defina atributos customizados em Configurações → Atributos personalizados.

Boas práticas

• Nomes descritivos — email_cliente, não e1.
• snake_case — sem espaços nem acentos: data_nascimento, não Data Nascimento.
• Limpe ao final — em fluxos longos, use "Definir variável" para limpar campos sensíveis (senhas, CPF) antes de encerrar.