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

# Contatti

> Panoramica sulla gestione di contatti e CRM — profili, tag, segmentazione, importazione e avatar.

La pagina Contatti è il CRM leggero di Switchbord: ogni contatto WhatsApp con cui la tua area di lavoro ha scambiato messaggi (o che è stato importato) ottiene un record persistente con un nome visualizzato, un numero di telefono, tag e qualsiasi campo personalizzato che la tua area di lavoro monitora. È uno stato forward-only e append-friendly — la cronologia del contatto non viene riscritta, si accumula.

## Il record del contatto

Ogni contatto contiene:

<CardGroup cols={2}>
  <Card title="Identità" icon="id-card">
    Nome visualizzato e numero di telefono in formato E.164 — i due campi obbligatori per qualsiasi contatto, che sia creato manualmente, via API o tramite importazione CSV.
  </Card>

  <Card title="Tag" icon="tag">
    Etichette di segmentazione libere (`vip`, `newsletter`, `2026-winter`). I tag sono l'elemento condiviso tra Posta in arrivo, Contatti e Campagne — tagga un contatto una volta e sarà utilizzabile come filtro del pubblico ovunque.
  </Card>

  <Card title="Avatar" icon="circle-user">
    Un fallback basato sulle iniziali per default, oppure una foto caricata da un operatore. Consulta [Avatar dei contatti](/it/features/contact-avatars) per capire perché WhatsApp stesso non ne fornisce mai uno.
  </Card>

  <Card title="Stato del consenso" icon="shield-check">
    Stato di opt-out marketing, impostato automaticamente quando un contatto risponde `STOP` (o un equivalente localizzato) a un modello marketing — escluso per default dal pubblico delle campagne future.
  </Card>
</CardGroup>

## Trovare e filtrare i contatti

L'elenco Contatti supporta la ricerca e il filtro per tag e altri attributi, basato su query lato server, così scala oltre la prima pagina di risultati. Da una conversazione aperta nella [Posta in arrivo](/it/features/inbox), lo stesso record del contatto è visibile nella barra laterale — le modifiche effettuate da entrambe le superfici si riflettono immediatamente nell'altra.

## Creazione dei contatti

I contatti vengono creati in tre modi:

1. **Automaticamente** — la prima volta che qualcuno scrive al tuo numero WhatsApp.
2. **Manualmente** — aggiungi un singolo contatto con nome, telefono e tag direttamente dalla pagina Contatti.
3. **Importazione in blocco** — carica un CSV di contatti in un'unica operazione. Consulta [Importazione CSV dei contatti](/it/features/contacts-import) per il formato esatto delle colonne, le regole di normalizzazione del telefono e la risoluzione dei problemi.

## Segmentazione per campagne e journeys

I tag (e qualsiasi criterio di filtro combinato) costruiti qui diventano la definizione del pubblico per le [Campagne](/it/features/campaigns) e le condizioni di ingresso per le [Journeys](/it/features/journeys). Non esiste un modello di dati separato per il "pubblico" — il pubblico di una campagna è semplicemente una query sui contatti.

## Margaret e i contatti

[Margaret](/it/features/margaret) ha accesso diretto e soggetto ad approvazione ai dati dei contatti: può trovare un contatto per nome, telefono o email, recuperare conversazioni recenti e tag e — con la tua approvazione — aggiornare campi o aggiungere/rimuovere tag per la segmentazione. Chiedile "trova i contatti con tag `vip` che non hanno avuto un inbound negli ultimi 60 giorni" invece di costruire il filtro manualmente.

## Vedi anche

* [Importazione CSV dei contatti](/it/features/contacts-import) — formato di importazione in blocco, limiti e risoluzione dei problemi.
* [Avatar dei contatti](/it/features/contact-avatars) — come vengono rese e caricate le foto profilo.
* [Campagne](/it/features/campaigns) — usare i tag come pubblico di broadcast.
* [Data Model](/it/platform/data-model#piano-dei-canali-e-dei-contatti) — le tabelle sottostanti `contacts`, `tags` e `contact_tag_links`.
