Skip to main content
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.
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.