> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tigyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Variáveis de Template

> Você pode usar variáveis de template nos prompts dos seus nós de Agent ou ao construir o payload do Webhook Node.

### Renderização de templates

Você referencia variáveis de template com a sintaxe `{{double_brace}}`. Os dados vêm do [`initial_context`](/pt/core-concepts/context-and-variables#initial_context), incluindo valores retornados por um [Pre-Call Data Fetch](/pt/voice-agent/pre-call-data-fetch), e do [`gathered_context`](/pt/core-concepts/context-and-variables#gathered_context) nos payloads de webhook.

**A sintaxe depende de onde você usa:**

| Onde                      | `initial_context`                           | `gathered_context`                |
| ------------------------- | ------------------------------------------- | --------------------------------- |
| Prompts de nós de Agent   | `{{field_name}}` (referenciado diretamente) | Não disponível                    |
| Payloads de Webhook Nodes | `{{initial_context.field_name}}`            | `{{gathered_context.field_name}}` |

#### Prompts de nós de Agent

Em um prompt de nó de Agent, referencie cada campo de `initial_context` **diretamente pelo nome**. Valores aninhados são suportados com notação de ponto.

Exemplo: se o contexto inicial é

```json theme={null}
{
    "initial_context": {
        "user": {
            "name": "John"
        }
    }
}
```

escreva seu prompt para acessar o nome do usuário da seguinte forma:

Prompt: `You are Alice, who is talking to {{user.name}}.`

<Note>
  As variáveis extraídas durante a chamada (`gathered_context`) **não** estão disponíveis nos prompts de Agent — um prompt só pode referenciar campos de `initial_context`. Para agir sobre os dados extraídos, envie-os a um [Webhook Node](/pt/voice-agent/webhook).
</Note>

#### Payloads de Webhook Nodes

Ao construir um payload de [Webhook Node](/pt/voice-agent/webhook), os objetos de contexto ficam aninhados sob seus nomes, então referencie-os com os prefixos `initial_context.` e `gathered_context.`:

Valor de payload: `{{initial_context.user.name}}` ou `{{gathered_context.call_disposition}}`

### Usando variáveis de template para testes

As variáveis de template definidas em **Settings > Context Variables** do seu workflow são incluídas nas chamadas de teste (web e telefone) feitas a partir do editor de workflow. Isso é útil para simular dados que normalmente viriam da telefonia.

<img src="https://mintcdn.com/callguard/w-VUnJAq_m6hhmzP/images/template-variables.png?fit=max&auto=format&n=w-VUnJAq_m6hhmzP&q=85&s=5c1c77c71be2eac15287d3fb140fa673" alt="Painel de variáveis de template nas Settings do workflow, mostrando uma variável customer_name e campos para adicionar novos pares de chave/valor" style={{border: "1px solid #d1d5db", borderRadius: "8px", maxWidth: "100%"}} width="2254" height="1262" data-path="images/template-variables.png" />

Por exemplo, você pode definir `caller_number` e `called_number` como variáveis de contexto para testar o [Pre-Call Data Fetch](/pt/voice-agent/pre-call-data-fetch#testando-com-chamadas-de-teste) sem precisar de uma chamada recebida real.

Os testes de voz no navegador usam o mesmo modelo de contexto das chamadas recebidas.

<Note>
  Essas variáveis de contexto são usadas apenas durante as chamadas de teste do editor de workflow. Nas chamadas recebidas de produção, os dados reais de telefonia são usados e esses valores são ignorados.
</Note>

### Nodes

Os agentes de voz da Tig.ai são compostos por vários nós. Esses nós fornecem instruções ao agente de voz, configuram conversas recebidas e enviam resultados para os seus sistemas com um [webhook](/pt/voice-agent/webhook). Nas próximas etapas, documentaremos os nós que você pode usar para construir o agente de voz.