Variaveis em workflows: personalize cada mensagem com {{dados}}

Uma mensagem que diz "Ola" converte pior do que uma que diz "Ola, Ana, vimos seu pedido #4821". A diferenca sao as variaveis em workflows: pequenos marcadores como {{$contact.first_name}} que o Omnifox substitui em tempo de execucao pelo dado real de cada contato. Neste guia voce vai ver quais variaveis existem, como inseri-las nos nos e como encadear a saida de um no no proximo para montar automacoes que parecem escritas a mao.

O que e uma variavel e onde ela funciona

Uma variavel e um texto entre chaves duplas que o motor substitui logo antes de enviar. A regra de ouro do Omnifox: se a variavel nao existe ou esta vazia, vira uma string vazia e a mensagem nao quebra. Isso permite escrever modelos sem medo de aparecer um null feio.

As variaveis funcionam em quase qualquer no que aceite texto: Enviar mensagem, Fazer uma pergunta, Enviar template do WhatsApp, Enviar email ao cliente, Adicionar nota interna, Notificar a equipe por email e tambem em Atualizar contato ou Definir variavel.

As familias de variaveis

O Omnifox agrupa as variaveis por origem. Estas sao as que voce vai usar todo dia:

• Contato: {{$contact.first_name}}, {{$contact.last_name}}, {{$contact.email}}, {{$contact.phone}}, {{$contact.company}}, {{$contact.tags}}.
• Conversa: {{$conversation.status}}, {{$conversation.channel_name}}, {{$conversation.assignee}} (agente atribuido) e {{$conversation.summary}}, um resumo gerado por IA da conversa.
• Mensagem: {{$message.text}}, {{$message.type}}, {{$message.media_url}}.
• Chamada (se voce tem o plano de chamadas): {{$call.from}}, {{$call.direction}}, {{$call.duration}}, {{$call.recording_url}}.
• IVR: {{$ivr.digit}} e {{$ivr.option_label}}.
• Deal / gatilho: {{$trigger.title}}, {{$trigger.amount}}, {{$trigger.stage_name}} quando o workflow comeca por um evento de CRM.

Um fluxo real de boas-vindas personalizado

Vamos combinar tudo em um workflow concreto. O objetivo: saudar na primeira mensagem usando o nome e o canal.

1. Gatilho Mensagem recebida com o filtro apenas a primeira ativado, para disparar so no primeiro contato.
2. No Enviar mensagem com o texto: Ola {{$contact.first_name}}, obrigado por falar com a gente pelo {{$conversation.channel_name}}. Ja te atendemos. Se o contato ainda nao tem nome, {{$contact.first_name}} fica vazio e a saudacao vira apenas "Ola,".
3. No Adicionar etiqueta para marcar como lead novo.
4. No Transferir para um agente para um humano continuar.

A ordem fica: Mensagem recebida (apenas a primeira) -> Enviar mensagem -> Adicionar etiqueta -> Transferir para um agente.

Encadear a saida de um no com {{steps.last}}

Aqui esta a parte poderosa. Alguns nos produzem um dado ao rodar, e esse dado fica disponivel para os nos seguintes. O caso classico e {{steps.last.created_item_id}}: quando um no Criar elemento (ou Criar cartao a partir da conversa) cria um registro, ele deixa o ID do item recem-criado, e um no posterior pode reutiliza-lo.

Exemplo de um workflow de suporte que abre um ticket em um quadro e avisa o cliente com o numero:

1. Gatilho Etiqueta adicionada (por exemplo a etiqueta "reclamacao").
2. No Criar elemento no quadro de Suporte, usando {{$contact.first_name}} no titulo.
3. No Enviar mensagem: Abrimos seu caso com o numero {{steps.last.created_item_id}}. Avisamos por aqui quando avancar.

O fluxo: Etiqueta adicionada -> Criar elemento -> Enviar mensagem. A segunda mensagem pega o ID que o no anterior deixou. Esse padrao serve para qualquer coisa que gere um identificador: criar uma oportunidade, uma tarefa ou um cartao.

Definir suas proprias variaveis

Quando voce precisa de um valor calculado ou quer guardar algo para depois, use o no Definir variavel. Por exemplo, salvar o canal de origem em uma variavel propria no inicio do fluxo e reutiliza-la em varias mensagens, ou combinar {{$contact.first_name}} com um texto fixo para uma saudacao usada em varios nos. Voce tambem pode capturar o que o cliente respondeu com Fazer uma pergunta e guardar para um no posterior.

Erros comuns que convem evitar

• Escrever a variavel com um espaco a mais, como {{ $contact.first_name }}, quando o nome correto nao tem espacos internos. Copie sempre do seletor de variaveis do editor para nao errar.
• Supor que uma variavel de chamada existe em um fluxo de chat: {{$call.duration}} so tem valor se o workflow comecou por um evento de chamada. Num fluxo de mensageria fica vazio.
• Depender de {{$contact.first_name}} quando muitos contatos nao tem nome. Como fica vazio, sua frase precisa fazer sentido sem ele. Escreva "Ola" em vez de "Prezado Sr." seguido de um sobrenome vazio.
• Esquecer que {{$conversation.summary}} e gerado pela IA e pode levar um instante; use quando ja houver conversa suficiente.

Variantes uteis

Com o mesmo mecanismo voce monta um aviso interno com contexto: um no Notificar a equipe por email que inclua {{$contact.phone}}, {{$conversation.channel_name}} e {{$conversation.summary}} para o agente entrar na conversa ja sabendo do que se trata. Ou uma confirmacao de encerramento via Enviar mensagem que mencione {{$conversation.assignee}} para o cliente saber quem o atendeu.

No Omnifox o seletor de variaveis aparece assim que voce digita {{ em qualquer campo de texto do editor de workflows, entao voce nunca precisa decorar os nomes. Comece pela sua mensagem de boas-vindas, adicione uma variavel e veja cada contato receber algo diferente. Quando dominar, encadeie a saida de um no com {{steps.last}} e suas automacoes sobem de nivel. Crie seu primeiro workflow com variaveis no Omnifox.