---
title: "Variáveis disponíveis em ações"
description: "Entenda como funciona as variáveis disponíveis nas ações de playbooks."
url: https://ajuda.customerx.com.br/pt-br/articles/167-variaveis-disponiveis-em-acoes
collection: "Playbooks"
updated: 2026-10-28
language: pt-br
---

# Variáveis disponíveis em ações

Entenda como funciona as variáveis disponíveis nas ações de playbooks.

## O que são variáveis em Playbooks?

Variáveis são campos dinâmicos que você pode inserir em e-mails e notificações dos seus playbooks. Elas são automaticamente preenchidas com informações reais dos seus clientes, contatos, contratos e tickets quando o playbook é executado.

**Exemplo prático:** Ao invés de escrever "Olá", você pode usar a variável `{{Primeiro nome}}` e o sistema enviará automaticamente "Olá, João" para João, "Olá, Maria" para Maria, e assim por diante.

* * *

## Onde posso usar variáveis?

Você pode usar variáveis nas seguintes ações de playbook:

-   ✉ Enviar e-mail
    
-   ✉ Enviar e-mail para contato externo
    
-   ✉ Enviar e-mail para o tipo de contato
    
-   ✉ Enviar e-mail para contatos adicionais
    
-   ✉ Enviar e-mail para o CSM
    
-   🔔 Criar notificação para o CSM
    

* * *

## Variáveis Disponíveis para Todos os Gatilhos

Estas variáveis funcionam com qualquer gatilho que você selecionar:

### 📋 Dados do Cliente

-   External Id
    
-   Razão social
    
-   Nome Fantasia
    
-   CPF/CNPJ
    
-   Inscrição RG
    
-   Data de cadastro
    
-   E-mail corporativo
    
-   Telefones
    
-   Tags do cliente
    
-   Link para Cliente
    
-   URL do Cliente
    

### 🏢 Agrupadores do Cliente

-   Grupo
    
-   Segmento
    
-   Serviço
    
-   Carteira
    

### 📍 Endereço

-   Endereço completo
    
-   Rua
    
-   Número
    
-   Bairro
    
-   Complemento
    
-   CEP
    
-   Cidade
    
-   Estado
    
-   País
    

### 🌐 Redes Sociais

-   Facebook
    
-   Instagram
    
-   Twitter
    
-   Site
    
-   YouTube
    
-   LinkedIn
    

### 👤 Dados do Contato

-   External Id
    
-   Primeiro nome
    
-   Nome completo
    
-   E-mail
    
-   Telefones
    
-   Cargo
    
-   Data de Nascimento
    
-   Tipo
    
-   Observações
    
-   Link para Contato
    
-   URL do contato
    

### 📊 Pesquisas de Satisfação

**NPS:**

-   Última nota de NPS
    
-   Comentário da última nota
    
-   NPS Score do cliente
    

**CSAT:**

-   Última nota de CSAT
    
-   Última pergunta respondida
    
-   Comentário da última nota
    
-   Média CSAT do cliente
    

### 👥 Responsável do Cliente

-   Nome do responsável
    
-   E-mail do responsável
    
-   Assinatura de e-mail
    
-   Tipo de responsável
    

### ⚙ Campos Personalizados

-   Todos os atributos personalizados do cliente
    
-   Todos os atributos personalizados do contato
    

* * *

## Variáveis Específicas por Gatilho

Algumas variáveis só funcionam com gatilhos específicos. O sistema avisará automaticamente se você estiver usando uma variável incompatível.

### 📄 Variáveis de Contrato

⚠ **Funcionam apenas com:**

-   Novo contrato de cliente
    
-   Renovação de contrato do cliente
    
-   Cancelamento de contrato do cliente
    

**Informações disponíveis:**

-   Código e descrição do contrato
    
-   Nome do vendedor
    
-   Plano contratado
    
-   Quantidade de usuários
    
-   Valor por usuário
    
-   Datas (venda, início, fim)
    
-   Valores (implementação, mensal)
    
-   Data da cobrança
    
-   Data e motivo do cancelamento
    
-   Jornadas associadas
    

* * *

### 📝 Variáveis de Aditivo de Contrato (APENAS DO ADITIVO VIGENTE)

⚠ **Funcionam apenas com:**

-   Novo contrato de cliente
    
-   Renovação de contrato do cliente
    
-   Cancelamento de contrato do cliente
    

**Informações disponíveis:**

-   Código e descrição
    
-   Tipo do aditivo (Upsell, Downsell, Reajuste)
    
-   Detalhes do novo plano
    
-   Valores do aditivo
    
-   Novo valor do contrato
    
-   Datas relevantes
    
-   Observações
    

* * *

### 🎫 Variáveis de Ticket

⚠ **Funcionam apenas com:**

-   Novo ticket
    
-   Status do ticket alterado
    
-   Nova avaliação no ticket
    

**Informações disponíveis:**

-   Código e número do ticket
    
-   Link externo
    
-   Título e descrição
    
-   Tipo do ticket
    
-   Dados do contato e atendente
    
-   Datas de abertura e finalização
    
-   Origem e status
    
-   Avaliação
    
-   Tags do ticket
    

* * *

### ✅ Variáveis de Tarefa da Jornada

⚠ **Funcionam apenas com:**

-   Conclusão de tarefa na jornada
    
-   Conclusão de tarefa na jornada com critérios
    

**Informações disponíveis:**

-   Título e descrição da tarefa
    
-   Link e ID da tarefa
    
-   Etiquetas
    
-   Informações da lista
    
-   Código da jornada (cliente e modelo)
    
-   Status e percentual de conclusão
    
-   Datas (início, fim, conclusão)
    
-   Comentários (primeiro e último)
    
-   Dados dos checklists
    
-   Dados do responsável, relator e contatos
    

* * *

### 📌 Variáveis de Tarefa do Board do CSM

⚠ **Funciona apenas com:**

-   Conclusão de tarefa no board do CSM com critérios
    

**Informações disponíveis:**

-   Título e descrição da tarefa
    
-   Link e ID da tarefa
    
-   Etiquetas
    
-   Informações da lista
    
-   Datas (início, fim, conclusão)
    
-   Comentários (primeiro e último)
    
-   Dados dos checklists
    
-   Dados do responsável, relator e contatos
    

* * *

## Como o Sistema me Ajuda?

### ✅ Validação Automática

Quando você adiciona variáveis em um e-mail, o sistema verifica automaticamente se elas são compatíveis com o gatilho selecionado.

**Se houver incompatibilidade, você verá um aviso amarelo indicando:**

-   Quais variáveis não funcionarão
    
-   Qual gatilho você precisa usar para essas variáveis
    

### ℹ Ícones Informativos

Ao lado de cada grupo de variáveis específicas, você encontrará um ícone (ℹ) que mostra quais gatilhos são compatíveis com aquelas variáveis.

* * *

## Dicas de Uso

### ✨ Personalize suas Mensagens

Use variáveis de contato para tornar seus e-mails mais pessoais e próximos.

**Exemplo:**

```javascript
Olá {{Primeiro nome}},

Notamos que sua empresa {{Nome Fantasia}} está com um ticket em aberto. 
Podemos ajudar?

Atenciosamente,
{{Nome do responsável}}
```

### 🎯 Seja Específico em Momentos Críticos

Use variáveis de contrato em comunicações sobre renovação ou cancelamento.

**Exemplo:**

```javascript
Olá {{Nome completo}},

Seu contrato {{Código}} com vencimento em {{Data final}} está próximo da renovação.
Valor mensal atual: {{Valor mensal do contrato}}
```

### 📊 Acompanhe a Satisfação

Use variáveis de NPS e CSAT para responder feedback.

**Exemplo:**

```javascript
Olá {{Primeiro nome}},

Agradecemos sua avaliação de {{Última nota de CSAT}}!
Seu comentário: "{{Comentário da última nota de CSAT}}"
```

* * *

## Perguntas Frequentes

**❓ Posso usar qualquer variável em qualquer playbook?** Não. Variáveis gerais (dados do cliente, contato, endereço) funcionam em qualquer gatilho. Variáveis específicas (contrato, ticket, tarefas) só funcionam com gatilhos relacionados. O sistema avisará se houver incompatibilidade.

❓ **O que acontece se eu usar uma variável incompatível?** O sistema mostrará um aviso amarelo indicando quais variáveis não funcionarão. Você pode salvar o playbook mesmo assim, mas essas variáveis não serão preenchidas corretamente quando executadas.

❓ **Como sei quais gatilhos são compatíveis com cada variável?** Clique no ícone (ℹ) ao lado do grupo de variáveis para ver a lista de gatilhos compatíveis.

❓ **Posso usar múltiplas variáveis no mesmo e-mail?** Sim! Você pode combinar quantas variáveis precisar, desde que sejam compatíveis com o gatilho selecionado.

* * *

## Precisa de Ajuda?

Se tiver dúvidas sobre quais variáveis usar no seu caso específico ou encontrar algum problema, entre em contato com nosso suporte através do chat ou e-mail.
