# Valores globais

> Armazene valores que você reutiliza em e-mails e automações, como a data de um webinar, um link de agendamento ou o prazo de uma oferta, e use-os como {{global.key}}, em condições e em datas.

Um valor global é um valor único para todo o workspace, como a data do próximo webinar, um link de agendamento, a URL de uma oferta, um prazo ou o nome de um vendedor. Defina-o uma vez e use-o em todo lugar como `{{global.<key>}}`: altere-o em um só lugar, e todos os e-mails enviados a partir de então usam o novo valor, assim como todas as execuções que chegarem a uma etapa **Wait until** depois disso. As execuções que já estão esperando mantêm a data que leram.

## Criar um valor global

1. **Abra Global values.** Acesse **Workspace → Settings → Global values** e selecione **New global value**.

2. **Dê um nome.** Em **Name**, digite um nome, por exemplo, `Webinar date`. O campo **Key** é preenchido a partir do nome, por exemplo, `webinar_date`. As chaves começam com uma letra minúscula e usam letras minúsculas, dígitos e `_`, com até 64 caracteres.

3. **Escolha o tipo e informe o valor.**

   | Tipo | Valor | Exemplo |
   | --- | --- | --- |
   | **Text** | Qualquer texto | `Automations masterclass` |
   | **Number** | Um número | `120` |
   | **Boolean** | Verdadeiro ou falso | `true` |
   | **Date** | Uma data do calendário | `2026-11-05` |
   | **Date and time** | Uma data e um horário, armazenados em UTC | `2026-11-05T17:00:00Z` |
   | **URL** | Uma URL `http` ou `https` | `https://cal.example.com/demo` |

4. **Salve.** Copie `{{global.webinar_date}}` da lista para usá-lo.

Um workspace pode ter até 500 valores globais. Excluir um faz com que `{{global.<key>}}` seja renderizado vazio.

## Usar valores globais

| Onde | Como |
| --- | --- |
| Templates, campanhas e e-mails de automações | `{{global.webinar_link}}` em qualquer lugar do assunto ou do conteúdo. No Temple, `{{#if global.offer_url}}…{{/if}}` também funciona. |
| E-mails enviados pela API | `{{global.<key>}}` no template ou no conteúdo inline é preenchido, a menos que as suas `variables` contenham um objeto `global` próprio. |
| Configurações das etapas de automação | Variáveis como as do corpo de um **Webhook** ou de **Reply to**: `{{global.sales_rep_email}}`. |
| **Wait until** uma data | **Date** → **A global value**, por exemplo, “1 dia antes de `webinar_date` às 09:00”. Consulte [Wait until](/pt/docs/automations/steps/#wait-until). |
| Condições | **Check** → **Global value**, por exemplo, “**Offer deadline** já passou”, para enviar um e-mail diferente a quem se inscreveu atrasado. |

As datas e os horários são renderizados como estão armazenados, por exemplo, `2026-11-05T17:00:00.000Z`. Para mostrar uma data mais legível, adicione um valor de texto ao lado dela, como `webinar_date_label` = `Thursday, November 5 at 6 PM CET`.

## Usar a API

A [API de valores globais](/pt/docs/api-reference/global-values/) os gerencia com uma chave de API com **Full Access**. `{id}` é o ID `gv_` ou a chave:

```bash
curl https://api.emailit.com/v2/global-values \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "key": "webinar_date", "name": "Webinar date", "type": "datetime", "value": "2026-11-05T17:00:00Z" }'
```

```bash
curl https://api.emailit.com/v2/global-values/webinar_date \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "value": "2026-12-03T17:00:00Z" }'
```

O [servidor MCP](/pt/docs/mcp/tools/) tem as mesmas operações no toolset `global_values`.

## Veja também

  - [Temple](/pt/docs/templates/temple/): Variáveis, valores padrão e condicionais nos templates.
  - [Etapas de automação](/pt/docs/automations/steps/): Espere até uma data global.

---
Fonte: https://emailit.com/pt/docs/contacts/global-values/