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

# Exportações e alterações de dados por agentes

> Exporte campos selecionados e revise exclusões e liberações da lista de supressão.

Essas ferramentas dependem da ativação da fase de importações e dados. Chaves pessoais existentes não recebem novas permissões automaticamente. Cobrança, pagamentos, créditos, faturas e gestão de assinaturas não fazem parte do MCP.

Descubra a conta, as equipes e os projetos antes de agir. Informe `project_id` explicitamente em cada chamada. Os escopos e os acessos salvos na chave continuam limitados pela participação e pelo papel atual do proprietário.

## Exportar contatos

O escopo separado `exports.read` permite usar `contacts_export`. Selecione os campos de perfil em `fields`; IDs e e-mails sempre acompanham o resultado. O MCP retorna até 100 registros por página e a API/SDK até 500, com limite de um MiB por resposta. Preserve `metadata.next` como `after` enquanto `metadata.has_more` for verdadeiro, inclusive quando uma página vier menor.

Registros com campos selecionados acima de 64 KiB retornam `ExportRowTooLarge` sem o conteúdo do perfil. Reduza os campos ou corrija os dados.

```bash theme={null}
sendrealm-export --project-id PROJECT_UUID --file contatos.csv \
  --format csv --fields first_name,last_name
```

O helper `exportContactsFile`, em `@sendrealm/sdk/contact-export`, aceita CSV, JSON e NDJSON. Ele processa páginas em fluxo, protege células CSV contra fórmulas, não sobrescreve arquivos existentes e remove apenas sua própria saída incompleta em caso de falha. A exportação não altera contatos nem dispara mensagens.

## Revisar exclusões

Use `contacts_delete_prepare`, `audiences_delete_prepare`, `audience_properties_delete_prepare` ou `topics_delete_prepare` com 1 a 500 IDs explícitos. Revise os efeitos e as quantidades de relações afetadas. Contatos, propriedades e públicos exigem `audiences.delete`; tópicos exigem `topics.delete`.

A preparação dura dez minutos e vincula a pessoa, a chave, o projeto, os acessos e as versões dos recursos. Execute a ferramenta correspondente com `prepared_action_id` e uma `idempotency_key` estável. Uma repetição retorna o mesmo recibo. Preparações desatualizadas exigem nova revisão.

A exclusão arquiva registros e vínculos, preservando o histórico de entregas. Mensagens já enfileiradas e automações em execução não são canceladas. A remoção da definição de uma propriedade preserva valores históricos; rascunhos e regras podem precisar de correção.

Eventos de exclusão de contatos usam `automation_effects: suppress` por padrão. O modo `trigger` exige `automations.trigger` e capacidade atual de gerenciar automações. A publicação durável mantém a identidade e a política nas repetições; perda de autorização antes da publicação reduz a política para supressão.

## Lista de supressão

Importações não removem supressões de entrega nem restauram cancelamentos de inscrição existentes. Consulte `suppressions_list` e, com `suppressions.write`, use `suppressions_reallow_prepare` seguido de `suppressions_reallow` após revisar os efeitos.

A liberação adiciona uma entrada no histórico e permite tentativas futuras; preferências de inscrição permanecem intactas. Novos retornos do provedor invalidam preparações anteriores. A operação de liberação não envia mensagens.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.