Saltar para o conteúdo principal

​
Visão Geral

Este guia orienta-o na importação de relações entre objetos — por exemplo, ligar Pessoas a Empresas ou Oportunidades a Pessoas.
O que pode ser importado: Apenas relações um-para-muitos que apontem para um único tipo de objeto. Relações que apontam para vários tipos de objeto (como Notas ligadas a Pessoas E Empresas) ainda não são suportadas para importação.

​
Compreender as Relações

​
O que é uma relação “Um-para-Muitos”?

Numa relação um-para-muitos:
  • Uma Empresa tem muitas Pessoas (colaboradores)
  • Uma Empresa tem muitas Oportunidades
  • Uma Pessoa tem muitas Tarefas
O lado “um” é o pai. O lado “muitos” é o filho.

​
Relações Comuns no Twenty

​
Passo 1: Identificar os lados “Um” e “Muitos”

Antes de importar, determine qual objeto é o pai e qual é o filho. Pergunte a si mesmo: “UM [Objeto A] tem MUITOS [Objeto B]?”
  • Uma Empresa → Muitas Pessoas ✓ (A Empresa é o pai)
  • Uma Pessoa → Muitas Empresas ✗ (Isto está errado — uma pessoa pertence a uma empresa)

​
Passo 2: Importe primeiro os registos pai

O pai (lado “um”) deve existir no Twenty antes de poder referenciá-lo. Ordem de importação:
  1. Empresas primeiro (sem dependências)
  2. Pessoas em segundo (ligar a Empresas)
  3. Oportunidades em terceiro (ligar a Empresas e/ou Pessoas)
  4. Tarefas/Notas (ligar a qualquer um dos anteriores)
Se o registo pai não existir, a importação falhará.Verifique sempre que as Empresas são importadas antes de importar Pessoas com referências a empresas.

​
Passo 3: Anote o identificador único do pai

Precisa de referenciar o registo pai usando um identificador único. Opções disponíveis:
Recomendado: Use domain para Empresas e email para Pessoas. São legíveis por humanos e fáceis de verificar na sua folha de cálculo.

​
Encontrar o identificador

Se precisar do id:
  1. Exporte os registos pai do Twenty
  2. A exportação inclui a coluna id
  3. Use estes IDs no seu ficheiro de registos filho

​
Passo 4: Verifique se o campo de relação existe

Antes de importar, garanta que o campo de relação existe entre os seus objetos. Para verificar ou criar:
  1. Vá a Definições → Modelo de Dados
  2. Selecione o seu objeto filho (por exemplo, Pessoas)
  3. Procure um campo de relação que aponte para o pai (por exemplo, Empresa)
  4. Se não existir, crie-o:
    • Clique em + Adicionar campo
    • Selecione o tipo Relação
    • Escolha o objeto pai

​
Passo 5: Prepare o seu ficheiro CSV

Adicione uma coluna ao seu CSV de registos filho que faça referência ao pai utilizando o seu identificador único.

​
Exemplo: Pessoas ligadas a Empresas

O seu CSV de Pessoas:
A coluna companyDomain faz referência ao domínio da Empresa.

​
Requisitos de Formato

O formato do domínio é importante!Use https://domain.com (não apenas domain.com). Isto corresponde à forma como a Twenty armazena domínios de Empresas e evita erros de correspondência.

​
Regras Importantes

  1. Correspondência exata obrigatória — o valor deve corresponder exatamente ao registo pai
  2. Mapeie apenas UM identificador único — não inclua companyId E companyDomain
  3. Sensível a maiúsculas/minúsculas — Acme.com ≠ acme.com

​
Passo 6: Carregue e mapeie a relação

  1. Navegue até ao objeto filho (por exemplo, Pessoas)
  2. Clique em ⋮ → Importar registos
  3. Carregue o seu ficheiro CSV
  4. Na etapa de mapeamento de campos:
    • Encontre a sua coluna de relação (por exemplo, companyDomain)
    • Mapeie-a para o campo de relação Empresa
  5. Conclua o mapeamento restante
  6. Revise os erros e confirme
A Twenty ligará automaticamente cada registo filho ao pai correspondente.

​
Passo 7: Verifique a importação

Após a importação:
  1. Abra alguns registos filho (por exemplo, Pessoas)
  2. Verifique se o campo de relação mostra o pai correto (por exemplo, Empresa)
  3. Abra um registo pai e verifique a secção de registos relacionados

​
Erros Comuns a Evitar

​
Ligar a Membros do Espaço de Trabalho

Ao ligar a Membros do Espaço de Trabalho (a sua equipa):
  • Use o endereço de email deles, não o nome
  • Exemplo: owner@yourcompany.com, não “John Smith”

​
Perguntas Frequentes

Tem duas opções:
  1. Use o id da Twenty (exporte os registos pai para obter os respetivos IDs)
  2. Crie um campo único personalizado no seu modelo de dados para armazenar um ID externo do seu sistema anterior
Sim! Inclua o identificador único do registo filho (por exemplo, email para Pessoas) e o novo valor da relação. A importação atualizará a relação.
Relações muitos-para-muitos ainda não são suportadas para importação. Isto está planeado para o 1.º semestre de 2026.
Relações que apontam para vários tipos de objeto ainda não são suportadas para importação/exportação. Isto está no nosso roadmap.
A importação mostrará um erro para essa linha. Você pode:
  • Importe primeiro o registo pai e depois volte a importar
  • Corrija o valor de referência
  • Remova a linha da importação
Causas comuns:
  • Formato incorreto (use https://domain.com para domínios)
  • Incompatibilidade de maiúsculas/minúsculas (verifique a grafia exata)
  • O pai não existe (importe primeiro os pais)
  • Mapeamento de vários identificadores (use apenas um)
Lembre-se: registos eliminados logicamente contam para a unicidade.Se estiver a receber erros de “not found”, mas o registo parece existir, verifique Menu de Comandos → Ver registos eliminados. O pai pode ter sido eliminado logicamente.

​
Resolução de Problemas

Está a ter problemas? Consulte: