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.

Jun 26, 2026

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 $trigger sai 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.timezone sempre 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 06 em vez de 6, use as variantes com sufixo _padded (por exemplo {{$now.hour_padded}}).

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp