Variáveis globais: contact, conversation, trigger, execution
Os dados que o Omnifox injeta em cada automação, agrupados em $contact, $conversation, $trigger e $execution, com seus campos e exemplos de uso.
Veja este passo no vídeo · Variáveis
O que é e quando usar
As variáveis globais são os dados que o Omnifox injeta automaticamente em cada execução de uma automação, sem que você precise defini-los. Vêm agrupadas por "espaços de nome" conforme o que descrevem: o contato, a conversa, o gatilho e a própria execução. Você as usa para personalizar mensagens e montar requisições, e as encontra prontas no painel Variáveis do editor.
Este artigo cobre os quatro grupos principais: contact, conversation, trigger e execution. Lembre a sintaxe: {{$grupo.campo}}.
$contact — o contato
Dados da pessoa com quem você conversa:
{{$contact.id}}·{{$contact.first_name}}·{{$contact.last_name}}·{{$contact.display_name}}{{$contact.email}}·{{$contact.phone}}{{$contact.company}}·{{$contact.job_title}}{{$contact.city}}·{{$contact.country}}·{{$contact.language}}
Nota:
{{$contact.timezone}}existe, mas hoje resolve vazio (não há uma fonte confiável de fuso horário por contato).
$conversation — a conversa
Dados do tópico que disparou (ou que a automação toca):
{{$conversation.id}}·{{$conversation.status}}·{{$conversation.priority}}{{$conversation.channel_id}}·{{$conversation.channel_type}}·{{$conversation.channel_name}}{{$conversation.assignee}}(agente atribuído) ·{{$conversation.assignee_team}}(equipe){{$conversation.unread_count}}·{{$conversation.last_customer_message_at}}·{{$conversation.last_agent_message_at}}
Quando o gatilho é o fechamento da conversa, somam-se métricas como {{$conversation.first_response_time}}, {{$conversation.resolution_time}}, {{$conversation.incoming_messages_count}} e {{$conversation.outgoing_messages_count}}.
$trigger — o gatilho
Essas variáveis dependem do gatilho que inicia a automação: cada evento expõe seus próprios campos. Por isso o painel Variáveis mostra as do gatilho que você escolheu. Alguns exemplos:
- Negócio ganho / parado (CRM):
{{$trigger.title}},{{$trigger.amount}},{{$trigger.deal_id}},{{$trigger.days_inactive}}. - Mudança em uma coluna de um quadro:
{{$trigger.column_old}},{{$trigger.column_new}},{{$trigger.column_id}}. - Menção no Team:
{{$trigger.text}},{{$trigger.by_user_name}}.
Consulte o painel para ver exatamente o que seu gatilho traz antes de usá-las.
$execution — a execução
Identifica a execução atual da automação:
{{$execution.id}}— o ID desta execução.
Muito útil para correlacionar: por exemplo, enviar workflow_execution_id: {{$execution.id}} no corpo de um HTTP request para que o sistema externo saiba de qual execução veio.
Outros grupos úteis
{{$now.hour}},{{$now.day_of_week}}(1=segunda … 7=domingo),{{$now.date}},{{$now.time}},{{$now.iso}},{{$now.is_weekend}},{{$now.is_business_hours}}.{{$user.name}},{{$user.email}}— o agente atribuído.{{$workspace.name}},{{$organization.name}},{{$organization.plan}}.
Verificação
Faça um teste (Test run) com uma conversa real e veja a mensagem resultante na linha do tempo: confirme que cada {{$...}} sai com seu valor.
Se não funcionar
- Uma variável de
$triggersai vazia: esse campo não é exposto pelo seu gatilho. Abra o painel Variáveis e use só as listadas para esse gatilho. $conversation.*sai vazio: o gatilho não é de chat (por exemplo um evento de CRM sem conversa associada).$contact.timezonesempre vazio: é esperado, não há fonte de fuso horário hoje.
Dicas
- Para webhooks,
{{$now.iso}}já vem em formato ISO-8601 com Z (UTC), pronto para embutir. - Se precisar de
06em vez de6, use as variantes com sufixo_padded(por exemplo{{$now.hour_padded}}).
Artigos relacionados
Artigos relacionados
-
Crie sua primeira automacao (workflow)
Os workflows do Omnifox automatizam sua operacao: um gatilho inicia a automacao e os nos de acao fazem o trabalho. Crie uma mensagem de boas-vindas em minutos.
-
Catálogo de disparadores (triggers) dos workflows
Conheça os eventos que podem iniciar um workflow automaticamente no Omnifox.
-
Guia completo dos fluxos de trabalho (Workflows)
Os Workflows a fundo, em 54 capítulos: gatilhos, nós, variáveis, testes, histórico, modelos, importar e exportar, com cada opção explicada e um fluxo real de ponta a ponta.
-
Nós de ação disponíveis nos workflows
Descubra as ações que um workflow pode executar de forma automática.
-
Condições e ramificações (se/então) em um workflow
Faça seus fluxos tomarem decisões e seguirem caminhos diferentes conforme os dados de cada contato.