As variáveis do CXM de Atendimento são elementos pré-configurados do sistema que funcionam como "campos dinâmicos". Ao inseri-las em mensagens, templates ou fluxos de bot, elas são automaticamente substituídas pelas informações reais que representam.

Por exemplo, ao usar a variável @cliente->nome em uma mensagem pronta, o sistema troca a variável pelo nome do cliente cadastrado, personalizando a comunicação de forma automática.

Além disso, as variáveis podem ser utilizadas em ações do bot, permitindo executar tarefas específicas ou direcionar o atendimento com base no valor de determinada informação, como por exemplo identificar um cliente, acionar uma regra ou tratar uma situação de forma personalizada.

As variáveis  nativas do CXM de atendimento estão agrupadas por categorias:

Neste artigo iremos utilizar como exemplo o uso das variáveis em um template de conversação, porém as variáveis poderão ser utilizadas em diversas outras funcionalidades do sistema como mensagens prontas, campanhas, mailing, pesquisas, dentre outros. 


VÍDEO TUTORIAL


TÓPICOS DO ARTIGO

  1. Exemplo de uso de variáveis em templates de conversação
  2. Variáveis disponíveis

EXEMPLO DE USO DAS VARIÁVEIS EM TEMPLATES DE CONVERSAÇÃO

1. Ao adicionar um template de conversação novo, localize a opção "Ver variáveis de sistema", ao editar o conteúdo do template.

Nela, é possível visualizar a lista com todas as variáveis disponíveis para uso, conforme abaixo.

2. Para este exemplo, iremos construir um template de e-mail contendo algumas variáveis, conforme abaixo:

Dica: ao acessar a listagem de variáveis, clique em "Copiar" ao lado da variáveis que deseja utilizar.

Desta forma, ao utilizar uma variável, a mesma será substituída por:

@saudacao_tempoBom dia/Boa tarde/Boa noite
@cliente->nomeNome do cliente
@protocoloNúmero do protocolo de atendimento
@posicao_fila_geralPosição do cliente na fila geral
@tempo_filaTempo médio de espera do cliente na fila


Ao enviar o template, as variáveis serão substituídas pelas informações que representam, e a mensagem recebida pelo cliente será assim:

3. Já no BOT as ações que permite a utilização de variáveis serão sinalizadas com a mensagem "Ver variáveis do sistema".

Na mensagem do menu usamos a variável @cliente>primeiro_nome para formar uma mensagem personalizada.

Dica: para saber mais sobre os conceitos de BOT no CXM de Atendimento acesse este artigo.


VARIÁVEIS DISPONÍVEIS

Os tipos de variáveis disponíveis estão listadas abaixo, separados por grupos:

VARIÁVEIS GLOBAIS

Reúnem informações básicas do atendimento em andamento, como número do protocolo, saudações, posição na fila de atendimento etc. Servem para identificar e contextualizar a interação.

Nº Protocolo - variável: @protocolo  
Bom dia/tarde/noite - variável: @saudacao_tempo
Data atual no formato DD/MM/AAAA - variável: @hoje
Data/hora atual no formato DD/MM/AAAA HH:MM:SS - variável: @agora
Posição na fila de espera geral - variável: @posicao_fila_geral
Posição na fila de espera na mesma fila de atendimento - variável: @posicao_fila
Tempo médio de espera - variável: @tempo_fila
Primeira mensagem recebida - variável: @primeira_mensagem
Última mensagem recebida - variável: @ultima_mensagem
Identificador da API multibase - variável: @base_api
Score do atendimento - variável: @bot_score

VARIÁVEIS DE AGENTE


Referem-se ao atendente responsável pela conversa. É úteis para personalizar mensagens, assinar comunicações ou encaminhar o atendimento do bot a um agente específico.

Nome do agente - variável @agente->nome


VARIÁVEIS DE FILIAL

Contêm informações da unidade ou filial associada ao atendimento, como endereço, nome da empresa ou telefone da sede. Facilitam mensagens mais direcionadas em empresas com várias unidades.

Bairro - variável:  @filial->bairro
CEP - variável:  @filial->codigo_postal
Cidade - variável:  @filial->cidade
CNPJ - variável:  @filial->numero_documento
Complemento - variável:  @filial->complemento
Endereço - variável:  @filial->endereço
Nome do estado - variável: @filial->uf->descrição
Nome fantasia - variável: @filial->nome_fantasia
País - variável:  @filial->pais->descrição
Razão social - variável:  @filial->razao_social
Sigla do estado - variável:  @filial->uf->sigla


VARIÁVEIS DE CAMPANHA

Agrupam informações sobre campanhas vinculadas ao atendimento, como assunto da campanha ou canal de envio. 

Assunto do e-mail - variável: @campanha->assunto
Canal de envio - variável: @campanha->canal->descrição
Endereço de e-mail - variável: @campanha->caixa_email->endereço
Nome da fila - variável: @campanha->fila->descrição_completa
Nome do mailing - variável: @campanha->mailing->descrição


VARIÁVEIS DE CLIENTE

Incluem dados cadastrais e de perfil do cliente (nome, e-mail, telefone, CPF/CNPJ, etc.). São usados para personalizar mensagens e garantir uma comunicação direta e relevante.

Código externo - variável: @cliente->codigo_externo
DDD Whatsapp principal - variável: @cliente->whatsappPrincipal->ddd
DDI Whatsapp principal - variável: @cliente->whatsappPrincipal->ddi
E-mail principal - variável: @cliente->emailPrincipal->email
ID do cliente - variável: @cliente->id
Nome completo - variável: @cliente->nome
Número do documento - variável: @cliente->numero_documento
Número SMS principal - variável: @cliente->smsPrincipal->numero
Número Whatsapp principal - variável: @cliente->whatsappPrincipal->numero
Primeiro nome - variável: @cliente->primeiro_nome

VARIÁVEIS DE FILA

Relacionam-se à fila em que o cliente está sendo atendido (ex.: Comercial, Suporte, Financeiro). Permitem identificar rapidamente o setor responsável e ajustar mensagens automáticas conforme o contexto.

Nome da carteira - variável: @fila->carteira->descrição
Nome da fila - variável: @fila->descrição_completa
Nome do produto - variável: @fila->carteira->produto->descrição


VARIÁVEIS DE CAMPOS CUSTOMIZADOS DO CLIENTE

Os campos customizados são nomeados de acordo com o nome dado ao campo, por isso variam. Assim, os campos sempre serão vinculados ao cadastro do cliente e terão a estrutura @cliente->nome_do_campo.

Por exemplo, se o seu campo customizado se chamar "Perfil do instagram", a variáveis deste campo será @cliente->perfil_do_instagram.

Para saber mais sobre campos customizados, acesse este artigo.


Em caso de dúvidas, chame nossa equipe no chat. 😉