Todas as variáveis que você pode usar em um fluxo
A lista completa das variáveis com $ que o Tayon preenche para você, do cadastro do contato e da visita até agendamentos, pagamentos e matrícula em cursos, e onde cada uma funciona.
Esta é a lista completa das variáveis que o Tayon preenche quando um fluxo roda. Digite-as em qualquer campo que aceite variáveis: textos de telas e mensagens, assuntos de e-mail, parâmetros de webhook, URLs de redirecionamento, prompts de IA e condições de divisão.
Algumas regras valem para todas:
- Escreva exatamente como aparece aqui, em maiúsculas.
$crmdata.citynão é reconhecida. - A maioria não mostra nada quando não há valor, então escreva frases que continuem boas com o valor vazio.
- Onde funciona diz que tipo de fluxo a preenche: formulários conversacionais, fluxos de bot e os fluxos executados pelos seus agentes de IA de follow-up.
#As suas próprias respostas
| Variável | O que guarda | Onde funciona |
|---|---|---|
$IDENTIFICADOR |
A resposta guardada sob esse identificador, ou o resultado que uma Chamada API/Webhook ou um Prompt de IA guardou ali. | Todos os fluxos |
Se uma pergunta chamada NAME, FNAME, PHONE ou EMAIL foi pulada, o Tayon
a preenche com o nome, o telefone ou o e-mail do lead, quando já os conhece.
Respostas de perguntas de senha nunca são mostradas.
Uma ação só guarda o resultado quando você digita um nome em Armazenar
Resposta Em (Identificador). Os WEBHOOK_RESPONSE e AI_RESPONSE que
aparecem na caixa vazia são exemplos, não nomes preenchidos para você.
#A visita
| Variável | O que guarda | Onde funciona |
|---|---|---|
$FLOWSESSION |
Um código único desta visita ou conversa. | Todos os fluxos |
$FLOWPARAMETER |
O valor de par no link, como em ?par=primavera. |
Formulários, fluxos de bot |
$FLOW.EXTRA-CHAVE |
O valor de extra-chave no link. ?extra-plan=ouro preenche $FLOW.EXTRA-PLAN. |
Formulários |
$FLOWPOINTS |
A pontuação acumulada das opções que este visitante escolheu. | Formulários |
$UTM_SOURCE $UTM_MEDIUM $UTM_CAMPAIGN $UTM_CONTENT $UTM_TERM |
As marcações de campanha do link que trouxe a pessoa. | Formulários |
$COUNTRY |
O país do visitante em duas letras, como BR ou US, descoberto pela conexão dele. |
Formulários |
$FLOW.PARAMETER, $FLOW.POINTS, $FLOW.SESSION, $COUNTRY.ISO2 e
$UTM.SOURCE (e os demais nomes com $UTM.) são aceitos como outras grafias
dos mesmos valores.
Nos valores extra- do link, a parte depois de extra- só pode ter letras,
números e _. Um link leva no máximo 10 deles, e um valor que contenha = ou
, é ignorado.
Se o seu fluxo faz uma pergunta com o identificador COUNTRY, $COUNTRY mostra
a resposta em vez do país detectado.
#O contato
Quando o Tayon sabe com quem está falando, as variáveis $CRMDATA. leem o
cadastro desse contato. Em um formulário conversacional, é o contato ao qual a
visita está ligada. O Tayon o encontra depois que ele é salvo como lead, pelo
e-mail ou telefone que ele informou, ou porque ele entrou com login. Até lá,
nome, e-mail e telefone vêm do que o visitante digitou.
Elas funcionam em todos os tipos de fluxo.
| Variável | O que guarda |
|---|---|
$CRMDATA.NAME |
Nome e sobrenome |
$CRMDATA.FNAME / $CRMDATA.LNAME |
Nome / sobrenome |
$CRMDATA.EMAIL / $CRMDATA.PHONE |
E-mail / telefone |
$CRMDATA.BUSINESS |
Nome da empresa |
$CRMDATA.ADDRESS / $CRMDATA.CITY / $CRMDATA.STATE / $CRMDATA.ZIPCODE |
Dados do endereço |
$CRMDATA.BIRTHDATE |
Data de nascimento, como 2026-10-12 |
$CRMDATA.BIRTHMONTH / $CRMDATA.BIRTHYEAR |
Mês e ano de nascimento |
$CRMDATA.LANGUAGE |
O idioma do contato |
$CRMDATA.STAGE / $CRMDATA.QUALITY |
Etapa do funil e qualidade, pelo nome |
$CRMDATA.TAGS |
As tags do contato |
$CRMDATA.SNAPSHOT |
O resumo do cadastro do contato |
$CRMDATA.CHATLOG |
As informações reunidas sobre o contato em conversas anteriores |
$CRMDATA.UID |
O ID único do contato, útil em webhooks |
$CRMDATA.MEMBERNAME / $CRMDATA.MEMBEREMAIL / $CRMDATA.MEMBERPHONE |
Nome, e-mail e telefone do membro da equipe responsável pelo lead |
$CRMDATA.MEMBER |
O ID único desse membro da equipe |
$CRMDATA.CAMPO |
Qualquer campo personalizado do contato, como $CRMDATA.ROOF_AGE |
Os campos personalizados incluem os que o seu bot coleta pelos Campos de
Captura de Dados. Um campo personalizado cujo nome contenha PASSWORD nunca
mostra nada.
#As pessoas do seu lado
| Variável | O que guarda | Onde funciona |
|---|---|---|
$ACCOUNTNAME |
O nome completo do dono da conta | Todos os fluxos |
$ACCOUNTFIRSTNAME / $ACCOUNTLASTNAME |
Nome e sobrenome | Todos os fluxos |
$ACCOUNTEMAIL / $ACCOUNTPHONE |
E-mail e telefone | Todos os fluxos |
$ACCOUNTSMSCREDITS |
Os créditos de SMS que restam na conta | Todos os fluxos |
$FLOWASSIGNED.FNAME $FLOWASSIGNED.LNAME $FLOWASSIGNED.EMAIL $FLOWASSIGNED.PHONE |
O membro da equipe ao qual esta conversa está atribuída | Todos os fluxos |
$ACCOUNT.NAME, $ACCOUNT.EMAIL e $ACCOUNT.PHONE também funcionam.
#Agendamentos
| Variável | O que guarda | Onde funciona |
|---|---|---|
$FLOWCALENDAR.NAME / $FLOWCALENDAR.INFO |
O nome e a descrição do calendário em que este fluxo agenda | Formulários, fluxos de bot |
$FLOWCALENDAR.PLACE / $FLOWCALENDAR.ADDRESS |
O local e o endereço dele, ou - se você os deixou vazios |
Formulários, fluxos de bot |
$FLOWCALENDLYEVENT |
O tipo de evento do Calendly agendado | Formulários |
$FLOWCALENDLYSTART / $FLOWCALENDLYEND |
Quando começa e termina | Formulários |
$FLOWCALENDLYNAME / $FLOWCALENDLYEMAIL |
O nome e o e-mail do convidado | Formulários |
As variáveis do Calendly são preenchidas quando o visitante agenda por um template do Calendly e volta para o fluxo.
#Datasets
Funcionam em formulários conversacionais. Veja Datasets para saber como usá-las.
| Variável | O que guarda |
|---|---|
$DATASETFILTER |
Quantas linhas o último Filtrar DataSet encontrou |
$FLOWDATASET |
O ID da linha que o último filtro selecionou, ou 0 |
$DATASET.SUM $DATASET.AVERAGE $DATASET.MIN $DATASET.MAX |
Os resultados do último Calcular DataSet |
$[Dataset].COLUNA[1] |
Uma coluna da primeira linha que o filtro encontrou. Use ID como coluna para obter o ID da linha. |
#Resumos das respostas
Úteis em um e-mail de notificação para você mesmo. Funcionam em formulários e fluxos de bot.
| Variável | O que guarda |
|---|---|
$GNRNAME |
A primeira resposta do tipo nome (NAME, FNAME, FIRSTNAME, NOME), ou - |
$GNRFNAME / $GNRLNAME |
A primeira e a última palavra desse nome |
$GNRPHONE |
A primeira resposta do tipo telefone (PHONE, WHATSAPP, TELEFONE, CELULAR e parecidos), ou - |
$MESSAGE |
Todas as outras respostas, menos o e-mail, separadas por vírgulas, ou - |
#Resultados de ações
São preenchidas por uma ação anterior em um formulário conversacional.
| Variável | Preenchida por | O que guarda |
|---|---|---|
$PAYMENTSTATUS e o resto da família $PAYMENT |
Pagamento | O status, o pedido, o valor e o erro do pagamento. Veja Receber um pagamento dentro do seu site. |
$ELENROLLSTATUS |
Matricular em curso | requested, no_course, no_email ou error. Veja Matricular pessoas em um curso a partir de um fluxo. |
$VALIDATION_CODE |
Enviar E-mail ou Enviar SMS | Um código de uso único, criado quando o texto da mensagem contém $VALIDATION_CODE. |
Para confirmar um e-mail ou telefone, coloque $VALIDATION_CODE em uma
mensagem para o lead, com palavras antes, como Seu código é $VALIDATION_CODE.
Depois peça o código e teste a resposta em uma divisão: $ECODE = $VALIDATION_CODE.
#Mensagens recebidas por um agente de IA
Os fluxos que respondem quando um lead responde a um agente de IA de follow-up
podem ler a própria resposta: $EMAILDATA.BODY, $EMAILDATA.SUBJECT,
$IMDATA.BODY, a categoria da resposta e respostas escritas pela IA, como
$EMAILDATA.AIRESPONSE. Elas estão explicadas em Ler e responder a resposta
de um lead em um fluxo de agente de IA.
#Vídeos que você envia
Vídeos que você envia para o Tayon e coloca em uma tela não precisam de variável. O Tayon cuida do link, e o vídeo só toca nos seus próprios sites e formulários.
Atualizado: