# Segmenti

> I segmenti sono filtri salvati sui contatti. Creali a partire da tutti i contatti o da liste scelte, invia loro campagne o escludili, e controlla il limite di segmenti del piano. Alpha: aperti solo al team di Emailit.

Un segmento è un filtro salvato sui contatti del workspace, ad esempio «Clienti con il piano Pro» o «Registrati negli ultimi 30 giorni». Non aggiungi persone a un segmento: ne fa parte chiunque soddisfi le sue regole, e nessun altro. Usa i segmenti per inviare una [campagna](/it/docs/campaigns/) a una parte dei contatti, o per escludere delle persone da una campagna.

> **I segmenti sono in alpha:** I segmenti sono aperti solo al team di Emailit mentre li testiamo. Vedi [Chi può usare i segmenti](#who-can-use-segments).

## Chi può usare i segmenti

Durante l’alpha, i segmenti sono disponibili solo per gli amministratori della piattaforma Emailit. Il ruolo Admin di un workspace non basta.

| Dove | Team di Emailit | Tutti gli altri |
| --- | --- | --- |
| Pannello | **Email Marketing → Segments**, i selettori dei segmenti nelle campagne, i trigger di segmento nelle automazioni e gli eventi di segmento nei webhook | **Segments** nel menu mostra **Soon** e non si può aprire. I selettori sono nascosti, ma una campagna o un’automazione che usa già un segmento continua a mostrarlo. |
| API e MCP | L’API dei segmenti, i segmenti come destinatari, i trigger di segmento e gli strumenti MCP dei segmenti | `403` con `error: "segments_alpha"` |
| Chiavi API | Nessuna. Le chiavi API appartengono a un workspace, non a una persona. | `403` con `error: "segments_alpha"` |

Le campagne e le automazioni che usano già un segmento continuano a funzionare per tutti nel workspace, e i segmenti tracciati continuano ad aggiornarsi.

## Come funzionano i segmenti

Un segmento ha due parti:

- **Origine.** Tutti i contatti del workspace, oppure solo gli iscritti delle liste che scegli.
- **Filtri.** Gruppi di regole sui campi del contatto, sui [campi personalizzati](/it/docs/contacts/custom-fields/), sull’appartenenza alle liste e su [tag e lead score](/it/docs/contacts/tags-and-score/), ad esempio **Email domain** è `acme.com`, **plan** è uno tra `pro` ed `enterprise`, oppure **Tags** ha almeno uno tra `vip`. Un gruppo può richiedere tutte le sue regole o almeno una, e il segmento tutti i suoi gruppi o almeno uno. Senza filtri, nel segmento c’è chiunque provenga dall’origine.

Emailit valuta un segmento ogni volta che viene contato, elencato o usato per un invio, quindi è sempre aggiornato. Una campagna programmata per la settimana prossima raggiunge chi corrisponde al momento dell’invio, e regole come «creato negli ultimi 30 giorni» si spostano con la data.

### Chi possono raggiungere le campagne

Ogni segmento mostra due conteggi: **Contacts**, cioè tutti quelli che corrispondono, e **Subscribed**, la parte a cui le campagne possono inviare. Un contatto è iscritto quando non è disiscritto a livello globale ed è iscritto ad almeno una lista, qualsiasi. I contatti che non sono mai entrati in una lista corrispondono ai segmenti ma non ricevono campagne. Gli indirizzi soppressi vengono comunque contati, e vengono saltati quando la campagna viene inviata.

Il campo **Subscription status** usa la stessa regola, quindi la condizione **Subscription status** è `subscribed` restringe un segmento ai contatti che le campagne possono raggiungere.

## Crea un segmento

1. Vai a **Email Marketing → Segments** e seleziona **Create segment**.
2. In **Details**, compila il campo **Name** e, se vuoi, una **Description** per il team.
3. In **Type**, scegli **Segment** o **Tracked segment**. Non potrai cambiare il tipo in seguito. Vedi [Segmenti semplici e tracciati](#plain-and-tracked-segments).
4. In **Contacts from**, scegli **All contacts** o **Subscribers of specific audiences** e seleziona le liste in **Audiences**.
5. In **Filters**, seleziona **Add condition** e scegli un campo, un operatore e un valore. Usa **Add group** per un altro gruppo di condizioni, e alterna **all** e **any** per decidere come si combinano condizioni e gruppi.
6. Controlla il riquadro **Preview**: il numero di **Matching contacts**, quanti sono iscritti e i **First matches**. Si aggiorna mentre modifichi.
7. Seleziona **Save segment**.

Puoi anche creare un segmento da altre pagine:

- **Save as segment** nell’elenco Contacts trasforma i filtri attuali dell’elenco in un segmento. I filtri che i segmenti non supportano vengono tralasciati, e l’editor li elenca.
- **Create segment** nel menu della pagina di una lista crea un segmento con quella lista come origine.
- **Duplicate** nel menu della riga di un segmento lo copia come nuovo segmento.

Per l’elenco completo di campi, operatori e valori, vedi [Crea un segmento](/it/docs/api-reference/segments/create/#conditions) nel riferimento API.

## La pagina del segmento

Seleziona un segmento in **Email Marketing → Segments** per aprirlo. La pagina mostra i valori **Contacts**, **Subscribed** e **Updated**, la **Definition** del segmento e i contatti che corrispondono in questo momento, con ricerca e filtri. I contatti sono elencati in tempo reale, quindi l’elenco cambia quando cambiano i contatti.

Dall’intestazione puoi modificare il segmento con **Edit**, avviare una campagna che invia al segmento con **Create campaign**, o eliminarlo con **Delete** dal menu.

## Invia una campagna a un segmento

Nel passaggio **Recipients** della campagna, scegli uno o più segmenti in **Segments**, da soli o insieme alle liste in **Audiences**. Per escludere delle persone, usa **Exclude audiences** ed **Exclude segments**. Vedi [Crea una campagna](/it/docs/campaigns/create/#step-1-recipients).

- **Valutati al momento dell’invio.** Emailit determina i destinatari quando inizia l’invio, quindi i contatti che corrispondono in quel momento vengono inclusi e quelli che hanno smesso di corrispondere vengono esclusi.
- **Una copia per indirizzo.** Un contatto presente in più liste e segmenti selezionati riceve la campagna una sola volta.
- **Le esclusioni prevalgono.** Un contatto che si trova in una lista o in un segmento esclusi viene saltato, anche se è presente anche in uno selezionato.
- **Le esclusioni eliminate bloccano l’invio.** Se una campagna esclude una lista o un segmento che non esiste più, Emailit non la invia: l’invio restituisce un errore e una campagna programmata torna a **Draft**. Aggiorna i destinatari, poi inviala di nuovo.

Non puoi eliminare un segmento mentre lo usa una campagna programmata o in invio. Eliminare un segmento lo rimuove dalle bozze di campagna che inviano al segmento. Le bozze che lo escludono mantengono l’esclusione e non si possono inviare finché non la sostituisci, così le persone che volevi escludere non le ricevono mai.

## Segmenti semplici e tracciati

Quando crei un segmento, ne scegli il tipo:

| | **Segment** | **Tracked segment** |
| --- | --- | --- |
| Conteggi, elenco dei contatti e campagne | In tempo reale | In tempo reale |
| Registra chi entra e chi esce, e quando | No | Sì |
| Avvia automazioni a ogni ingresso e uscita | No | Sì |
| Invia i webhook `segment.contact_added` e `segment.contact_removed` | No | Sì |
| Grafico **Growth** e colonna **Joined** | No | Sì |
| Piani | Tutti | Pro, Business e Custom |

Una volta creato il segmento, il tipo non cambia più. Per passare all’altro tipo, crea un nuovo segmento con le stesse regole. Vedi [Segmenti tracciati](/it/docs/segments/tracked/).

Le automazioni possono anche controllare qualsiasi segmento, tracciato o no, in una **Condition** If/Else, in un obiettivo, in un passaggio **Wait until** o in una condizione di uscita: **Segment** is in **VIP customers**. Vedi [Condition (If/Else)](/it/docs/automations/steps/#condition-ifelse). Un segmento usato da un’automazione non si può eliminare finché non modifichi l’automazione.

## Limiti

Ogni piano include un certo numero di segmenti per workspace. I segmenti tracciati e quelli semplici rientrano nello stesso limite.

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Segmenti | 3 | 10 | 100 | Flessibile |
| Segmenti tracciati | — | Inclusi | Inclusi | Inclusi |

L’elenco Segments mostra quanti ne hai usati, ad esempio `3/10 used`. Quando raggiungi il limite, **Create segment** e **Duplicate** sono disattivati finché non elimini un segmento o [passi a un piano superiore](/it/docs/billing/plans/). L’API restituisce `422` con l’attuale `usage`:

```json
{
  "error": "Pay as you go includes 3 segments.",
  "message": "Pay as you go includes 3 segments.",
  "usage": { "used": 3, "limit": 3 }
}
```

Se passi a un piano inferiore, i segmenti continuano a funzionare, ma non puoi aggiungerne altri finché non scendi sotto il nuovo limite. Con Pay as you go, i segmenti tracciati vanno in pausa. Vedi [Quando il tracciamento va in pausa](/it/docs/segments/tracked/#when-tracking-pauses).

Un segmento può avere fino a 10 gruppi e 50 regole, e attingere da un massimo di 100 liste.

## Usa l’API e il server MCP

L’[API dei segmenti](/it/docs/api-reference/segments/) ti permette di [creare](/it/docs/api-reference/segments/create/), [recuperare](/it/docs/api-reference/segments/get/), [aggiornare](/it/docs/api-reference/segments/update/), [elencare](/it/docs/api-reference/segments/list/) ed [eliminare](/it/docs/api-reference/segments/delete/) i segmenti, di [elencarne i contatti](/it/docs/api-reference/segments/contacts/), di [visualizzare l’anteprima](/it/docs/api-reference/segments/preview/) di una definizione prima di salvarla e di [elencare i campi](/it/docs/api-reference/segments/fields/) che le regole possono usare. L’API richiede una chiave API con **Full Access**.

```bash
curl https://api.emailit.com/v2/segments \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme team",
    "conditions": { "rules": [{ "field": "email_domain", "operator": "equals", "value": "acme.com" }] }
  }'
```

Per inviare una campagna a un segmento, aggiungi `{ "segment_id": "seg_…" }` ai suoi `recipients` con [Aggiorna una campagna](/it/docs/api-reference/campaigns/update/), oppure `{ "segment_id": "seg_…", "exclude": true }` per escluderlo.

Sul [server MCP](/it/docs/mcp/), il toolset (gruppo di strumenti) `segments` offre le stesse operazioni, così un assistente AI può creare e controllare i segmenti per te. Vedi [Toolset e modalità di sola lettura](/it/docs/mcp/toolsets/).

## Passaggi successivi

  - [Segmenti tracciati](/it/docs/segments/tracked/): Registra ingressi e uscite e avvia automazioni.
  - [Crea una campagna](/it/docs/campaigns/create/): Invia ai segmenti ed escludine altri.
  - [Campi personalizzati](/it/docs/contacts/custom-fields/): Memorizza i dati su cui filtrano le regole.
  - [API dei segmenti](/it/docs/api-reference/segments/): Tutti gli endpoint dei segmenti.

---
Fonte: https://emailit.com/it/docs/segments/