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

# Variáveis do agente

> Use dados do contato, da conversa e valores próprios nas instruções, mensagens e ações.

Escreva uma variável entre chaves duplas, por exemplo `{{contact_fname}}`, e o agente a substitui pelo dado de cada conversa. Você as encontra em **Configurações do agente → Variáveis**.

## Onde funcionam

* Instruções do agente, em todos os canais e no Playground.
* Saudação, mensagem flutuante, rodapé e respostas rápidas do widget.
* Mensagens de encerramento.
* Ação Enviar e-mail: destinatários, assunto e corpo.
* Critério de «quando usar» e mensagens de confirmação das ações de transferência, formulários, agenda, tickets e pagamento.
* Título do evento do Google Calendar, título do lead no Pipedrive, e etiqueta, origem e empresa padrão no Zoho CRM e no LeadConnector, conforme o que cada integração permitir.

## Variáveis do sistema

| Variável | Valor |
| - | - |
| `contact_fname` | Nome do contato |
| `contact_company`, `contact_job_title` | Empresa e cargo |
| `contact_city`, `contact_state`, `contact_country`, `contact_postal_code`, `contact_address` | Localização |
| `contact_industry`, `contact_website` | Setor e site |
| `user_id`, `chat_id` | ID do usuário e do chat |
| `webpage_url`, `webpage_title` | Página que está sendo vista, somente no widget |
| `conversation_content` | Transcrição das últimas 50 mensagens |

## Variáveis próprias

Crie uma variável com um nome e um valor padrão. O valor em cada conversa pode vir de dois lugares:

**Snippet do widget:**

```html theme={null}
<script>
  window.chatnorrisConfig = {
    chatbotId: 'ID_DO_AGENTE',
    variables: { plan: 'premium' },
  }
</script>
```

**API v2:**

```json theme={null}
{ "message": "Olá", "variables": { "plan": "premium" } }
```

Os nomes que você não criou são ignorados. Se a variável for do tipo número ou booleano e o valor não corresponder, ele também é ignorado. Não use os nomes do sistema nem nomes só em maiúsculas: eles são reservados.

## Se uma variável não tiver valor

Usa-se o valor padrão. Se não houver, ela fica vazia e o visitante nunca vê as chaves.

> [!NOTE]
>
> Na saudação e nos demais textos do widget, que aparecem antes do início da conversa, os dados de contato ainda não são conhecidos. Só o nome fica disponível, se você o passar em `user` no snippet.

## Dados do visitante e segurança

O agente trata os dados do visitante como dados, nunca como instruções, mesmo que o visitante escreva algo que pareça uma. Não guarde senhas nem chaves em uma variável: o modelo pode ler o valor, e os valores usados nos textos do widget chegam ao navegador.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.