Variáveis

Config. Variáveis

Disponível para o perfil: Administrador

As Variáveis permitem inserir informações dinâmicas em mensagens, chatbots e automações sem precisar digitar manualmente a cada vez. O sistema oferece variáveis nativas da plataforma, variáveis específicas para integração com Typebot e a possibilidade de criar variáveis personalizadas para o seu negócio.

Como acessar

Acesse Configurações → CRM → Variáveis.

Você verá a seguinte tela

A tela é dividida em três áreas:

• Variáveis personalizadas (parte superior) — onde você cria e gerencia suas próprias variáveis

• Variáveis da Plataforma (painel inferior esquerdo) — variáveis nativas do sistema, somente leitura

• Variáveis do Typebot (painel inferior direito) — variáveis disponíveis para uso nos fluxos do Typebot

---

Variáveis da Plataforma

Variáveis nativas do sistema, preenchidas automaticamente com dados do contato ou do atendimento. Disponíveis para uso em mensagens rápidas, chatbots e automações.

Variável	O que insere
{{name}}	Nome do contato
{{greeting}}	Saudação dinâmica conforme o horário (Bom dia, Boa tarde...)
{{protocol}}	Número de protocolo do atendimento
{{email}}	E-mail do contato (se cadastrado)
{{phoneNumber}}	Telefone do contato
{{kanban}}	Kanban vinculado (se existir)
{{user}}	Nome do atendente responsável
{{userEmail}}	E-mail do atendente responsável
{{firstName}}	Primeiro nome do contato
{{lastName}}	Sobrenome do contato
{{businessName}}	Empresa do contato

---

Variáveis do Typebot

Variáveis utilizadas para passar informações do Z-PRO para os fluxos do Typebot no momento da integração.

Variável	O que insere
{{nome}}	Nome do contato
{{numero}}	Telefone do contato
{{atendimento}}	Número do ticket
{{email}}	E-mail do contato (se existir)
{{status}}	Status do ticket
{{canal}}	Canal pelo qual a mensagem chegou
{{grupo}}	Indica se o atendimento é em grupo
{{fullTicket}}	Todas as propriedades do atendimento

---

Variáveis Personalizadas

Crie suas próprias variáveis para reutilizar textos fixos em mensagens e automações — como o nome da sua empresa, um link de agendamento ou qualquer informação que se repete com frequência.

Como criar uma variável personalizada

1. Clique em + Nova Variável

2. Preencha a Chave — use apenas letras, números e underscore (ex: nome_empresa). A variável será usada como {{nome_empresa}}

3. Preencha o Valor — o texto que será substituído ao usar a variável (ex: Acme Corp)

4. Adicione uma Descrição opcional para identificar o uso da variável

5. Clique em Salvar

Boas práticas

• Use chaves descritivas e padronizadas para facilitar a identificação (ex: link_agendamento, telefone_suporte)

• Variáveis personalizadas têm menor prioridade — se o contato tiver um dado real cadastrado no sistema, ele sobrescreve a variável

• Para pausar o uso de uma variável sem excluí-la, desative-a pela opção de edição