# Contatos

Como a exportação do Contatos funciona, da conexão à solução de problemas.

## Conectar

Clique em “conectar” no cartão Contatos. O painel abre na sua pasta AddressBook, `~/Library/Application Support/AddressBook`: clique em “Selecionar esta pasta”. O Exporter lê só essa pasta, sem pedido de permissão, e lê dela também os seus cartões do iCloud e do Exchange. Depois clique em “escolher pasta de destino”.

## Onde ficam os arquivos

Um arquivo Markdown por cartão, `Anna Kowalski.md`. Duas pessoas com o mesmo nome recebem cada uma um sufixo curto de id, para que nenhum arquivo sobrescreva o outro. Uma pasta logo dentro da sua pasta pessoal, como `~/Documents`, ganha uma pasta `contacts-export` dentro dela; uma mais funda, como `~/Documents/contacts`, é usada como está.

A aba em que o cartão está também define a organização das pastas:

| aba | os arquivos ficam em |
| --- | --- |
| Todos, Recentes | o nível de cima da pasta de exportação |
| Grupos | `groups/<group>/`; um cartão em dois grupos é gravado uma vez, no primeiro |
| Empresas | `companies/<company>/` |

Trocar de aba move os arquivos na próxima sincronização, e o cartão avisa isso abaixo das abas. “Recentes” lista os 100 cartões alterados mais recentemente; as árvores de “Grupos” e “Empresas” terminam com “Sem grupo” e “Sem empresa”.

## O que é exportado

Os cartões marcados no cartão Contatos, com todos os campos que eles têm. Ficam de fora os registros só de e-mail que o Gmail coleta para cada endereço para o qual você escreveu. Não há exportação em vCard ou CSV: para um `.vcf`, use Arquivo > Exportar > Exportar vCard no Contatos.

## Formato

Sempre Markdown.

## O arquivo

Cada chave só aparece quando o cartão tem um valor. Os valores em lista trazem o seu rótulo, como `+1 415 555 0123 (mobile)`.

| chave | contém |
| --- | --- |
| `title` | o nome |
| `aliases` | o apelido e o nome de solteira |
| `id`, `source_url` | o id do cartão e um link `addressbook://` que o abre no Contatos |
| `created`, `modified` | quando o cartão foi criado e alterado pela última vez |
| `organization`, `job_title`, `department` | as linhas de trabalho |
| `birthday` | o aniversário |
| `email`, `phone` | o primeiro e-mail e o primeiro telefone, simples, para modelos |
| `emails`, `phones`, `addresses`, `urls` | todos, cada um com o seu rótulo |
| `social`, `im` | perfis sociais e contas de mensagens |
| `dates`, `relationships` | outras datas e nomes relacionados, como `father: Tom Kowalski` |
| `groups` | os grupos do Contatos a que o cartão pertence |
| `conversations` | links para as conversas do cartão, quando o Mensagens também é exportado |

O corpo traz o nome, a linha do cargo e a nota do cartão:

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

## Grátis e desbloqueado

Seus primeiros 100 cartões entre os que você marcou são exportados e continuam sincronizando grátis, e um cartão apagado devolve a sua vaga; o resto precisa do desbloqueio único ([preços](https://exporter.dev/pricing)).

## Sincronização e ressincronização completa

Depois do primeiro “sincronizar agora”, um cartão editado regrava o seu arquivo enquanto o Exporter está aberto, e o arquivo de um cartão apagado sai na próxima sincronização.

“ressincronização completa” pergunta antes e depois remove apenas os arquivos que o Exporter gravou, grava todos os cartões de novo e escolhe outra vez os 100 grátis. Todo o resto na pasta de exportação fica.

## Problemas e soluções

- “nenhum banco de contatos nessa pasta (escolha a própria pasta AddressBook)”: clique em “conectar” de novo e selecione a pasta em que o painel abre
- os arquivos foram para outras pastas: o cartão mudou de aba. Volte para a aba que você quer e clique em “sincronizar agora”
- falta um cartão: ele passou dos 100 grátis, está desmarcado ou é um registro só de e-mail do Gmail
- um cartão falhou: “última sincronização” mostra um link vermelho “detalhes” com os cartões que falharam e um link “abrir” para cada um

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