Saltar para o conteúdo principal

​
Visão Geral

Precisa de atualizar muitos registos de uma só vez? Em vez de os editar um a um, utilize a importação CSV para atualizar em massa os registos existentes. Casos de uso:
  • Atualizar cargos para várias pessoas
  • Alterar informações da empresa em massa
  • Adicionar dados a novos campos personalizados
  • Corrigir erros de dados em muitos registos

​
Como Funciona

Quando importar um ficheiro que contenha um identificador único que corresponde a um registo existente, a Twenty atualiza esse registo em vez de criar um duplicado.
Se o identificador único…A Twenty irá…
Corresponde a um registo existenteAtualizar o registo existente
Não corresponde a nenhum registoCriar um novo registo
Está em falta no ficheiroCriar um novo registo (com ID gerado automaticamente)
Os campos de seleção múltipla são substituídos, não combinados.Se um registo tiver Option A e Option B selecionadas, e importar [\"Option C\"], o registo terá apenas Option C após a importação. A importação substitui todas as seleções anteriores — não as adiciona.Para manter os valores existentes, inclua-os todos na sua importação: [\"Option A\",\"Option B\",\"Option C\"]

​
Passo 1: Exportar os Seus Dados Atuais

Primeiro, exporte os registos que pretende atualizar:
  1. Navegue até ao objeto (Pessoas, Empresas, etc.)
  2. Adicione as colunas de que precisa — clique em Options → Fields para mostrar os campos que quer atualizar
  3. Filtre se necessário — restrinja apenas aos registos que pretende atualizar
  4. Clique em ⋮ → Export view
  5. Guarde o ficheiro CSV
Porquê exportar primeiro? O ficheiro exportado tem o formato correto, inclui identificadores únicos e é mapeado automaticamente durante a importação.

​
O Que É Exportado

  • Todas as colunas visíveis na sua vista atual
  • Os identificadores únicos do registo (id, email, domain)
  • Valores atuais de campos que pode modificar

​
Passo 2: Editar o Ficheiro CSV

Abra o ficheiro exportado na sua aplicação de folha de cálculo (Excel, Google Sheets, etc.):
  1. Mantenha a coluna do identificador único — não elimine id, email ou domain
  2. Atualize os valores nas colunas que quer alterar
  3. Remova as colunas que não precisa de atualizar (opcional, mas mais limpo)
  4. Não altere os valores do identificador único — caso contrário a Twenty criará novos registos

​
Exemplo: Atualizar Cargos

Ficheiro exportado: 
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Sales Rep
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Sales Rep
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Sales Rep
Após as suas alterações: 
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Account Executive
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Senior Account Executive
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Account Executive
Não altere os valores do identificador único.Se alterar john@acme.com para john.smith@acme.com, a Twenty criará um novo registo em vez de atualizar o existente.

​
Passo 3: Importar o Ficheiro Atualizado

  1. Navegue até ao objeto
  2. Clique em ⋮ → Import records
  3. Carregue o seu ficheiro CSV editado
  4. Garanta que o identificador único está mapeado — verifique se email, domain ou id está mapeado corretamente
  5. Revise o mapeamento dos campos
  6. Verifique se há erros
  7. Clique em Confirm
A Twenty faz a correspondência dos registos pelo identificador único e atualiza-os com novos valores.

​
Escolher o Identificador Único Correto

ObjetoRecomendadoAlternativaNotas
PessoasemailidO email é legível por humanos
EmpresasdomínioidO domínio é legível por humanos
Objetos personalizadosQualquer campo únicoidUse o seu campo único personalizado
Utilize apenas UM identificador único. Não mapeie email E id. Isto pode causar confusão e erros.

​
Utilizar Campos Únicos Personalizados

Se tiver um campo personalizado marcado como único (como um ID externo de outro sistema):
  1. Inclua esse campo na exportação e importação
  2. Mapeie-o durante a importação
  3. A Twenty fará a correspondência com base nesse campo

​
Passo 4: Verificar as Atualizações

Após a importação:
  1. Abra alguns registos atualizados
  2. Verifique se as alterações foram aplicadas
  3. Confirme que não foram criados registos duplicados

​
E os Campos que Não Estão no seu Ficheiro?

Os campos não incluídos no seu ficheiro de importação permanecem inalterados.
O seu ficheiro inclui…Resultado
email, jobTitleApenas jobTitle é atualizado; os outros campos permanecem iguais
email, jobTitle, phonejobTitle e phone são atualizados
Isto significa que só precisa de incluir os campos que pretende alterar (além do identificador único).

​
Combinar Atualizações e Novos Registos

Pode atualizar registos existentes e criar novos na mesma importação: 
email,firstName,lastName,jobTitle
john@acme.com,John,Smith,Senior Manager    ← Updates existing (email matches)
newperson@acme.com,New,Person,Analyst      ← Creates new (email doesn't match)

​
Erros Comuns a Evitar

ErroProblemaResultadoSolução
Alterar o identificador únicoAlterado de john@acme.com para john.smith@acme.comCria um novo registo em vez de atualizarMantenha os identificadores únicos inalterados
Vários campos únicosMapear email E idPotenciais conflitos de correspondênciaMapeie apenas UM identificador único
Sem identificador únicoO ficheiro tem apenas firstName, lastName, jobTitleTodas as linhas criam novos registosInclua sempre email, domain ou id
Incompatibilidade de maiúsculas/minúsculasO ficheiro tem John@acme.com, mas a Twenty tem john@acme.comCria novo registoExporte da Twenty para obter os valores exatos

​
Perguntas Frequentes

Registos com identificadores únicos que não correspondam a registos existentes serão criados como novos registos. Isto permite-lhe atualizar e criar na mesma importação.
Sim, deixe a célula vazia no seu CSV. A importação irá limpar o valor desse campo no registo existente.
Os campos que não estão no ficheiro de importação permanecem inalterados nos registos existentes. Apenas os campos que incluir são atualizados.
Sim! Inclua o identificador único da relação (por exemplo, companyDomain) e faça o mapeamento para o campo de relação. A relação será atualizada.
Durante a etapa de revisão da importação, a Twenty mostra quantos registos serão atualizados vs. criados com base nas correspondências do identificador único.
Não existe desfazer automático. Recomendamos exportar os seus dados como cópia de segurança antes de fazer atualizações em massa.

​
Melhores Práticas

  1. Exporte primeiro — comece sempre a partir de uma exportação para garantir o formato correto
  2. Faça uma cópia de segurança antes de atualizar — exporte os seus dados antes de fazer alterações em massa
  3. Teste com alguns registos — tente atualizar primeiro 5–10 registos antes de fazer um lote grande
  4. Utilize identificadores legíveis por humanos — email e domain são mais fáceis de verificar do que id
  5. Inclua apenas as colunas necessárias — menos colunas significa menor probabilidade de erros

​
Resolução de Problemas

Está a ter problemas? Consulte: