# Valori globali

> Salva i valori che riutilizzi nelle email e nelle automazioni, come la data di un webinar, un link di prenotazione o la scadenza di un’offerta, e usali come {{global.key}}, nelle condizioni e nelle date.

Un valore globale è un unico valore per tutto il workspace, come la data del prossimo webinar, un link di prenotazione, l’URL di un’offerta, una scadenza o il nome di un commerciale. Lo definisci una volta e lo usi ovunque come `{{global.<key>}}`: lo modifichi in un solo punto e ogni email inviata da quel momento usa il nuovo valore, così come ogni esecuzione che arriva in seguito a un passaggio **Wait until**. Le esecuzioni già in attesa mantengono la data che hanno letto.

## Crea un valore globale

1. **Apri Global values.** Vai a **Workspace → Settings → Global values** e seleziona **New global value**.

2. **Dagli un nome.** Compila il campo **Name**, ad esempio `Webinar date`. Il campo **Key** si compila a partire dal nome, ad esempio `webinar_date`. Le chiavi iniziano con una lettera minuscola e usano lettere minuscole, cifre e `_`, fino a 64 caratteri.

3. **Scegli il tipo e inserisci il valore.**

   | Tipo | Valore | Esempio |
   | --- | --- | --- |
   | **Text** | Qualsiasi testo | `Automations masterclass` |
   | **Number** | Un numero | `120` |
   | **Boolean** | Vero o falso | `true` |
   | **Date** | Una data del calendario | `2026-11-05` |
   | **Date and time** | Una data e un’ora, salvate in UTC | `2026-11-05T17:00:00Z` |
   | **URL** | Un URL `http` o `https` | `https://cal.example.com/demo` |

4. **Salva.** Copia `{{global.webinar_date}}` dall’elenco per usarlo.

Un workspace può avere fino a 500 valori globali. Se ne elimini uno, `{{global.<key>}}` viene elaborato come vuoto.

## Usa i valori globali

| Dove | Come |
| --- | --- |
| Template, campagne ed email delle automazioni | `{{global.webinar_link}}` in qualsiasi punto dell’oggetto o del contenuto. In Temple funziona anche `{{#if global.offer_url}}…{{/if}}`. |
| Email inviate con l’API | `{{global.<key>}}` nel template o nel contenuto inline viene compilato, a meno che le tue `variables` contengano un proprio oggetto `global`. |
| Impostazioni dei passaggi delle automazioni | Segnaposto come il corpo di un **Webhook** o un **Reply to**: `{{global.sales_rep_email}}`. |
| **Wait until** una data | **Date** → **A global value**, ad esempio «1 giorno prima di `webinar_date` alle 09:00». Vedi [Wait until](/it/docs/automations/steps/#wait-until). |
| Condizioni | **Check** → **Global value**, ad esempio «**Offer deadline** has passed» per inviare un’email diversa a chi si iscrive in ritardo. |

Date e orari vengono mostrati così come sono salvati, ad esempio `2026-11-05T17:00:00.000Z`. Per mostrare una data più leggibile, aggiungi accanto un valore di tipo Text, come `webinar_date_label` = `Thursday, November 5 at 6 PM CET`.

## Usa l’API

L’[API dei valori globali](/it/docs/api-reference/global-values/) li gestisce con una chiave API con **Full Access**. `{id}` è l’ID `gv_` o la chiave:

```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" }'
```

Il [server MCP](/it/docs/mcp/tools/) offre le stesse operazioni nel toolset `global_values`.

## Vedi anche

  - [Temple](/it/docs/templates/temple/): Variabili, valori predefiniti e condizioni nei template.
  - [Passaggi delle automazioni](/it/docs/automations/steps/): Attendi una data globale con Wait until.

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