# Contatti

Come funziona l'esportazione di Contatti, dal collegamento alla soluzione dei problemi.

## Collegare

Prema “collega” sulla scheda Contatti. Il pannello si apre nella sua cartella AddressBook, `~/Library/Application Support/AddressBook`: prema “Seleziona questa cartella”. Exporter legge solo quella cartella, senza richieste di permesso, e da lì legge anche le sue schede di iCloud ed Exchange. Poi prema “scegli la cartella”.

## Dove vanno i file

Un file Markdown per scheda, `Anna Kowalski.md`. Due persone con lo stesso nome ricevono ciascuna un breve suffisso id, così nessun file sovrascrive l'altro. Una cartella direttamente dentro la sua cartella Inizio, come `~/Documents`, riceve al suo interno una cartella `contacts-export`; una più profonda, come `~/Documents/contacts`, viene usata così com'è.

La vista su cui si trova la scheda è anche la disposizione delle cartelle:

| vista | i file finiscono in |
| --- | --- |
| Tutti, Recenti | il primo livello della cartella di esportazione |
| Gruppi | `groups/<group>/`; una scheda in due gruppi viene scritta una volta sola, sotto il primo |
| Aziende | `companies/<company>/` |

Cambiare vista sposta i file alla sincronizzazione successiva, e la scheda lo dice sotto le viste. Recenti elenca le 100 schede modificate più di recente; gli alberi Gruppi e Aziende terminano con “Senza gruppo” e “Senza azienda”.

## Cosa viene esportato

Le schede selezionate sulla scheda Contatti, con tutti i campi che hanno. Restano fuori: le voci con la sola email che Gmail raccoglie per ogni indirizzo a cui ha scritto. Non c'è un'esportazione vCard o CSV: per un `.vcf`, usi Archivio > Esporta > Esporta vCard in Contatti.

## Formato

Sempre Markdown.

## Il file

Ogni chiave compare solo quando la scheda ha un valore. I valori degli elenchi portano la loro etichetta, come `+1 415 555 0123 (mobile)`.

| chiave | contiene |
| --- | --- |
| `title` | il nome |
| `aliases` | il soprannome e il cognome da nubile |
| `id`, `source_url` | l'id della scheda, e un link `addressbook://` che la apre in Contatti |
| `created`, `modified` | quando la scheda è stata creata e modificata l'ultima volta |
| `organization`, `job_title`, `department` | le righe sul lavoro |
| `birthday` | il compleanno |
| `email`, `phone` | la prima email e il primo telefono, semplici, per i modelli |
| `emails`, `phones`, `addresses`, `urls` | tutti, ciascuno con la sua etichetta |
| `social`, `im` | profili social e account di messaggistica |
| `dates`, `relationships` | altre date e nomi correlati, come `father: Tom Kowalski` |
| `groups` | i gruppi di Contatti a cui appartiene la scheda |
| `conversations` | link alle conversazioni della scheda, quando è esportato anche Messaggi |

Il corpo contiene il nome, la riga del lavoro e la nota della scheda:

```markdown
---
title: "Anna Kowalski"
id: "410FE041:ABPerson"
created: 2019-04-02T10:15:33
modified: 2026-08-30T19:02:11
source_url: "addressbook://410FE041:ABPerson"
organization: "Northwind Studio"
job_title: "Art director"
birthday: 1990-12-10
email: "anna@northwind.example"
phone: "+1 415 555 0123"
phones:
  - "+1 415 555 0123 (mobile)"
groups:
  - "Studio"
---

# Anna Kowalski

Art director · Northwind Studio

Met at the print fair.
```

## Gratis e sbloccato

Le prime 100 schede tra quelle selezionate si esportano e restano sincronizzate gratis, e una scheda eliminata libera il suo posto; le altre richiedono lo sblocco una tantum ([prezzi](https://exporter.dev/pricing)).

## Sincronizzazione e risincronizzazione completa

Dopo il primo “sincronizza ora”, una scheda modificata riscrive il suo file finché Exporter è in esecuzione, e il file di una scheda eliminata esce alla sincronizzazione successiva.

“risincronizza tutto” chiede prima conferma, poi rimuove solo i file scritti da Exporter, riscrive tutte le schede e sceglie di nuovo le 100 gratuite. Tutto il resto nella cartella di esportazione rimane.

## Problemi e soluzioni

- “nessun database dei contatti in quella cartella (selezioni la cartella AddressBook stessa)”: prema di nuovo “collega” e selezioni la cartella in cui si apre il pannello
- i file sono finiti in altre cartelle: la scheda è passata a un'altra vista. Torni alla vista che vuole e prema “sincronizza ora”
- manca una scheda: è oltre le 100 gratuite, deselezionata, oppure è una voce di Gmail con la sola email
- una scheda non riuscita: `ultima sincronizzazione` mostra un link rosso “dettagli” con le schede non riuscite e un link “apri” a ciascuna

## Related

- [Contacts](https://exporter.dev/contacts): Every contact card as a Markdown file
- [Contacts guides](https://exporter.dev/guides/contacts): People notes in Obsidian
- [Messages](https://exporter.dev/docs/messages): Conversations, media, fields and fixes

---

human version: https://exporter.dev/it/docs/contacts
every page: https://exporter.dev/llms.txt