# Контакти

Як працює експорт Контактів, від під’єднання до розв’язання проблем.

## Під’єднання

Натисніть «підключити» на картці Контактів. Панель відкривається в папці AddressBook, `~/Library/Application Support/AddressBook`: натисніть «Вибрати цю папку». Exporter читає лише цю папку, без запиту на доступ, і звідти ж читає ваші картки iCloud і Exchange. Потім натисніть «обрати теку».

## Куди потрапляють файли

Один файл Markdown на картку, `Anna Kowalski.md`. Двоє людей з однаковим іменем отримують кожен короткий суфікс з ідентифікатором, тож жоден файл не перезаписує інший. Папка просто у вашій домашній папці, як-от `~/Documents`, отримує всередині папку `contacts-export`; глибша, як-от `~/Documents/contacts`, використовується як є.

Вкладка, на якій залишено картку, задає й розкладку папок:

| вкладка | файли потрапляють у |
| --- | --- |
| Усі, Останні | верхній рівень папки експорту |
| Групи | `groups/<group>/`; картка у двох групах записується один раз, у першій |
| Компанії | `companies/<company>/` |

Зміна вкладки переміщує файли під час наступної синхронізації, і картка повідомляє про це під вкладками. «Останні» перелічує 100 нещодавно змінених карток; дерева «Групи» й «Компанії» закінчуються пунктами «Без групи» і «Без компанії».

## Що експортується

Позначені на картці картки контактів з усіма їхніми полями. Пропускаються записи з самою адресою email, які Gmail збирає для кожної адреси, на яку ви писали. Експорту у vCard чи CSV немає: щоб отримати `.vcf`, скористайтеся в Контактах командою «Файл» > «Експортувати» > «Експортувати vCard».

## Формат

Завжди Markdown.

## Файл

Кожен ключ з’являється, лише коли на картці є значення. Значення списків мають свою мітку, як-от `+1 415 555 0123 (mobile)`.

| ключ | містить |
| --- | --- |
| `title` | ім’я |
| `aliases` | псевдонім і дівоче прізвище |
| `id`, `source_url` | ідентифікатор картки й посилання `addressbook://`, яке відкриває її в Контактах |
| `created`, `modified` | коли картку створено й востаннє змінено |
| `organization`, `job_title`, `department` | робочі рядки |
| `birthday` | день народження |
| `email`, `phone` | перший email і телефон, простими значеннями, для шаблонів |
| `emails`, `phones`, `addresses`, `urls` | усі, кожен зі своєю міткою |
| `social`, `im` | профілі в соцмережах і облікові записи месенджерів |
| `dates`, `relationships` | інші дати й пов’язані імена, як-от `father: Tom Kowalski` |
| `groups` | групи Контактів, до яких належить картка |
| `conversations` | посилання на розмови картки, якщо Повідомлення теж експортовано |

Основна частина містить ім’я, посаду та примітку картки:

```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.
```

## Безкоштовно й після розблокування

Перші 100 карток серед позначених експортуються й синхронізуються безкоштовно, а видалена картка звільняє своє місце; решта потребує одноразового розблокування ([ціни](https://exporter.dev/pricing)).

## Синхронізація й повна ресинхронізація

Після першого «синхронізувати зараз» змінена картка переписує свій файл, доки Exporter працює, а файл видаленої картки зникає під час наступної синхронізації.

«повна ресинхронізація» спершу питає підтвердження, потім видаляє лише файли, які записав Exporter, знову записує всі картки й знову вибирає безкоштовні 100. Усе інше в папці експорту залишається.

## Проблеми й рішення

- «у цій папці немає бази даних контактів (виберіть саму папку AddressBook)»: знову натисніть «підключити» й виберіть папку, в якій відкрилася панель
- файли перемістилися в інші папки: картку перемкнули на іншу вкладку. Поверніться на потрібну вкладку й натисніть «синхронізувати зараз»
- бракує картки: вона понад безкоштовні 100, не позначена або є записом із самою адресою email з Gmail
- картку не вдалося експортувати: «остання синхронізація» показує червоне посилання «деталі» з картками, які не вдалося експортувати, і посиланням «відкрити» для кожної

## 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/uk/docs/contacts
every page: https://exporter.dev/llms.txt