Variáveis do prompt e referências a ferramentas

Use $ para inserir variáveis (como o nome do contato) e ! para referenciar ações dentro das instruções do seu agente.

Jun 26, 2026

Veja este passo no vídeo · Instruções: o editor

As instruções do seu agente não precisam ser um texto estático. No editor de Instruções você pode inserir variáveis que se preenchem sozinhas com dados do contato e referenciar as ações (ferramentas) que o agente pode executar.

Os dois atalhos do editor

Na aba Instruções, enquanto você escreve o prompt:

  • Digite $ para inserir uma variável (por exemplo, o nome do contato).
  • Digite ! para inserir uma referência a uma ação (uma ferramenta do agente).

Ao digitar qualquer um dos dois, aparece um autocompletar com as opções disponíveis. Escolha uma e ela vira uma "pílula" dentro do texto.

Variáveis mais usadas

As variáveis são agrupadas por origem. Algumas comuns:

  • $contact.first_name — Nome do contato
  • $contact.last_name — Sobrenome
  • $contact.email — Email
  • $contact.phone — Telefone
  • $contact.language — Idioma do contato
  • $workspace.name — Nome do workspace
  • $conversation.channel_type — Tipo de canal

Em tempo real, $contact.first_name é substituído pelo nome real da pessoa. Se o dado estiver vazio, o agente simplesmente o ignora.

Como inserir uma variável

  1. Abra o agente e vá até a aba Instruções.
  2. Posicione o cursor onde quer o dado.
  3. Digite $ e comece a escrever (ex.: nome).
  4. Escolha a variável na lista (ex.: Nome).
  5. Salve as alterações.

Exemplo: Cumprimente o cliente pelo nome: $contact.first_name.

Como referenciar uma ação

As ações são as ferramentas que você já configurou na aba Ações personalizadas (agendar uma visita, etiquetar um contato, criar uma oportunidade, etc.).

  1. No editor de Instruções, digite !.
  2. Escolha a ação no autocompletar.
  3. Explique quando ela deve ser usada: "Se o cliente quiser uma visita, use !agendar_visita".

Referenciar a ação não a executa: apenas avisa ao agente que aquela ferramenta existe e em que momento convém usá-la.

Verificação

  1. Vá até a aba Sandbox.
  2. Envie uma mensagem que acione o dado ou a ação.
  3. Veja o Trace: ali aparecem os valores reais injetados e qual ferramenta o agente chamou.

Se não funcionar

  • A variável fica vazia: esse contato não tem aquele dado preenchido; teste com um contato completo.
  • O autocompletar não aparece: garanta que você digitou $ ou ! como primeiro caractere do token, sem espaço antes.
  • A ação não é executada: confirme que ela está criada e ativa em Ações personalizadas; se você a apagou ou renomeou, a referência no prompt quebra.

Dicas

  • Personalizar com $contact.first_name aumenta muito a sensação de atendimento humano.
  • Não exagere nas ações: referencie apenas as que o agente realmente precisa naquela conversa.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp