Sua lista do Substack cabe num CSV — a migração pode sobrescrever dados

Para levar os assinantes do Substack ao Kit, exporte a lista em CSV, preserve o arquivo original e prepare uma cópia apenas com o e-mail e os campos que devem ser atualizados. Mapeie essa cópia no Kit, faça primeiro uma importação pequena e só então processe o restante da audiência.
O ponto crítico são os assinantes que já existem no Kit. Se uma coluna do CSV for importada para um campo desses perfis, o valor atual poderá ser substituído pelo conteúdo da planilha, inclusive por uma célula vazia. Por isso, uma coluna desnecessária deve ser removida, não apenas deixada em branco.
1. Preserve a exportação completa do Substack

No painel da publicação, abra Subscribers, desça até All subscribers, clique no menu de três pontos e selecione Export. A documentação de exportação do Substack permite baixar um CSV com todas as colunas ou somente as visíveis, além de exportar assinantes selecionados; ela também informa que os nomes dos assinantes não estão disponíveis nessa operação.
Escolha todas as colunas para criar o backup mais abrangente, salve-o sem alterações e faça a limpeza em uma duplicata. Identifique claramente o arquivo original e a cópia de trabalho. Se uma importação modificar dados indevidamente, o backup preserva o que saiu da plataforma de origem, embora não substitua uma cópia prévia dos dados que já estavam no Kit.
A ausência dos nomes merece atenção. Não preencha essa informação por inferência e não crie uma coluna vazia apenas para imitar um modelo de importação: se alguns endereços já tiverem nomes no Kit, enviar o campo em branco poderá apagar esses valores.
2. Deixe no CSV somente o que deve mudar
Na cópia de trabalho, mantenha uma linha de cabeçalhos e uma linha para cada registro. Antes de alterar a planilha, anote três contagens: total de linhas de dados, endereços de e-mail preenchidos e endereços únicos. Elas não precisam coincidir, pois podem existir linhas sem e-mail ou endereços repetidos.
Use esta correspondência para decidir o destino de cada coluna:
- E-mail do Substack → endereço de e-mail no Kit: é a identificação mínima de cada assinante e não pode ficar vazio.
- Campo com equivalente confirmado → campo do Kit: só mantenha a coluna quando origem e destino tiverem o mesmo significado.
- Dado sem destino compatível → somente no backup: não transforme plano, atividade ou data em outro tipo de informação para aproveitar a coluna.
- Classificação da migração → tag: use um nome inequívoco para a origem ou para o lote.
- Nome não exportado → coluna ausente: não converta a falta do dado em uma atualização vazia.
Remova da cópia as linhas sem e-mail, corrija espaços acidentais nos endereços e localize duplicatas. A limpeza não deve apagar nada do arquivo original. Ela serve para reduzir a importação ao conjunto exato de alterações pretendidas.
3. Mapeie campos e tags como dados diferentes

O procedimento de importação do Kit exige pelo menos uma coluna de e-mail e cabeçalhos para as colunas; permite mapear cada coluna para um campo existente ou novo e orienta associar tags à opção de lista separada por vírgulas. A mesma página confirma que dados de campos podem substituir valores existentes, inclusive por vazios em determinados campos, enquanto as tags atuais são preservadas e as novas são acrescentadas.
Uma coluna não mapeada não é importada, mas isso não dispensa a limpeza prévia: remover o que não será usado torna a conferência mais simples. Para os campos mantidos, revise cada cabeçalho e o respectivo destino. Um campo chamado “plano” no arquivo, por exemplo, não deve ser associado a outro campo apenas porque ambos aceitam texto.
Revise também a grafia das tags antes do envio. Uma variação de nome pode criar outra tag, e adicionar assinantes a tags ou formulários usados como gatilhos pode colocá-los em automações. Se o lote não deve iniciar esses fluxos, pause as regras relacionadas antes da importação e não o adicione diretamente a uma sequência de e-mails.
4. Teste sem expor toda a audiência

Crie um CSV pequeno com registros controlados que representem os casos relevantes: um endereço novo, um perfil que já existe no Kit e uma linha com o campo que você pretende atualizar. Para verificar a preservação de um dado existente, use um perfil cujo valor atual tenha sido registrado no backup e não inclua essa coluna no arquivo destinado a preservá-lo.
Quando apenas parte da audiência possui um valor válido para determinado campo, não é possível retirar a coluna de uma única linha. Separe a operação em dois arquivos: o primeiro contém a coluna e somente os assinantes que devem recebê-la; o segundo contém os demais registros sem essa coluna. Deixar células vazias no mesmo arquivo mantém o risco de sobrescrita.
No Kit, abra Subscribers, selecione Add Subscribers e depois Import CSV. Envie o lote de teste, confira o mapeamento coluna por coluna e aplique uma tag exclusiva para localizá-lo. Após a conclusão, abra os perfis testados e verifique os campos anteriores, os novos valores, as tags e o status de cada assinante.
5. Reconcilie a importação antes do primeiro envio
Com o teste aprovado, mantenha a mesma estrutura para os arquivos restantes. Espere a confirmação de conclusão do processamento e filtre a audiência pela tag do lote. Compare a quantidade de endereços únicos do CSV com os perfis alcançados e examine uma amostra de registros novos e preexistentes.
O guia de verificação pós-importação do Kit explica que endereços já presentes na conta e duplicatas no próprio CSV não são contados como novos assinantes, enquanto contatos que haviam cancelado a inscrição não são reativados automaticamente; também informa que uma cópia anterior pode ser reimportada para reparar dados sobrescritos.
Assim, o aumento bruto exibido no painel não basta para validar a migração. Confira os endereços únicos, a tag aplicada, o status dos contatos e os valores de uma amostra de perfis. Só depois dessa reconciliação reative as automações pausadas ou prepare um envio para a lista migrada.
O controle final reúne oito pontos: backup original preservado, cópia de trabalho limpa, e-mails preenchidos, duplicatas identificadas, cabeçalhos mapeados, colunas vazias removidas, tags revisadas e lote de teste conferido. O CSV continua sendo simples; o que protege a base é limitar com precisão quais dados ele poderá atualizar.
Leia também:
Assine nossa newsletter
Receba as últimas notícias sobre Web3, IA e cripto diretamente no seu e-mail.