snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/pt/user-guide/ai/capabilities/ai-agents.mdx

@@ -0,0 +1,30 @@
+---
+title: Agentes de IA
+description: Integre recursos de IA diretamente aos seus fluxos de trabalho de automação.
+---
+
+## Visão geral
+
+Integre recursos de IA diretamente aos seus fluxos de trabalho de automação para processamento de dados inteligente e tomada de decisões.
+
+## Capacidades
+
+| Recurso                     | Descrição                                             |
+| --------------------------- | ----------------------------------------------------- |
+| **Ações de IA**             | Adicione etapas com IA a qualquer fluxo de trabalho   |
+| **Enriquecimento de Dados** | Aprimore registros automaticamente com dados externos |
+| **Classificação**           | Classifique registros com base na análise de conteúdo |
+| **Sumarização**             | Gere resumos a partir de campos de texto              |
+| **Prompts personalizados**  | Defina exatamente como a IA processa seus dados       |
+
+## Casos de uso
+
+* **Pontuação de leads**: Pontue e priorize automaticamente os leads recebidos
+* **Limpeza de dados**: Padronize nomes de empresas e informações de contato
+* **Rascunhos de e-mail**: Gere e-mails de acompanhamento com base em notas de reunião
+* **Roteamento de registros**: Atribua registros ao membro certo da equipe com base no conteúdo
+
+## Relacionados
+
+* [Visão geral de fluxos de trabalho](/l/pt/user-guide/workflows/overview) — noções básicas de automação
+* [Permissões de IA](/l/pt/user-guide/ai/capabilities/permissions-access-control) — controle de acesso para agentes de IA

packages/twenty-docs/l/pt/user-guide/ai/capabilities/ai-chatbot.mdx

@@ -0,0 +1,37 @@
+---
+title: Chatbot de IA
+description: Um assistente inteligente que ajuda você a interagir com seus dados de CRM usando linguagem natural.
+---
+
+## Visão geral
+
+Faça perguntas no idioma natural e o assistente recupera e explica os seus dados de CRM para você.
+
+## Capacidades
+
+| Recurso                            | Descrição                                                                                  |
+| ---------------------------------- | ------------------------------------------------------------------------------------------ |
+| **Consultas em linguagem natural** | Faça perguntas em inglês simples em vez de criar filtros                                   |
+| **Acesso total aos dados**         | Consulte registros, relacionamentos e métricas em todo o seu espaço de trabalho            |
+| **Contexto da página**             | Faça referência a "esta empresa" ou "esta oportunidade" com base na sua visualização atual |
+| **Conversacional**                 | Perguntas de acompanhamento mantêm o contexto das consultas anteriores                     |
+
+## Exemplos de interações
+
+### Encontrar registros
+
+* "Mostre-me todas as oportunidades acima de US$ 50.000"
+* "Encontre contatos para os quais não enviei e-mail há 2 semanas"
+* "Liste empresas do setor de saúde"
+
+### Obtendo insights
+
+* "Qual é o valor total do meu pipeline?"
+* "Quantos negócios foram fechados no mês passado?"
+* "Em qual etapa há mais oportunidades estagnadas?"
+
+### Usando o contexto da página
+
+* "Resuma minhas interações com esta pessoa" (em uma página de contato)
+* "Quais oportunidades estão vinculadas a esta empresa?" (em uma página da empresa)
+* "Quando este negócio foi atualizado pela última vez?" (em uma página de oportunidade)

packages/twenty-docs/l/pt/user-guide/ai/capabilities/mcp.mdx

@@ -0,0 +1,137 @@
+---
+title: Servidor MCP
+description: Conecte assistentes de IA ao seu espaço de trabalho do Twenty usando o Model Context Protocol.
+---
+
+O Twenty expõe um servidor [MCP](https://modelcontextprotocol.io/) para que assistentes de IA — Claude Desktop, Claude Code, Cursor, ChatGPT e outros — possam ler e escrever seus dados de CRM por meio de linguagem natural.
+
+Use o **URL do espaço de trabalho** (o URL que você usa para acessar o Twenty) como o endpoint do MCP. Na Twenty Cloud, o URL do seu espaço de trabalho pode ser `https://{mycompany}.twenty.com` ou um domínio personalizado. O servidor está disponível em:
+
+| Ambiente           | Endpoint do MCP                                                                      |
+| ------------------ | ------------------------------------------------------------------------------------ |
+| **Nuvem**          | `https://{your-workspace-url}/mcp` (por exemplo, `https://mycompany.twenty.com/mcp`) |
+| **Auto-hospedado** | `https://{your-domain}/mcp`                                                          |
+
+## Métodos de autenticação
+
+Você tem duas maneiras de autenticar seu cliente MCP: **OAuth** (recomendado) ou **Chave de API**.
+
+### Opção A — OAuth (recomendado)
+
+Com o OAuth, seu cliente MCP abre uma janela do navegador para você fazer login. Nenhum segredo é armazenado em arquivos de configuração, e os tokens são atualizados automaticamente.
+
+<Note>
+O OAuth requer um cliente MCP que ofereça suporte à [especificação de Autorização MCP](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). Claude Desktop, Claude Code, Cursor e ChatGPT oferecem suporte.
+</Note>
+
+Adicione isto à configuração do seu cliente MCP, substituindo `{your-workspace-url}` pelo host do seu espaço de trabalho (por exemplo, `mycompany.twenty.com`):
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp"
+    }
+  }
+}
+```
+
+É isso — nenhuma chave de API é necessária. Quando o cliente se conectar pela primeira vez, ele irá:
+
+1. Descobrir os metadados de OAuth do Twenty por meio de `/.well-known/oauth-protected-resource` e `/.well-known/oauth-authorization-server`
+2. Registrar-se como um cliente OAuth por meio de registro dinâmico de cliente (RFC 7591)
+3. Abrir seu navegador para autorizar o acesso
+4. Receber tokens e conectar-se ao servidor MCP
+
+Conexões subsequentes reutilizam os tokens armazenados e os atualizam automaticamente.
+
+### Opção B — Chave de API
+
+Se o seu cliente MCP não oferecer suporte a OAuth, ou se você preferir credenciais estáticas, passe uma chave de API no cabeçalho `Authorization`:
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+<Warning>
+Sua chave de API concede acesso aos dados do espaço de trabalho. Mantenha-a fora do controle de versão e de dotfiles compartilhados.
+</Warning>
+
+Para criar uma chave de API, vá em **Settings → MCP & APIs → API → + Create key**. Veja [APIs](/l/pt/developers/extend/api#create-an-api-key) para detalhes.
+
+## Início rápido
+
+### 1. Copie a configuração
+
+Vá até **Settings → MCP & APIs → MCP** no Twenty. Escolha seu método de autenticação (OAuth ou Chave de API), copie o trecho de JSON (ele já usará o URL do seu espaço de trabalho) e cole-o no arquivo de configuração do seu cliente MCP.
+
+| Cliente            | Local do arquivo de configuração                                                                                                                                                   |
+| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) ou `%APPDATA%\Claude\claude_desktop_config.json` (Windows)                                               |
+| **Claude Code**    | `~/.claude.json` (usuário) ou `.mcp.json` (projeto)                                                                                                                                |
+| **Cursor**         | `.cursor/mcp.json` no seu projeto, ou `~/.cursor/mcp.json` globalmente                                                                                                             |
+| **ChatGPT**        | Ative o Modo Desenvolvedor em **Settings → Apps & Connectors → Advanced settings** e, em seguida, use **Create** em **Settings → Apps & Connectors** para adicionar o servidor MCP |
+
+### 2. Conectar
+
+Reinicie seu cliente MCP (ou recarregue a configuração). Se estiver usando OAuth, você será redirecionado ao Twenty para autorizar o acesso. Se estiver usando uma chave de API, a conexão é imediata.
+
+### 3. Comece a usá-lo
+
+Peça ao seu assistente de IA para interagir com seu CRM:
+
+* *"Mostre-me as 5 empresas criadas mais recentemente"*
+* *"Crie uma nova pessoa chamada Jane Doe na Acme Corp"*
+* *"Encontre todas as oportunidades em aberto com valor superior a $10k"*
+
+## Ferramentas disponíveis
+
+Depois de conectado, o servidor MCP expõe ferramentas que refletem a API do Twenty. O fluxo de trabalho recomendado é:
+
+1. **`learn_tools`** — obter o esquema de entrada para ferramentas específicas
+2. **`execute_tool`** — executar uma ferramenta
+
+Você não precisa se lembrar dos nomes das ferramentas. Pergunte ao seu assistente de IA o que ele pode fazer e ele chamará `learn_tools` automaticamente.
+
+## Permissões
+
+As conexões MCP herdam as permissões do usuário autenticado (OAuth) ou da função atribuída à chave de API. Para restringir o que o servidor MCP pode fazer:
+
+* **OAuth**: Aplica-se à função do espaço de trabalho do usuário.
+* **Chave de API**: Atribua uma função à chave de API em **Settings → Members → Roles**. Veja [Permissões](/l/pt/user-guide/permissions-access/capabilities/permissions).
+
+## Configuração auto-hospedada
+
+Para instâncias auto-hospedadas, substitua `{your-workspace-url}` pelo URL do seu servidor. Certifique-se de que `SERVER_URL` no seu ambiente corresponda ao URL público da sua instância do Twenty — isso é usado para gerar os metadados de descoberta do OAuth.
+
+```bash
+SERVER_URL=https://twenty.yourcompany.com
+```
+
+O endpoint do MCP, os endpoints de OAuth e os metadados de descoberta derivam todos desse valor.
+
+## Resolução de Problemas
+
+**Erros "Unauthorized" ou 401**
+
+* OAuth: autorize novamente limpando os tokens armazenados no seu cliente MCP e reconectando.
+* Chave de API: verifique se a chave é válida e não expirou. Gere-a novamente, se necessário.
+
+**O fluxo do OAuth não abre um navegador**
+
+* Garanta que seu cliente MCP ofereça suporte à Autorização MCP. Se não oferecer, utilize o método de Chave de API.
+
+**Tempo limite de conexão**
+
+* Confirme que o URL do endpoint MCP é acessível a partir da sua máquina. Para instâncias auto-hospedadas, verifique se o servidor está em execução e se `SERVER_URL` está definido corretamente.

packages/twenty-docs/l/pt/user-guide/ai/capabilities/permissions-access-control.mdx

@@ -0,0 +1,35 @@
+---
+title: Permissões e Controle de Acesso
+description: Controle o que os agentes de IA podem acessar e modificar no seu espaço de trabalho.
+---
+
+## Visão Geral
+
+Os agentes de IA respeitam sua estrutura de permissões existente. Isso é particularmente importante para equipes que desejam controlar exatamente o que processos de IA automatizados podem acessar ou modificar em seu espaço de trabalho.
+
+## Atribuir uma Função a um Agente de IA
+
+1. Vá para **Configurações → Membros → Funções**
+2. Clique na função que deseja atribuir
+3. Abra a aba de **Atribuição**
+4. Em **Agentes de IA**, clique em **+ Atribuir ao agente de IA**
+5. Selecione o agente de IA da lista
+6. Confirme a atribuição
+
+## Por que Atribuir Funções a Agentes de IA?
+
+| Benefício          | Descrição                                                      |
+| ------------------ | -------------------------------------------------------------- |
+| **Segurança**      | Limite quais dados os agentes de IA podem acessar ou modificar |
+| **Conformidade**   | Garanta que a IA processe apenas os dados de que precisa       |
+| **Controle**       | Evite ações não intencionais de automações de IA               |
+| **Auditabilidade** | Acompanhe quais ações foram realizadas por cada agente         |
+
+<Note>
+Para agentes de IA em execução em fluxos de trabalho, a atribuição de função garante que o agente não possa acessar ou modificar dados fora do seu escopo pretendido — mesmo que o fluxo de trabalho tenha permissões mais amplas.
+</Note>
+
+## Relacionados
+
+* [Permissões](/l/pt/user-guide/permissions-access/capabilities/permissions) — informações detalhadas sobre como criar e gerenciar funções
+* [Agentes de IA](/l/pt/user-guide/ai/capabilities/ai-agents) — recursos de IA em fluxos de trabalho

packages/twenty-docs/l/pt/user-guide/ai/how-tos/ai-faq.mdx

@@ -0,0 +1,31 @@
+---
+title: FAQ de IA
+description: Perguntas frequentes sobre recursos de IA na Twenty.
+---
+
+<AccordionGroup>
+
+  <Accordion title="Quais capacidades de IA estão disponíveis?">
+    As duas principais capacidades de IA são:
+
+    1. **Chatbot de IA**: um assistente sensível ao contexto que pode acessar seus dados na Twenty e ajudar você com perguntas
+    2. **Agentes de IA em fluxos de trabalho**: automação inteligente que pode processar dados, tomar decisões e executar tarefas dentro dos seus fluxos de trabalho
+  </Accordion>
+
+  <Accordion title="Os agentes de IA têm acesso a todos os meus dados?">
+    Agentes de IA operam sob o sistema de autorização. Você pode atribuir funções específicas aos agentes de IA em **Configurações → Membros → Funções**, dando a você controle total sobre quais dados eles podem acessar e quais ações podem executar.
+  </Accordion>
+
+  <Accordion title="Como os créditos de IA funcionam?">
+    As ações de IA consomem créditos de fluxo de trabalho com base na complexidade da tarefa e no modelo de IA utilizado.
+  </Accordion>
+
+  <Accordion title="Posso usar meus próprios modelos de IA?">
+    Na nuvem, você pode usar apenas modelos de IA fornecidos pela Twenty. Na sua instância autogerida, você pode usar seus próprios modelos de IA após obter uma licença Organization.
+  </Accordion>
+
+  <Accordion title="Eu não vejo um papel que eu atribuí a um agente de Inteligência, onde está?">
+    Por padrão, a lista de Funções é filtrada para funções atribuíveis aos membros do espaço de trabalho. Se um papel é atribuível apenas aos agentes de Inteligência, você precisa alterar o filtro para incluir as funções de agente de AI.
+  </Accordion>
+
+</AccordionGroup>

packages/twenty-docs/l/pt/user-guide/ai/overview.mdx

@@ -0,0 +1,58 @@
+---
+title: IA
+description: Funcionalidades com IA no Twenty.
+---
+
+<Frame>
+  <img src="/images/user-guide/workflows/robot.png" alt="IA" />
+</Frame>
+
+## Recursos
+
+Atualmente, o Twenty oferece:
+
+### 1. Chatbot de IA
+
+Um assistente conversacional que entende seu contexto e tem acesso a todos os seus dados do Twenty.
+
+**Principais capacidades:**
+
+* **Acesso completo aos dados**: Consulte qualquer registro, relacionamento ou métrica no seu espaço de trabalho
+* **Consciência do contexto da página**: Faça referência a "esta empresa" ou "esta oportunidade" com base em onde você está no Twenty
+* **Linguagem natural**: Faça perguntas e obtenha respostas sem navegar por menus
+
+**Exemplos de prompts:**
+
+* "Quais oportunidades fecham neste mês?"
+* "Quais negócios estão em Negociação há mais de 30 dias?"
+* "Resuma minhas interações com esta pessoa"
+
+### 2. Agentes de IA em fluxos de trabalho
+
+Amplie seus fluxos de trabalho com ações com IA e agentes autônomos.
+
+**Principais capacidades:**
+
+* **Ações de IA**: Use IA para enriquecer dados, classificar registros, gerar resumos e muito mais
+* **Agentes autônomos**: Permita que agentes executem tarefas de várias etapas dentro de um fluxo de trabalho
+* **Prompts personalizados**: Defina exatamente como a IA deve processar seus dados
+
+**Casos de uso:**
+
+* Classifique automaticamente leads de entrada
+* Enriqueça dados de empresas a partir de fontes públicas
+* Gere rascunhos de e-mails de acompanhamento com base em notas de reunião
+* Pontue oportunidades com base em padrões de engajamento
+
+## Permissões e controle de acesso
+
+Os agentes de IA são gerenciados pelo sistema de permissões existente:
+
+1. Vá para **Configurações → Membros → Funções**
+2. Configure quais dados cada agente de IA pode acessar
+3. Defina permissões de leitura/gravação por objeto
+
+Isso garante que os agentes de IA respeitem suas políticas de governança de dados e acessem somente o que precisam.
+
+* Siga nosso [GitHub](https://github.com/twentyhq/twenty) para atualizações de desenvolvimento
+* Entre no nosso [Discord](https://discord.gg/UfGNZJfAG6) para compartilhar feedback e solicitações de recursos

packages/twenty-docs/l/pt/user-guide/billing/capabilities/credits.mdx

@@ -0,0 +1,74 @@
+---
+title: Créditos
+description: Um saldo simples que alimenta seus fluxos de trabalho, agentes de IA e chat de IA — quanto vale um crédito, até onde ele vai e como gerenciá-lo.
+---
+
+## O que são créditos?
+
+Créditos são um saldo único que alimenta tudo o que executamos em seu nome e que tem um custo real: **automações de fluxos de trabalho**, **agentes de IA** e o **chat de IA**. Em vez de gerenciar cotas separadas para "execuções de automação" e "tokens de IA", você tem um saldo simples para acompanhar.
+
+**1 crédito = US$ 1 de uso.** Um crédito é apenas um dólar de trabalho, então o seu saldo é fácil de entender — sem unidades abstratas para converter.
+
+## Até onde vai um crédito?
+
+O custo escala com o trabalho. Automações do dia a dia e mensagens de IA rápidas custam uma pequena fração de um crédito; tarefas grandes de agentes de IA com várias etapas custam mais. Aqui está uma visão aproximada:
+
+| O que você faz                                                                                                                     | Custa aproximadamente            | O que significa                   |
+| ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------- |
+| Executa uma etapa padrão de fluxo de trabalho (pesquisar, criar ou atualizar registros) ou aciona a função lógica de um aplicativo | $0.0001                          | **10.000 execuções por crédito**  |
+| Chamar uma API externa ou executar um nó de código                                                                                 | Uma pequena fração de um crédito | Milhares por crédito              |
+| Enviar uma mensagem de chat de IA rápida ou uma etapa simples de IA                                                                | Uma fração de centavo            | Centenas por crédito              |
+| Executar uma grande tarefa de agente de IA (por exemplo, "configurar 10 objetos do espaço de trabalho")                            | Pode chegar a **~$1 ou mais**    | Alguns por crédito                |
+| Executar uma pesquisa na web com IA                                                                                                | Um custo fixo por pesquisa       | Centenas de pesquisas por crédito |
+
+<Note>
+Para a maioria das equipes, as automações padrão são praticamente gratuitas — você só vai notar um impacto no seu saldo quando depender de recursos de IA ou executar nós de código pesados. Isso é intencional: os créditos incluídos são pensados para permitir que você crie sem ficar de olho no medidor.
+</Note>
+
+<Note>
+Nem todo app cobra por suas execuções. O Gravador de Chamadas e o último contato reagem a todos os e-mails e eventos do calendário importados para a sua área de trabalho, para que suas funções lógicas sejam gratuitas. Você ainda será cobrado pelo trabalho medido que eles realizam, como minutos de chamadas gravadas.
+</Note>
+
+## Como o uso de IA é medido
+
+Quando uma ação chama um modelo de IA, medimos exatamente os tokens usados e os cobramos pelas **tarifas publicadas pelo provedor do modelo**, depois convertemos esse valor em dólares diretamente em créditos — assim, o que você gasta acompanha o custo real do trabalho, não uma taxa interna com acréscimo. Uma mensagem de chat curta custa uma fração de centavo. Uma tarefa grande de agente — configurando 10 objetos do espaço de trabalho — faz muitos modelos chamar num contexto crescente, para que possa somar até um dólar ou mais. Você é cobrado apenas pelo que realmente usa, até o nível de token.
+
+O custo varia de acordo com o modelo: um modelo leve é dramaticamente mais barato por mensagem do que um modelo de raciocínio de nível superior. Você pode ver o detalhamento por ação — incluindo qual modelo foi usado — em **Configurações → Cobrança**.
+
+## O que está incluído
+
+Toda assinatura inclui créditos, e o valor depende do seu **ciclo de cobrança**, não do seu plano:
+
+| Ciclo de cobrança | Créditos incluídos | Uso equivalente     |
+| ----------------- | ------------------ | ------------------- |
+| Mensal            | 5 / mês            | ~$5 de uso por mês  |
+| Anual             | 50 / ano           | ~$50 de uso por ano |
+
+Esses créditos são projetados para cobrir confortavelmente as automações do dia a dia. Cinco créditos cobrem dezenas de milhares de etapas padrão de automação ou centenas de rápidas mensagens de IA - embora um punhado de grandes, tarefas de agentes de várias etapas podem usá-las mais rápido. Você pode recarregar a qualquer momento (veja abaixo).
+
+## Acúmulo de créditos
+
+Créditos não utilizados são automaticamente acumulados para o próximo período de cobrança.
+
+* **Caps**: A Rollover é limitada à alocação total de uma menstruação, então você nunca vai transferir mais do que o seu ciclo de faturação fornece por menstruação.
+* **Visibilidade**: Quando houver créditos acumulados, eles aparecerão como uma linha separada chamada **Créditos acumulados** em **Configurações → Cobrança**, juntamente com o saldo de **Total disponível**.
+
+## Monitoramento de uso
+
+Acompanhe o seu saldo e para onde ele está indo:
+
+1. Vá para **Configurações → Cobrança**
+2. Veja seus **créditos restantes** e o **uso no período atual**
+3. Aprofunde-se no detalhamento para ver quais fluxos de trabalho e ações de IA estão consumindo créditos — e quais modelos as ações de IA usaram
+
+Revisar isso regularmente torna fácil identificar cedo um fluxo de trabalho pesado e decidir se deseja otimizá-lo ou recarregar.
+
+## Precisa de mais créditos?
+
+Se você ficar sem créditos — ou quiser uma folga antes de uma grande onda de automação — pode comprar pacotes de créditos adicionais a qualquer momento:
+
+1. Vá para **Configurações → Cobrança**
+2. Clique no botão **Aumentar**
+3. Selecione a quantidade que você precisa e aceite as alterações
+
+Os créditos comprados são adicionados imediatamente ao seu saldo disponível.

packages/twenty-docs/l/pt/user-guide/billing/capabilities/pricing-plans.mdx

@@ -0,0 +1,100 @@
+---
+title: Planos de preços
+description: Saiba mais sobre os planos de preços do Twenty e como alternar entre eles.
+---
+
+## Visão Geral
+
+O Twenty oferece preços flexíveis para atender equipes de todos os tamanhos, quer você prefira hospedagem em nuvem ou auto-hospedagem.
+
+## Planos na nuvem
+
+### Pro (Nuvem)
+
+Para equipes prontas para escalar:
+
+* Todos os recursos centrais do CRM
+* Sincronização de email e calendário
+* Fluxos de trabalho e automações
+* Suporte padrão
+
+<Note>
+Os recursos Premium (SSO, permissões em nível de linha, dados de uso de IA e mais) não estão incluídos no plano Pro.
+</Note>
+
+### Organização (Nuvem)
+
+Para equipes maiores com necessidades avançadas:
+
+* Tudo do Pro
+* **Recursos Premium**: integração com SSO, permissões em nível de linha, dados de uso de IA e mais
+* Suporte prioritário
+
+## Planos auto-hospedados
+
+### Gratuito (Auto-hospedado)
+
+Hospede o Twenty na sua própria infraestrutura sem custo:
+
+* Todos os recursos do Pro incluídos
+* Suporte da comunidade via Discord
+* Controle total sobre seus dados
+
+### Organização (Auto-hospedado)
+
+Para equipes que precisam de recursos premium enquanto se auto-hospedam:
+
+* Todos os recursos do Pro
+* **Recursos Premium**: integração com SSO, permissões em nível de linha, dados de uso de IA e mais
+* Suporte da equipe Twenty
+* Sem necessidade de publicar código personalizado como código aberto antes de distribuir
+
+## Recursos premium
+
+Os recursos premium estão disponíveis apenas nos planos Organização (Nuvem ou Auto-hospedado):
+
+* **Integração SSO**: Single Sign-On com seu provedor de identidade
+* **Permissões em nível de linha**: controle de acesso granular no nível de registro
+* **Dados de uso de IA**: Acompanhe o consumo de IA em todo o espaço de trabalho
+* **Registros de auditoria**: verifique o que cada membro do workspace tem feito
+* **Campanhas de email**: planeje quais emails devem ser enviados (disponível em breve)
+* **Workspaces ilimitados**: Crie quantos workspaces quiser (somente para auto-hospedagem)
+* **Código-fonte privado**: Nenhuma exigência de publicar alterações em um repositório público (somente para auto-hospedagem)
+
+## Mudança de planos
+
+### Atualizar para Organização
+
+1. Vá para **Configurações → Faturamento → Planos**
+2. Clique em **Mudar para Organização**
+3. Confirme o upgrade
+
+### Fazer downgrade para Pro
+
+1. Vá para **Configurações → Faturamento → Planos**
+2. Clique em **Mudar para Pro**
+3. Confirme o downgrade
+
+### Mudar para faturamento anual
+
+1. Vá para **Configurações → Faturamento**
+2. Clique em **Fazer upgrade para Anual**
+3. Economize com faturamento anual
+
+### Mudar para faturamento mensal
+
+1. Vá para **Configurações → Faturamento**
+2. Clique em **Alterar para Mensal**
+3. Economize com faturamento mensal
+
+## Obtenha uma chave Enterprise para Organization (Self-Hosted)
+
+Para usar o plano Organization (Self-Hosted), você precisa obter uma chave Enterprise:
+
+1. Vá para **Configurações → Painel de Administração → Enterprise**
+
+<img src="/images/user-guide/billing/enterprise-key.png" alt="Chave Enterprise" />
+
+2. Clique em **Obter chave Enterprise**
+3. Quando você for redirecionado ao Stripe, insira seus dados de pagamento e confirme
+4. Quando sua chave Enterprise for exibida, cole-a na página de configurações do Enterprise e ative a licença do Organization

packages/twenty-docs/l/pt/user-guide/billing/how-tos/billing-faq.mdx

@@ -0,0 +1,105 @@
+---
+title: FAQ de Faturação
+description: Perguntas frequentes sobre preços e faturação da Twenty.
+---
+
+## Preços
+
+<AccordionGroup>
+<Accordion title="Posso usar a Twenty gratuitamente enquanto hospedo por conta própria?">
+Sim, você pode usar a Twenty gratuitamente enquanto hospeda por conta própria. Você terá acesso a tudo o que está incluído no plano Pro (Cloud), exceto o suporte da nossa equipe principal. O suporte está acessível por meio da nossa comunidade no Discord.
+
+Se você quiser hospedar por conta própria e precisar dos recursos Premium (SSO, permissões em nível de linha e mais), pode escolher a licença paga Organization (Self-Hosted). Isso também inclui suporte da equipe da Twenty e remove a exigência de publicar código personalizado como código aberto antes de distribuir.
+</Accordion>
+
+<Accordion title="Quais são os recursos Premium?">
+Os recursos Premium estão disponíveis apenas nos planos Organization (Cloud ou Self-Hosted):
+* **Integração de SSO**: Single Sign-On com seu provedor de identidade
+* **Permissões em nível de linha**: Controle de acesso granular no nível de registro
+* **Dados de uso de IA**: Acompanhe o consumo de IA em todo o espaço de trabalho
+* **Registros de auditoria**: Verifique o que cada membro do workspace tem feito
+* **Campanhas de email**: Planeje quais emails devem ser enviados (disponível em breve)
+* **Workspaces ilimitados**: Crie quantos workspaces quiser (somente para auto-hospedagem)
+* **Código fonte privado**: nenhum requisito para publicar alterações em um repositório disponível publicamente (apenas auto-hospedado)
+</Accordion>
+
+<Accordion title="São os mesmos planos da Organização em Nuvem e Auto-Hospedados?">
+Ambos oferecem os mesmos recursos Premium. No entanto, uma assinatura na nuvem não pode ser usada para implantações autohospedadas. O ambiente autohospedado requer uma chave Enterprise.
+</Accordion>
+
+<Accordion title="Você oferece assentos gratuitos para usuários apenas visualizadores?">
+Não oferecemos assentos gratuitos. Os preços são por usuário e cada usuário precisa de uma licença para acessar o Twenty.
+</Accordion>
+
+<Accordion title="Onde posso mudar minha assinatura para o plano Organization?">
+Você pode fazer isso em `Configurações → Cobrança → Planos`. Depois, clique em `Alterar para Organização`.
+</Accordion>
+
+<Accordion title="Onde posso mudar minha assinatura para o plano Pro?">
+Você pode fazer isso em `Configurações → Cobrança → Planos`. Depois, clique em `Alterar para Pro`.
+</Accordion>
+
+<Accordion title="Onde posso mudar minha assinatura para anual?">
+Você pode fazer isso em `Configurações → Cobrança`. Depois, clique em `Atualizar para anual`.
+</Accordion>
+
+<Accordion title="Onde posso mudar minha assinatura para mensal?">
+Você pode fazer isso em `Configurações → Cobrança`. Depois, clique em `Alterar para Mensal`.
+</Accordion>
+
+<Accordion title="Onde posso ver o uso dos meus créditos?">
+Você encontrará isso em `Configurações → Cobrança`.
+</Accordion>
+
+<Accordion title="Quantos créditos de fluxo de trabalho nós temos?">
+A quantidade de créditos depende do seu ciclo de faturação, não do seu plano:
+* **Assinaturas mensais**: 5 créditos por mês
+* **Assinaturas anuais**: 50 créditos por ano
+</Accordion>
+
+<Accordion title="Como funciona o consumo de créditos de fluxo de trabalho?">
+Cada ação de fluxo de trabalho consome créditos com base em sua complexidade:
+* **Operações internas básicas** (como pesquisa, atualiza ou cria registros) consome muito poucos créditos
+* **Operações mais complexas** como nós de código e solicitações a serviços externos consomem mais créditos
+* **Prompts de IA** também consomem mais créditos com base no uso
+* **Aplicativos** consomem mais créditos da mesma forma para os nós de código
+
+Os créditos são deduzidos em tempo real à medida que os fluxos de trabalho ou apps são executados. Você pode monitorar seu uso em **Configurações → Cobrança** para acompanhar o consumo e os créditos restantes.
+</Accordion>
+
+<Accordion title="Posso comprar mais créditos de fluxo de trabalho?">
+Você pode comprar créditos adicionais em `Configurações → Cobrança`.
+</Accordion>
+
+<Accordion title="Posso comprar mais créditos de fluxo de trabalho apenas por 1 mês?">
+Sim, vá para `Configurações → Faturação`, clique no botão `Aumentar`, escolha quantos créditos você deseja e confirme. Eles serão aplicados no período de faturamento atual. Em seguida, clique no botão `Aumentar` novamente, altere o valor de volta para o original, e confirmar — o downgrade será aplicado a partir do próximo período de faturamento.
+</Accordion>
+</AccordionGroup>
+
+## Faturação
+
+<AccordionGroup>
+<Accordion title="Onde posso gerenciar os detalhes da Cobrança?">
+Você pode fazer isso em `Configurações → Cobrança`.
+</Accordion>
+
+<Accordion title="Onde posso atualizar meu método de pagamento?">
+Você pode fazer isso em `Configurações → Cobrança`. Depois, clique em `Ver detalhes de cobrança`. Você poderá adicionar um novo método de pagamento lá.
+</Accordion>
+
+<Accordion title="Onde posso atualizar minhas informações de faturamento?">
+Você pode fazer isso em `Configurações → Cobrança`. Depois, clique em `Ver detalhes de cobrança`. Você poderá editar as informações de faturamento lá.
+</Accordion>
+
+<Accordion title="Onde posso acessar minhas faturas?">
+Você pode fazer isso em `Configurações → Cobrança`. Depois, clique em `Ver detalhes de cobrança`. Você verá todas as suas faturas na parte inferior da tela.
+</Accordion>
+
+<Accordion title="Por que meus assentos são diferentes do número de usuários no meu workspace?">
+A contagem de assentos do workspace é sincronizada com o sistema de pagamento a cada 6 horas; as faturas são ajustadas com base na diferença.
+</Accordion>
+
+<Accordion title="Por que recebi uma fatura por um novo membro do workspace?">
+Quando um novo membro da área de trabalho é adicionado à área de trabalho, uma fatura é enviada para cobrir a diferença. Quando um membro do workspace é removido, a alteração é aplicada na próxima fatura mensal/anual padrão.
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/pt/user-guide/billing/overview.mdx

@@ -0,0 +1,39 @@
+---
+title: Faturação
+description: Entenda os preços da Twenty e gerencie sua assinatura.
+---
+
+A Twenty oferece planos de preços flexíveis para atender às necessidades da sua equipe. Gerencie sua assinatura, acompanhe créditos de fluxos de trabalho e acesse faturas, tudo em **Configurações → Cobrança**.
+
+## O que há nesta seção
+
+<CardGroup cols={2}>
+  <Card title="Planos de preços" icon="tags" href="/l/pt/user-guide/billing/capabilities/pricing-plans">
+    Saiba mais sobre os planos de preços da Twenty e o que está incluído.
+  </Card>
+  <Card title="Perguntas frequentes" icon="circle-question" href="/l/pt/user-guide/billing/how-tos/billing-faq">
+    Perguntas frequentes sobre preços e cobrança.
+  </Card>
+</CardGroup>
+
+## Visão geral
+
+| Plano                                         | Principais funcionalidades                                                                                                                                                                               |
+| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Gratuito (hospedado por conta própria)**    | Todas as funcionalidades do Pro, suporte da comunidade                                                                                                                                                   |
+| **Pro (Nuvem)**                               | Tudo, exceto as funcionalidades Premium (SSO, permissões em nível de linha e mais), suporte padrão                                                                                                       |
+| **Organização (Nuvem)**                       | Tudo do Pro + as funcionalidades Premium (SSO, permissões em nível de linha e mais), suporte prioritário                                                                                                 |
+| **Organização (hospedado por conta própria)** | Tudo do Pro + as funcionalidades Premium (SSO, permissões em nível de linha e mais), suporte da equipe Twenty, não é necessário publicar seu código personalizado como código aberto antes de distribuir |
+
+## Respostas rápidas
+
+**Onde gerencio a cobrança?**
+Vá para **Configurações → Cobrança** para ver seu plano, atualizar métodos de pagamento e acessar faturas.
+
+**Posso usar a Twenty gratuitamente?**
+Sim! Hospede a Twenty por conta própria e obtenha todas as funcionalidades do Pro sem custo.
+
+**Como faço para atualizar?**
+Vá para **Configurações → Cobrança** e clique em **Mudar para Organização** ou **Mudar para Anual**.
+
+Para mais perguntas, consulte as [Perguntas frequentes sobre cobrança](/l/pt/user-guide/billing/how-tos/billing-faq).

packages/twenty-docs/l/pt/user-guide/calendar-emails/capabilities/calendar.mdx

@@ -0,0 +1,43 @@
+---
+title: Calendário
+description: Entendendo os recursos de integração do calendário no Twenty.
+---
+
+**Nota**: Para conectar seu calendário e configurar as configurações de sincronização, visite [Configuração de Email & Calendário](/l/pt/user-guide/calendar-emails/overview).
+
+## Como Funciona a Integração de Calendário
+
+O Twenty sincroniza automaticamente os eventos do seu calendário e os vincula aos registros relevantes do CRM, oferecendo uma visão completa do seu histórico de reuniões com contatos e empresas.
+
+## Aba de Calendário
+
+Ao lado da aba de Emails nos registros, você encontrará a aba `Calendário` que contém o histórico de reuniões agendadas com o registro.
+
+### Disponível para
+
+* **Pessoas**: Visualize todas as reuniões agendadas com um contato específico
+* **Empresas**: Veja todas as reuniões relacionadas a uma empresa e seus funcionários
+* **Oportunidades**: Acesse o histórico de reuniões relacionadas à empresa vinculada à oportunidade
+
+### Visualizando o Histórico de Reuniões
+
+1. **Navegue até um Registro**: Vá para qualquer registro de Pessoa, Empresa ou Oportunidade
+2. **Selecione a Aba de Calendário**: Clique na aba `Calendário` ao lado da aba de Emails
+3. **Navegue pelo Histórico de Reuniões**: Veja todas as reuniões agendadas e seus detalhes
+4. **Acesse o Contexto da Reunião**: Veja participantes, horários e informações relacionadas
+
+## Configurações de Visibilidade
+
+Os dados do calendário seguem as mesmas configurações de visibilidade dos emails, garantindo controles de privacidade consistentes em ambos os canais de comunicação.
+
+## O Que É Sincronizado
+
+* **Reuniões Externas**: Todas as reuniões com contatos fora da sua organização
+* **Vinculação Automática**: As reuniões conectam-se aos registros de Pessoas e Empresas existentes com base nos endereços de email dos participantes
+* **Detalhes da Reunião**: Assunto, horário, duração e participantes
+* **Atualizações**: Novos eventos do calendário são sincronizados automaticamente
+
+## O Que Não É Sincronizado
+
+* **Reuniões Internas**: Reuniões apenas com colegas (mesmo domínio) permanecem privadas
+* **Eventos Privados**: Eventos marcados como privados no seu calendário

packages/twenty-docs/l/pt/user-guide/calendar-emails/capabilities/mailbox.mdx

@@ -0,0 +1,102 @@
+---
+title: Caixa de entrada
+description: Entendendo os recursos de integração de e-mail no Twenty.
+---
+
+**Nota**: Para conectar suas contas de email e configurar as configurações de sincronização, visite [Configuração de Email & Calendário](/l/pt/user-guide/calendar-emails/overview).
+
+## Como Funciona a Integração de Email
+
+Twenty vincula automaticamente os emails de suas caixas de correio conectadas aos registros de CRM relevantes, mantendo todo o histórico de comunicação em um só lugar.
+
+### Objetos onde os e-mails podem ser encontrados
+
+As conversas de email aparecem em três objetos principais:
+
+* **Pessoas**: Visualize todos os emails trocados com um contato específico
+* **Empresas**: Veja todos os emails relacionados a uma empresa e seus funcionários
+* **Oportunidades**: Acessar tópicos de e-mail relacionados à empresa vinculada à oportunidade. As conversas de e-mail de pessoas específicas na oportunidade ainda não são exibidas.
+
+### Visualizando conversas de e-mail
+
+1. **Navegue até um Registro**: Vá para qualquer registro de Pessoa, Empresa ou Oportunidade
+2. **Selecione a Aba de Emails**: Clique na aba `Emails` para visualizar os emails sincronizados
+3. **Abrir uma conversa de e-mail**: Clique em qualquer e-mail para abrir e ler a conversa completa
+4. **Navegue pelo Histórico**: Role pelo histórico completo de emails com aquele contato
+
+<img src="/images/user-guide/emails/show-inbox.png" style={{width:'100%'}} />
+
+## O Que Você Verá
+
+### Visualização do Fio de Email
+
+Ao abrir um fio de email, você pode:
+
+* **Leia Conversas Completas**: Veja a troca completa de emails
+* **Visualize Participantes**: Veja todas as pessoas envolvidas no fio de email
+* **Verificar carimbos de data e hora**: Saiba exatamente quando cada e-mail foi enviado
+* **Acesse o Contexto**: Entenda o histórico completo de comunicação
+
+### Visibilidade de Email
+
+Dependendo das suas configurações de caixa de correio, você pode ver:
+
+* **Conteúdo Completo**: Texto e detalhes completos do email
+* **Assunto + Metadados**: Linha de assunto, remetente, destinatário e carimbo de data/hora
+* **Apenas Metadados**: Informações básicas sem conteúdo de email
+
+## Comportamento de Sincronização de Email
+
+### Taxa de sincronização
+
+Twenty importa emails a cerca de **400 mensagens por minuto**. Atualmente, essa taxa é limitada pela limitação de taxa da API do Gmail (e aplica-se de forma semelhante a outros provedores).
+
+Para referência:
+
+* 1.000 emails → ~2,5 minutos
+* 10.000 emails → ~25 minutos
+* 50.000 emails → ~2 horas
+
+### O Que É Sincronizado
+
+* **Emails Externos**: Todos os emails com contatos fora da sua organização
+* **Vinculação Automática**: Emails conectam-se aos registros de Pessoas e Empresas existentes
+* **Múltiplos Endereços**: Emails de qualquer endereço vinculam-se ao mesmo registro de contato
+* **Atualizações**: Novos emails aparecem imediatamente
+
+### O Que Não É Sincronizado
+
+* **E-mails internos**: Por padrão, e-mails entre colegas (mesmo domínio) permanecem privados (configurado em Configurações → Geral → Segurança)
+* **Emails de Grupo**: Listas de distribuição e emails de grupo são excluídos
+* **Pastas Excluídas**: Pastas que você escolheu não sincronizar (configuradas em Configurações → Contas → Email)
+
+### E-mails internos
+
+Escolha se os e-mails internos são sincronizados no Twenty:
+
+1. Vá para **Configurações → Geral → Segurança**
+2. Alterne **Sincronizar e-mails internos** ligado/desligado
+
+### Sincronização seletiva de pastas
+
+Controle quais pastas de email sincronizam com o Twenty:
+
+1. Vá para **Configurações → Contas** e selecione sua conta de email conectada
+2. Configure as pastas na seção Email
+3. Escolha pastas específicas para incluir ou excluir (Caixa de Entrada, Enviados, Arquivo, pastas personalizadas)
+
+## Solução de Problemas de Sincronização de Email
+
+### Problemas Comuns de Sincronização
+
+* **Atrasos na Sincronização**: Emails aparecem imediatamente, mas as importações iniciais levam mais tempo
+* **Emails Ausentes**: Verifique se:
+  * As pastas são excluídas nas configurações de Pasta de Mensagens
+  * A criação automática de contatos está desativada (os emails precisam de registros existentes no Twenty)
+  * O email é de colegas (mesmo domínio) ou listas de grupo
+  * A caixa de correio ainda está concluindo a sincronização inicial
+
+### Limitações de Email
+
+* **Pastas do Sistema**: Algumas pastas de email podem não estar disponíveis para sincronização
+* **Apelidos de Email**: Somente as caixas de correio verdadeiras podem ser conectadas (não alias de email)

packages/twenty-docs/l/pt/user-guide/calendar-emails/how-tos/can-i-book-meetings-from-twenty.mdx

@@ -0,0 +1,25 @@
+---
+title: Posso agendar reuniões a partir do Twenty?
+description: Informações sobre o agendamento de reuniões diretamente a partir do Twenty.
+---
+
+## Estado atual
+
+A integração de calendário do Twenty foi concebida para **sincronizar e apresentar** os seus eventos de calendário existentes.
+
+## Agendamento de reuniões através de Fluxos de Trabalho
+
+Embora não seja possível agendar reuniões manualmente, você pode agendá-las em Vinte usando fluxos de trabalho.
+
+1. Crie um novo fluxo de trabalho
+2. Selecione qualquer gatilho consoante as suas necessidades
+3. Adicione o nó **Create Calendar Event**
+4. Configure todos os dados necessários
+5. Ative o fluxo de trabalho
+
+## O que pode fazer
+
+* **Ver o histórico de reuniões** nos registos de Pessoas, Empresas e Oportunidades
+* **Ver as próximas reuniões** com contactos no seu CRM
+* **Acompanhar o contexto das reuniões** juntamente com as comunicações por e-mail
+* **Criar contactos automaticamente** a partir dos participantes das reuniões

packages/twenty-docs/l/pt/user-guide/calendar-emails/how-tos/can-i-send-emails-from-twenty.mdx

@@ -0,0 +1,53 @@
+---
+title: Posso enviar e-mails a partir do Twenty?
+description: Informações sobre o envio de e-mails diretamente a partir do Twenty.
+---
+
+## Estado atual
+
+A integração de e-mail do Twenty foi concebida para **sincronizar e apresentar** o seu histórico de e-mails, bem como redigir e enviar e-mails.
+
+Ao visualizar uma conversa de e-mails numa página de registo e clicar em **Responder**, pode redigir e enviar um e-mail diretamente.
+
+## Como enviar uma mensagem a partir do Twenty
+
+Pré-requisito: uma conta de email conectada com a capacidade de enviar e-mails
+
+1. Abra o menu de Comando com o atalho **Ctrl+K** ou **Cmd+K**
+2. Clique na opção "Compor e-mail"
+3. Escolha destinatários, adicione o assunto, o corpo e anexos ao seu e-mail
+4. Clique no botão "Enviar" para enviar o e-mail
+
+## O que pode fazer hoje
+
+* **Ver o histórico de e-mails** nos registos de Pessoas, Empresas e Oportunidades
+* **Ler conversas completas de e-mail** com contactos no seu CRM
+* **Acompanhar o contexto das comunicações** juntamente com os eventos do calendário
+* **Criar contactos automaticamente** a partir de interações por e-mail
+* **Responder por redirecionamento** — clique em Responder para ir para a sua caixa de entrada
+
+## Envio de e-mails através de Fluxos de Trabalho
+
+Você **pode enviar e-mails automaticamente usando fluxos de trabalho**. Isto é útil para:
+
+* Acompanhamentos automáticos
+* Notificações para contactos
+* Comunicações acionadas com base em alterações de registos
+
+Os e-mails enviados através de Fluxos de Trabalho são processados pela sua conta de e-mail ligada.
+
+→ Saiba mais sobre a [ação Enviar e-mail](/l/pt/user-guide/workflows/capabilities/workflow-actions#send-email)
+
+## Sequências de e-mails e boletins informativos
+
+Para sequências de e-mails e boletins informativos, recomendamos utilizar Fluxos de Trabalho para ligar o Twenty a uma ferramenta dedicada de marketing por e-mail.
+
+<Warning>
+E-mails em massa não devem ser enviados diretamente da sua caixa de entrada para proteger a reputação do seu domínio. Utilize uma ferramenta dedicada para comunicações em massa.
+</Warning>
+
+→ Consulte [Como enviar e-mails a partir de Fluxos de Trabalho](/l/pt/user-guide/workflows/capabilities/send-emails-from-workflows) para obter instruções de configuração
+
+## Planos futuros
+
+A redação nativa de e-mails dentro do Twenty está no nosso roteiro. Junte-se às nossas [discussões no GitHub](https://github.com/twentyhq/twenty/discussions) para partilhar o seu caso de uso e ajudar a priorizar esta funcionalidade.

packages/twenty-docs/l/pt/user-guide/calendar-emails/how-tos/can-i-track-email-activity-on-all-objects.mdx

@@ -0,0 +1,35 @@
+---
+title: Posso acompanhar a atividade de email em todos os objetos?
+description: Compreender o acompanhamento da atividade de email em diferentes objetos.
+---
+
+## Objetos suportados
+
+A atividade de email está atualmente disponível em **três objetos padrão**:
+
+| Objeto            | O que vê                                                                         |
+| ----------------- | -------------------------------------------------------------------------------- |
+| **Pessoas**       | Todos os emails trocados com esse contacto específico                            |
+| **Empresas**      | Todos os emails com qualquer pessoa dessa empresa (com base no domínio de email) |
+| **Oportunidades** | Emails relacionados com a empresa associada à oportunidade                       |
+
+## Porque é que apenas estes objetos?
+
+Pessoas, Empresas e Oportunidades são os objetos de relação principais onde o contexto de email acrescenta mais valor. As conversas de email são associadas automaticamente com base em:
+
+* **Endereço de email** → associado a registos de Pessoas
+* **Domínio de email** → associado a registos de Empresas
+* **Relação com a empresa** → ligada a Oportunidades
+
+## Objetos personalizados
+
+**O acompanhamento de email não está disponível em objetos personalizados** neste momento.
+
+Se precisar de contexto de email num objeto personalizado, considere:
+
+* Usar um campo de relação para ligar o seu objeto personalizado a Pessoas ou Empresas
+* Ver o histórico de email no registo de Pessoa/Empresa ligado
+
+## Planos futuros
+
+Está a ser considerada a extensão da visibilidade do email a objetos personalizados. Partilhe o seu caso de uso nas nossas [discussões no GitHub](https://github.com/twentyhq/twenty/discussions) para ajudar a priorizar esta funcionalidade.

packages/twenty-docs/l/pt/user-guide/calendar-emails/how-tos/connect-several-mailboxes-per-user.mdx

@@ -0,0 +1,42 @@
+---
+title: Conectar várias caixas de correio por usuário
+description: Conecte várias contas de e-mail para um único usuário.
+---
+
+## Visão Geral
+
+O Twenty oferece suporte a **contas de e-mail ilimitadas por usuário**. Isso é útil se você gerencia várias caixas de entrada, como:
+
+* E-mail de trabalho pessoal + caixa de entrada compartilhada da equipe
+* Vários endereços de e-mail voltados para clientes
+* Contas de e-mail diferentes para diferentes funções
+
+## Como adicionar múltiplas caixas de correio
+
+1. Vá para **Configurações → Contas**
+2. Clique em **Adicionar conta**
+3. Conecte uma conta adicional do Google ou da Microsoft, ou de qualquer outro provedor de e-mail que ofereça suporte aos protocolos IMAP/SMTP
+4. Configure as configurações de sincronização para esta caixa de correio
+5. Repita para cada caixa de correio que você deseja conectar
+
+## Gerenciando várias contas
+
+Cada caixa de correio conectada tem suas próprias configurações:
+
+* **Visibilidade do e-mail**: Escolha o que os colegas de equipe podem ver
+* **Criação automática de contatos**: Ative/desative por caixa de correio
+* **Seleção de pastas**: Escolha quais pastas sincronizar
+
+## Como os e-mails aparecem
+
+Os e-mails de todas as suas caixas de correio conectadas são sincronizados com o Twenty e aparecem em:
+
+* **Registros de pessoas**: Com base no endereço de e-mail do contato
+* **Registros de empresas**: Com base no domínio do e-mail
+* **Oportunidades**: Com base na empresa vinculada
+
+<Note>Cada e-mail mostra de qual caixa de correio foi enviado ou em qual foi recebido, para que você possa acompanhar qual conta foi usada em cada comunicação.</Note>
+
+## Notas importantes
+
+<Warning>Somente caixas de correio reais podem ser conectadas. Aliases de e-mail que encaminham para outra caixa de correio não podem ser conectados separadamente — eles serão sincronizados pela caixa de correio principal.</Warning>

packages/twenty-docs/l/pt/user-guide/calendar-emails/how-tos/i-dont-see-emails-on-records.mdx

@@ -0,0 +1,53 @@
+---
+title: Não vejo emails nos registos
+description: Resolução de problemas de emails em falta nos registos.
+---
+
+## Causas comuns
+
+### 1. A sincronização inicial ainda está em curso
+
+A sincronização de emails leva tempo, especialmente para caixas de correio grandes. Twenty importa emails a uma taxa de aproximadamente **400 mensagens por minuto** (limitado pela restrição de taxa da API do Gmail).
+
+* **Sincronização do calendário**: Conclui em minutos
+* **Sincronização de email**: Depende do tamanho da caixa de correio (por exemplo, 10.000 emails ≈ 25 minutos, 50.000 emails ≈ 2 horas)
+
+**Solução**: Aguarde a conclusão da importação inicial. Você pode estimar o tempo com base no tamanho da sua caixa de correio.
+
+### 2. O contacto não existe no Twenty
+
+Os emails só aparecem em registos de Pessoas existentes. Se o contacto ainda não foi criado:
+
+* Ative a **Criação automática de contactos** nas definições da sua caixa de correio
+* Ou crie manualmente o registo da Pessoa primeiro
+
+**Solução**: Vá a **Settings → Accounts**, selecione a sua caixa de correio e ative a criação automática de contactos.
+
+### 3. Os emails internos são excluídos
+
+Emails entre colegas (mesmo domínio de email) nunca são sincronizados para manter a privacidade.
+
+**Solução**: Este é o comportamento esperado. Apenas emails externos são sincronizados.
+
+### 4. O email é de um grupo ou lista de distribuição
+
+Emails de grupo e listas de distribuição são excluídos da sincronização.
+
+**Solução**: Este é o comportamento esperado.
+
+### 5. Pasta não selecionada para sincronização
+
+Se estiver a usar a funcionalidade Message Folder, algumas pastas podem estar excluídas.
+
+**Solução**: Vá a **Settings → Accounts**, selecione a sua caixa de correio e verifique as definições de sincronização de pastas.
+
+### 6. Endereço de email incorreto no registo
+
+O registo da Pessoa pode ter um endereço de email diferente do utilizado no email.
+
+**Solução**: Adicione o endereço de email correto ao registo da Pessoa.
+
+## Ainda não está a funcionar?
+
+1. Tente desligar e voltar a ligar a sua caixa de correio
+2. Contacte o suporte se os problemas persistirem

packages/twenty-docs/l/pt/user-guide/calendar-emails/how-tos/limit-emails-imported.mdx

@@ -0,0 +1,58 @@
+---
+title: Limitar emails importados
+description: Controle quais emails são importados para o Twenty.
+---
+
+## Visão Geral
+
+Por padrão, o Twenty sincroniza todos os emails externos da sua caixa de correio conectada. Você pode limitar o que é importado usando **seleção de pastas** e **configurações de visibilidade**.
+
+## Método 1: Seleção de Pastas (Recomendado)
+
+Controle quais pastas de email sincronizam com o Twenty:
+
+1. Vá para **Configurações → Contas**
+2. Selecione sua conta de email conectada
+3. Escolha quais pastas sincronizar:
+
+| Pasta                     | Descrição                                     |
+| ------------------------- | --------------------------------------------- |
+| **Caixa de entrada**      | Principais emails recebidos                   |
+| **Enviado**               | Emails de saída que você enviou               |
+| **Arquivo**               | Mensagens arquivadas                          |
+| **Pastas personalizadas** | Quaisquer pastas específicas que você desejar |
+
+4. Exclua pastas que você não quer sincronizadas (Spam, Lixo, pastas pessoais)
+
+<Note>Isso lhe dá controle preciso sobre quais emails aparecem no seu CRM sem sincronizar tudo.</Note>
+
+## Método 2: Configurações de Criação Automática de Contatos
+
+Controle quando os contatos são criados a partir de emails:
+
+1. Vá para **Configurações → Contas**
+2. Selecione sua caixa de correio conectada
+3. Escolha uma opção:
+   * **Desativado**: Não cria contatos, mas os emails ainda são sincronizados com contatos existentes
+   * **Enviados e recebidos**: Criar contatos a partir de todos os emails externos
+   * **Somente enviados**: Criar contatos apenas a partir de emails que você envia
+
+## E-mails internos
+
+Mensagens entre colegas (mesmo domínio) podem ser sincronizadas no Twenty:
+
+1. Vá para **Configurações → Geral → Segurança**
+2. Alterne **Sincronizar e-mails internos** ligado/desligado
+
+<Note>Por padrão, esta opção vem desativada.</Note>
+
+## O que é sempre excluído
+
+Esses emails nunca são sincronizados, independentemente das configurações:
+
+* **Emails de grupo**: Listas de distribuição e mensagens de grupo
+* **Spam/Lixo**: Pastas do sistema normalmente são excluídas
+
+## Nota importante
+
+<Note>Ainda não fornecemos um endereço de e-mail CC para sincronização seletiva. Use o recurso de seleção de pastas acima para obter o mesmo nível de controle.</Note>

packages/twenty-docs/l/pt/user-guide/calendar-emails/overview.mdx

@@ -0,0 +1,144 @@
+---
+title: Calendário e emails
+description: Conecte as suas contas de email e calendário ao Twenty.
+---
+
+## Opções de Conexão
+
+### Conta do Google (Gmail & Google Calendar)
+
+1. Vá para **Configurações → Contas**
+2. Clique em **Adicionar conta**
+3. Selecione **Continuar com o Google**
+4. Autorize o Twenty a aceder ao seu Gmail e Google Calendar
+5. Configure as definições de sincronização de email (visibilidade, criação automática) → clique em **Seguinte**
+6. Configure as definições de sincronização do calendário (visibilidade, criação automática) → clique em **Adicionar conta**
+7. Seus emails e eventos de calendário começarão a sincronizar automaticamente
+
+### Conta Microsoft (Outlook & Microsoft Calendar)
+
+1. Vá para **Configurações → Contas**
+2. Clique em **Adicionar conta**
+3. Selecione **Continuar com Microsoft**
+4. Autorize o Twenty a acessar seu Outlook e Microsoft Calendar
+5. Configure as definições de sincronização de email (visibilidade, criação automática) → clique em **Seguinte**
+6. Configure as definições de sincronização do calendário (visibilidade, criação automática) → clique em **Adicionar conta**
+7. Seus emails e eventos de calendário começarão a sincronizar automaticamente
+
+### Configuração IMAP/SMTP/CalDAV (Outros Provedores)
+
+Para outros provedores de email e calendário:
+
+1. Vá para **Configurações → Contas**
+2. Configure as configurações de IMAP para sincronizar emails recebidos e as configurações de SMTP para enviar emails
+3. Configure as definições CalDAV para o calendário
+4. Teste a ligação
+
+<Note>
+**Self-hosting em uma rede isolada (air-gapped) ou interna**: Por padrão, Twenty recusa conexões de saída para endereços IP privados/internos (proteção contra SSRF). Se o seu servidor de email ou calendário estiver em um IP local/privado (por exemplo, um servidor local instalado em uma LAN), as conexões para ele serão bloqueadas. Para permiti-las, defina a seguinte variável de ambiente no servidor:
+
+```
+OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
+```
+
+Isso desativa o modo seguro para **todas** as solicitações de saída (ações de fluxo de trabalho HTTP, webhooks e conexões IMAP/SMTP/CalDAV), portanto, defina essa configuração apenas em redes confiáveis e isoladas, onde a proteção contra SSRF não é necessária.
+</Note>
+
+### Caixas de Correio Múltiplas
+
+* **Contas Ilimitadas**: Conectar múltiplas contas de email por usuário
+* **Gestão de Contas**: Alternar entre diferentes caixas de correio
+* **Definições de sincronização**: Configure definições diferentes por caixa de correio
+
+<Warning>
+Apenas caixas de correio verdadeiras podem ser conectadas (ex.: suporte@dominio.com com sua própria caixa de entrada). Aliases de email que redirecionam para outra caixa de correio não podem ser conectados ao Twenty.
+</Warning>
+
+## Configuração de Email
+
+### Visibilidade da Mensagem
+
+Escolha diferentes níveis de visibilidade para seus emails:
+
+* **Apenas Metadados**: Compartilhar apenas informação básica (remetente, destinatário, data, hora)
+* **Assunto e Metadados**: Compartilhar linha de assunto junto com metadados
+* **Todo o Conteúdo do Email**: Compartilhar o conteúdo inteiro do email incluindo anexos
+
+### Criação automática de contactos
+
+* **Desativado**: Nenhuma criação automática de contato
+* **Para mensagens enviadas e recebidas**: Crie contatos para todas as interações de e-mail externas
+* **Somente para mensagens enviadas**: Criar contatos apenas para emails que você envia
+* **Observação**: Por padrão, emails internos (quando todos os participantes compartilham seu domínio) não são sincronizados para proteger a privacidade
+
+<Note>Quando ativado, os contactos são automaticamente associados aos respetivos registos de Empresa com base no domínio de email. Se a empresa ainda não existir, o Twenty cria-a por si.</Note>
+
+<Note>
+**Sincronizando emails internos**: O comportamento de "emails internos não sincronizados" é o padrão, mas pode ser desativado. A alternância fica em configurações avançadas:
+1. Abra **Configurações** e ative a alternância **Avançado** na parte inferior da página de configurações
+2. Vá para **Geral → Segurança**
+3. Ative a alternância **Sincronizar emails internos** para incluir emails em que todos os participantes compartilham o mesmo domínio
+
+Essa é uma configuração em todo o workspace (útil para universidades ou organizações com domínio compartilhado).
+</Note>
+
+### Controle quais emails são sincronizados com a Seleção de Pastas de Mensagens
+
+Controle quais pastas de email sincronizam com o Twenty:
+
+1. Vá para **Configurações → Contas** e selecione sua conta de email conectada
+2. Escolha quais pastas sincronizar:
+   * **Caixa de Entrada**: Principais emails recebidos
+   * **Enviado**: Emails de saída que você enviou
+   * **Pastas Personalizadas**: Quaisquer pastas específicas que você deseja incluir
+   * **Excluir Pastas**: Pule pastas como Spam, Lixo, ou pastas pessoais
+
+Isso lhe dá controle preciso sobre quais emails aparecem no seu CRM sem sincronizar tudo.
+
+**O Que é Sincronizado:**
+
+* **Emails Externos**: Todos os emails com contatos externos das pastas selecionadas
+* **Emails internos**: Não sincronizados por padrão (emails do mesmo domínio permanecem privados). Ative a alternância **Avançado** na parte inferior de **Configurações** e, em seguida, ative **Sincronizar emails internos** em **Geral → Segurança** para incluí-los em todo o workspace.
+* **Anexos**: Disponível em H1 2026
+
+**Nota**: Não fornecemos um endereço de email CC para sincronização seletiva. Em vez disso, use o recurso Pasta de Mensagem acima para conseguir o mesmo nível de controle sobre quais emails sincronizam com o Twenty.
+
+## Configuração do Calendário
+
+### Visibilidade do Evento
+
+Escolha o que ficará visível para outros utilizadores no seu espaço de trabalho:
+
+* **Tudo**: os detalhes de todo o evento serão compartilhados com seu time
+* **Metadados**: Somente data e participantes serão compartilhados com sua equipe
+
+### Criação Automática de Contato para Reuniões
+
+* **Sim**: Criar contatos automaticamente para participantes de reuniões que não estão no seu CRM
+* **Não**: Apenas vincula reuniões a contatos existentes
+
+<Note>Quando ativado, os contactos são automaticamente associados aos respetivos registos de Empresa com base no domínio de email. Se a empresa ainda não existir, o Twenty cria-a por si.</Note>
+
+### Controle quais eventos serão sincronizados
+
+* **Importação de Reuniões**: Importar automaticamente eventos de calendário
+* **Vinculação de Contatos**: Vincular reuniões a registros de Pessoas e Empresas
+
+**O Que é Sincronizado:**
+
+* **Reuniões**: Eventos de calendário com participantes externos
+* **Vinculação de Contatos**: Eventos automaticamente vinculados aos registros do CRM
+* **Eventos de Equipe**: Visibilidade de calendário compartilhada
+
+## Frequência de Sincronização
+
+**Atualizações a cada 5 minutos**: Tanto os dados de email quanto de calendário são sincronizados automaticamente a cada 5 minutos após a importação inicial.
+
+<Note>
+**Tempo de sincronização inicial**: A sincronização do calendário é concluída rapidamente (geralmente em poucos minutos), enquanto a sincronização de emails leva mais tempo para caixas de correio grandes. Twenty importa emails a uma taxa de aproximadamente **400 mensagens por minuto** (limitado pela restrição de taxa da API do Gmail), por isso uma caixa de correio com 10.000 emails leva cerca de 25 minutos. Não se preocupe se vir contactos de eventos do calendário a aparecer antes dos seus contactos de email; isto é um comportamento normal.
+</Note>
+
+## Próximos Passos
+
+* [Funcionalidades da caixa de correio](/l/pt/user-guide/calendar-emails/capabilities/mailbox)
+* [Resolver problemas de emails em falta](/l/pt/user-guide/calendar-emails/how-tos/i-dont-see-emails-on-records)

packages/twenty-docs/l/pt/user-guide/dashboards/capabilities/chart-settings.mdx

@@ -0,0 +1,275 @@
+---
+title: Configurações do Gráfico
+description: Configure seus gráficos para exibir os dados exatamente como você precisa.
+---
+
+import { ChartIcon } from '/snippets/chart-icon.mdx';
+
+## Acessando as configurações do gráfico
+
+1. Clique no botão **Editar** no canto superior direito do seu painel
+
+<img src="/images/user-guide/dashboard/dashboard-edit.png" alt="Modo de edição" />
+
+2. O painel entra no modo de edição
+3. Clique em qualquer widget para selecioná-lo
+4. O painel de configurações é aberto à direita
+
+As configurações são organizadas em seções:
+
+* **Dados**: Quais dados obter e como filtrá-los
+* **Eixo X**: Como agrupar e ordenar categorias (gráficos de barras/linhas)
+* **Eixo Y**: O que medir e como exibir (gráficos de barras/linhas)
+* **Estilo**: Cores, rótulos e opções visuais
+
+<Note>
+Algumas configurações só aparecem quando outras estão configuradas. Por exemplo, **Granularidade de data** só aparece quando você seleciona um campo de data.
+</Note>
+
+---
+
+## Configurações de Dados
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="database" />Fonte </span>
+
+Escolha de qual objeto extrair os dados.
+
+1. Clique em **Fonte**
+2. Selecione um objeto (Oportunidades, Pessoas, Empresas, etc.)
+
+Todos os seus objetos padrão e personalizados estão disponíveis. Alterar a fonte redefine outras configurações, pois as opções de campo dependem do objeto selecionado.
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-source.png" alt="Fonte" />
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="filter" />Filtro </span>
+
+Limite quais registros são incluídos no gráfico.
+
+1. Clique em **Filtrar**
+2. O construtor de filtros é aberto
+3. Clique em **+ Adicionar filtro**
+4. Selecione um campo, condição e valor
+5. Adicione mais filtros conforme necessário
+
+Os filtros funcionam da mesma forma que nas visualizações de tabela. Use-os para focar em segmentos específicos dos seus dados.
+
+**Exemplo**: Filtre oportunidades em que a Etapa seja igual a "Ganha" para mostrar apenas negócios fechados.
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-filters.png" alt="Filtro" />
+
+<Tip>
+Para campos de data, experimente **É relativo** para criar filtros dinâmicos como "Últimos 7 dias" ou "Este mês" que são atualizados automaticamente.
+</Tip>
+
+<Tip>
+Filtros avançados são suportados—adicione várias regras de filtro e combine-as com a lógica **E** ou **Ou**.
+</Tip>
+
+---
+
+## Configurações do Eixo X
+
+Essas configurações controlam o eixo horizontal dos gráficos de barras e de linhas—geralmente como seus dados são agrupados em categorias.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="axis-x" />Dados em exibição </span>
+
+Selecione o campo pelo qual agrupar seus dados. Isso determina as categorias exibidas no eixo X.
+
+**Exemplo**: Selecione "Etapa" para ver os dados agrupados pela etapa do pipeline, ou "Data de criação" para ver os dados ao longo do tempo.
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-x-data-on-display.png" alt="Dados em exibição" />
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="calendar" />Granularidade de data </span>
+
+Ao agrupar por um campo de data, escolha o período de tempo para o agrupamento.
+
+| Opção                | Agrupa dados por         | Exemplo de saída                                                   |
+| -------------------- | ------------------------ | ------------------------------------------------------------------ |
+| **Dia**              | Cada dia do calendário   | 1º de jan., 2 de jan., 3 de jan....                                |
+| **Semana**           | Semanas do calendário    | Semana 1, Semana 2, Semana 3...                                    |
+| **Mês**              | Meses do calendário      | janeiro, fevereiro, março...                                       |
+| **Trimestre**        | Trimestres fiscais       | T1, T2, T3, T4                                                     |
+| **Ano**              | Anos do calendário       | 2023, 2024, 2025                                                   |
+| **Dia da semana**    | Dia da semana (agregado) | segunda-feira, terça-feira... (todas as segundas-feiras agregadas) |
+| **Mês do ano**       | Mês (agregado)           | janeiro, fevereiro... (todos os janeiros agregados)                |
+| **Trimestre do ano** | Trimestre (agregado)     | T1, T2, T3, T4 (todos os T1 agregados)                             |
+
+As opções "de semana/ano" agregam ao longo de todo o tempo. Use **Dia da semana** para ver qual dia da semana normalmente tem mais negócios. Use **Mês** para ver tendências mês a mês.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="arrows-sort" />Ordenar por </span>
+
+Controle a ordem das categorias no eixo X.
+
+* **Posição** – Usa a ordem definida nas configurações do seu campo Select
+* **Alfabética** – De A a Z (ou cronológica para datas)
+* **Por valor** – Ordenado pela métrica (do maior para o menor ou vice-versa)
+* **Manual** – Arraste para definir sua própria ordem
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-x-sort.png" alt="Ordenar por" />
+
+**Dica**: Para etapas do pipeline, use **Posição** para mostrar as etapas na ordem do seu processo de vendas (Lead → Qualificado → Proposta → Ganha).
+
+<Note>
+As opções exibidas dependem do tipo do seu campo. Campos Select têm todas as opções; campos de data e de texto exibem menos.
+</Note>
+
+<Tip>
+Com a ordenação **Manual**, arraste as categorias para criar uma ordem personalizada—perfeito para destacar segmentos específicos ou contar uma história com seus dados.
+</Tip>
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="eye-off" />Omitir valores zero </span>
+
+Oculte categorias que têm zero ou nenhum dado.
+
+* **Ativado**: Categorias sem registros são ocultadas
+* **Desativado**: Todas as categorias são exibidas, mesmo que vazias
+
+Use isso para limpar gráficos com dados esparsos.
+
+---
+
+## Configurações do Eixo Y
+
+Essas configurações controlam o que você está medindo e como isso é exibido.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="axis-y" />Dados em exibição </span>
+
+Selecione o campo e a operação para calcular sua métrica.
+
+* **Contagens** – Contar todos, Contar vazios, Contar não vazios, Contar valores únicos
+* **Matemática** – Soma, Média, Mín., Máx. (campos numéricos)
+* **Percentuais** – Percentual vazio, Percentual não vazio
+
+Campos booleanos adicionam Contar verdadeiro/falso. Gráficos agregados com campos de data exibem Mais antigo/Mais recente.
+
+**Exemplo**: Selecione "Valor" com Soma para ver o valor total de negócios por categoria, ou Contar todos para ver o número de negócios.
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-data-on-display.png" alt="Dados em exibição" />
+
+<Note>
+As opções exibidas dependem do seu campo e do tipo de gráfico. Se você não vir uma operação esperada, verifique o tipo do seu campo.
+</Note>
+
+### Razão
+
+Para campos Select, Multi-select ou Booleanos, você pode calcular o percentual de um valor específico.
+
+1. Selecione um campo Select, Multi-select ou Booleano
+2. Ativar **Proporção**
+3. Escolha a opção a ser medida
+
+**Exemplo**: Mostrar negócios "Ganho" como porcentagem de todas as oportunidades. Se você tiver 10 Ganhos de um total de 50, o gráfico mostrará 20%.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="filters" />Agrupar por </span>
+
+Adicione uma segunda dimensão para criar várias séries (múltiplas barras ou linhas).
+
+1. Defina primeiro o campo do eixo X
+2. Clique em **Agrupar por**
+3. Selecione um segundo campo
+
+**Exemplo**: Agrupe os negócios por Etapa (Eixo X) E por Responsável (Agrupar por) para ver, lado a lado, a distribuição do pipeline de cada pessoa.
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-group-by.png" alt="Agrupar por" />
+
+Quando Agrupar por estiver definido, você verá várias cores em seu gráfico e uma legenda aparecerá.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="calendar" />Granularidade de data </span>
+
+Quando Agrupar por for um campo de data, escolha o período de tempo (mesmas opções do eixo X).
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="arrows-sort" />Ordenar por </span>
+
+Quando **Agrupar por** estiver definido, controle a ordem das séries agrupadas (por exemplo, qual barra do responsável aparece primeiro em cada categoria).
+
+Mesmas opções da ordenação do eixo X—Posição, Alfabética e Manual—exceto que **a ordenação baseada em valor não está disponível** para o agrupamento secundário.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="chart-bar-popular" />Acumulado </span>
+
+Mostre totais acumulados em vez de valores individuais.
+
+* **Desativado**: Cada barra/ponto mostra seu próprio valor
+* **Ativado**: Cada barra/ponto mostra a soma de todos os valores anteriores mais o seu próprio
+
+**Exemplo**: janeiro = 10, fevereiro = 15
+
+* Acumulado desativado: Mostra 10 e 15
+* Acumulado ativado: Mostra 10 e 25 (10 + 15)
+
+Use o acumulado para acompanhar o progresso em direção a uma meta ao longo do tempo.
+
+<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-cumulative.png" alt="Acumulado" />
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="math-min" />Faixa mínima / <ChartIcon icon="math-max" />Faixa máxima </span>
+
+Defina valores mínimos e máximos fixos para o eixo Y.
+
+* Deixe em branco para dimensionamento automático
+* Insira um número para fixar o limite
+
+**Quando usar:**
+
+* Defina Mín. como 0 para comparações visuais precisas
+* Defina ambos para escalas consistentes em vários gráficos
+* Foque em um intervalo de valores específico definindo ambos
+
+---
+
+## Configurações de Estilo
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="color-swatch" />Cores </span>
+
+Defina o esquema de cores do seu gráfico. Escolha entre uma variedade de paletas de cores.
+
+<Note>
+Ao agrupar por um campo Select, o gráfico usa automaticamente as cores definidas para cada opção nas configurações do seu campo.
+</Note>
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="gizmo" />Nome do eixo </span>
+
+Escolha quais rótulos de eixo mostrar: **Nenhum**, **Eixo X**, **Eixo Y** ou **Ambos** (somente gráficos de barras e de linhas).
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="stack-2" />Barras empilhadas / Linhas empilhadas </span>
+
+Quando Agrupar por estiver definido, escolha como várias séries serão exibidas.
+
+* **Desativado (Agrupadas)**: As séries aparecem lado a lado. Use ao comparar valores exatos entre grupos.
+* **Ativado (Empilhadas)**: As séries são empilhadas umas sobre as outras. Use ao mostrar composição—como as partes compõem o todo.
+
+**Exemplo**: Negócios por etapa, agrupados por responsável
+
+* Agrupadas: Veja os números exatos de cada responsável lado a lado
+* Empilhadas: Veja o total de negócios por etapa, com a contribuição de cada responsável empilhada
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="badge-2k" />Rótulos de dados </span>
+
+Mostre valores diretamente nos elementos do gráfico (barras, pontos, fatias).
+
+* **Ativado**: Os valores aparecem no gráfico
+* **Desativado**: Nenhum valor exibido (visual mais limpo)
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="text-caption" />Legenda </span>
+
+Mostrar ou ocultar a legenda (só aparece quando Agrupar por está definido).
+
+* **Ativado**: A legenda mostra o que cada cor representa
+* **Desativado**: Nenhuma legenda exibida
+
+<Tip>
+**Passe o mouse** sobre um item da legenda para destacar esse grupo. **Clique** para ocultá-lo temporariamente do gráfico.
+</Tip>
+
+---
+
+## Notas específicas do gráfico
+
+### Gráficos de pizza
+
+* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="chart-pie" size={16} /></span> **Cada fatia representa** – Defina como as fatias são agrupadas
+* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="eye-off" size={16} /></span> **Ocultar categoria vazia** – Remover fatias de valor zero
+* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="number-123" size={16} /></span> **Mostrar valor no centro** – Exibir o valor agregado (soma, média, contagem etc.)
+
+### Gráficos agregados
+
+* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="caret-left" size={16} /></span> **Prefixo** – Adicionar texto antes do número (por exemplo, `$`)
+* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="caret-right" size={16} /></span> **Sufixo** – Adicionar texto após o número (por exemplo, `%`)

packages/twenty-docs/l/pt/user-guide/dashboards/capabilities/dashboards.mdx

@@ -0,0 +1,92 @@
+---
+title: Painéis
+description: Crie e organize painéis com abas para visualizar seus dados do CRM.
+---
+
+## Visão Geral
+
+Os painéis no Twenty são organizados em uma hierarquia: **Painéis → Abas → Widgets**. Cada painel pode conter várias abas, e cada aba contém widgets (gráficos, números, iFrames).
+
+## Criando um painel
+
+1. Vá até **Dashboards** na navegação
+2. Clique em **+ New Record**
+
+<img src="/images/user-guide/dashboard/dashboard-create-new.png" alt="Criar novo painel de controle" />
+
+3. Dê um nome ao seu painel
+4. Comece a adicionar abas e widgets
+
+## Trabalhando com abas
+
+As abas ajudam você a organizar seu painel em seções lógicas.
+
+### Criando abas
+
+1. No modo de edição, clique em **+** na barra de abas, e um painel lateral será aberto à direita
+2. Dê um nome à sua aba (por exemplo, "Visão geral do pipeline", "Desempenho da equipe")
+3. Adicione widgets à aba
+
+### Reordering Tabs
+
+1. No modo de edição, clique e segure na guia que deseja mover
+2. Arraste e solte para a nova posição
+3. Você também pode clicar na aba e usar o menu de comando para mover a guia para a esquerda ou direita
+
+### Excluindo abas
+
+1. No modo de edição, clique na aba que deseja excluir
+2. Clique no botão **Excluir** no menu de comando
+
+### Duplicando abas
+
+1. Clique na aba que você deseja duplicar
+2. Clique no botão **Duplicate** no painel lateral
+
+<img src="/images/user-guide/dashboard/dashboard-tabs.png" alt="Aba do Painel" />
+
+## Layout do painel
+
+### Organizando widgets
+
+* Arraste e solte para posicionar
+* Redimensione para dar destaque
+* Agrupe gráficos relacionados
+
+### Duplicando um painel
+
+1. Selecione o painel que você deseja duplicar
+2. Abra a barra de comandos com **Cmd + K** (ou **Ctrl + K** no Windows)
+3. Selecione **Duplicar painel**
+
+<img src="/images/user-guide/dashboard/dashboard-duplicate.png" alt="Duplicar painel de controle" />
+
+### Melhores Práticas
+
+* **Fluxo lógico**: organize do geral ao detalhado
+* **Hierarquia visual**: gráficos maiores para métricas-chave
+* **Estilo consistente**: use cores e fontes correspondentes
+
+## Visibilidade e acesso
+
+### Visibilidade do painel
+
+Os painéis são visíveis para todos que têm acesso ao seu espaço de trabalho da Twenty. No momento, não há opção de painel privado.
+
+### Favoritos
+
+Você pode adicionar painéis aos seus favoritos para acesso rápido. Esta é uma configuração pessoal — seus favoritos não são visíveis para outros usuários.
+
+Para adicionar um painel aos favoritos, abra o painel e clique no ícone de estrela.
+
+### Comportamento do fuso horário
+
+Atualmente, os painéis exibem dados com base no fuso horário de quem está visualizando. Isso significa que o mesmo painel pode mostrar métricas diferentes para membros da equipe em regiões distintas (por exemplo, APAC vs. US).
+
+<Note>
+**Em breve**: adicionaremos a capacidade de definir um fuso horário específico para um painel, para que todos os usuários vejam dados consistentes independentemente de sua localização.
+</Note>
+
+<Note>
+**Em breve**: filtros no nível do painel permitirão aplicar filtros a todos os widgets de uma vez, tornando mais rápido explorar seus dados.
+</Note>

packages/twenty-docs/l/pt/user-guide/dashboards/capabilities/widgets.mdx

@@ -0,0 +1,169 @@
+---
+title: Widgets
+description: Explore os tipos de widget e as opções de visualização no Twenty.
+---
+
+import { ChartIcon } from '/snippets/chart-icon.mdx';
+
+## Widgets disponíveis
+
+O Twenty oferece vários tipos de widget para visualizar seus dados de CRM.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-bar-popular" />Gráficos de barras</span>
+
+Exiba dados como barras horizontais ou verticais.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-bar-chart.png" alt="Gráfico de barras" />
+</Frame>
+
+**Melhor para:**
+
+* Comparar valores entre categorias
+* Mostrar classificações
+* Acompanhar métricas por período de tempo
+
+**Exemplos de uso:**
+
+* Negócios por etapa
+* Receita por representante de vendas
+* Contatos adicionados por mês
+
+<Note>
+**Limites de exibição**: gráficos de barras podem mostrar no máximo 100 barras e 50 grupos por barra ao usar Agrupar por. Se você vir o aviso "Undisplayed data: max X bars per chart", adicione filtros para reduzir seus dados ou altere o agrupamento (por exemplo, agrupe por semana em vez de por dia).
+</Note>
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-pie" />Gráficos de pizza</span>
+
+Exiba proporções do todo.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-pie-chart.png" alt="Gráfico de pizza" />
+</Frame>
+
+**Melhor para:**
+
+* Mostrar composição ou distribuição
+* Comparar partes com o todo
+* Destacar os principais segmentos
+
+**Exemplos de uso:**
+
+* Distribuição de negócios por origem
+* Distribuição de contatos por setor
+* Composição do pipeline por responsável
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-line" />Gráficos de linha</span>
+
+Exiba tendências ao longo do tempo.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-line-chart.png" alt="Gráfico de linha" />
+</Frame>
+
+**Melhor para:**
+
+* Acompanhar mudanças ao longo do tempo
+* Identificar tendências
+* Comparar várias métricas
+
+**Exemplos de uso:**
+
+* Tendência mensal do número de negócios
+* Crescimento da receita ao longo dos trimestres
+* Níveis de atividade ao longo do tempo
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="sum" />Gráficos agregados</span>
+
+Exiba em destaque valores-chave únicos.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-aggregate-chart.png" alt="Gráfico agregado" />
+</Frame>
+
+**Melhor para:**
+
+* Destacar KPIs
+* Mostrar totais ou médias
+* Verificações rápidas de status
+
+**Exemplos de uso:**
+
+* Valor total do pipeline
+* Número de oportunidades em aberto
+* Taxa de conversão
+
+**Opções avançadas:**
+
+* **Proporção**: para campos do tipo Seleção, calcule proporções entre valores. Vá para **Dados em exibição** → selecione seu campo → ative a opção **Proporção**.
+* **Prefixo e Sufixo**: adicione texto personalizado antes ou depois do número (por exemplo, prefixo "$" ou sufixo "%") para melhor legibilidade.
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="frame" />iFrames</span>
+
+Incorpore ferramentas e conteúdo externos diretamente no seu painel.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-table.png" alt="Gráfico de tabela" />
+</Frame>
+
+**Melhor para:**
+
+* Pesquisando itens individuais
+* Verificando valores exatos
+* Auditoria ou referência
+
+**Exemplos de uso:**
+
+* Negócios que serão fechados neste mês
+* Novos leads nesta semana
+* Faturas em atraso
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="table" />Tabela</span>
+
+Veja os registros filtrados diretamente no seu painel.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-iframe.png" alt="iFrame" />
+</Frame>
+
+**Melhor para:**
+
+* Exibir relatórios ou painéis externos
+* Integrar ferramentas de vendas de terceiros
+* Mostrar conteúdo em tempo real de outros sistemas
+
+**Exemplos de uso:**
+
+* Métricas da sua ferramenta de Suporte
+* Métricas do seu discador
+* Conteúdo em tempo real da sua ferramenta de sequências de Vendas
+
+### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="align-box-left-top" />Texto enriquecido</span>
+
+Adicione texto e conteúdo formatados diretamente ao seu painel.
+
+<Frame>
+<img src="/images/user-guide/dashboard/dashboard-widget-rich-text.png" alt="Texto enriquecido" />
+</Frame>
+
+**Melhor para:**
+
+* Adicionar contexto ou instruções
+* Descrições do painel
+* Notas e anotações
+
+**Recursos:**
+
+* Formatação de texto enriquecido (negrito, itálico, listas, etc.)
+* Envio de imagens e arquivos
+* Edição no estilo Markdown
+
+<Note>
+**Em breve**: gráficos de medidor ainda não estão disponíveis, mas estão em nosso roteiro.
+</Note>
+
+### Duplicar widgets
+
+1. Clique no widget
+2. Abra **Opções**
+3. Clique em **Duplicar widget**

packages/twenty-docs/l/pt/user-guide/dashboards/how-tos/dashboards-faq.mdx

@@ -0,0 +1,54 @@
+---
+title: Perguntas frequentes sobre painéis
+description: Perguntas frequentes sobre painéis na Twenty.
+---
+
+<AccordionGroup>
+  <Accordion title="Posso criar painéis privados?">
+    Não, os painéis atualmente são visíveis para todos que têm acesso ao seu espaço de trabalho da Twenty. Painéis privados ainda não estão disponíveis.
+  </Accordion>
+
+  <Accordion title="Por que minhas métricas parecem diferentes das do meu colega?">
+    Atualmente, os painéis exibem dados com base no fuso horário de quem está visualizando. Se vocês estiverem em regiões diferentes (por exemplo, APAC vs. EUA), poderão ver números ligeiramente diferentes para o mesmo painel. Estamos trabalhando para adicionar uma configuração de fuso horário por painel para garantir dados consistentes entre as equipes.
+  </Accordion>
+
+  <Accordion title="Posso exportar meu painel?">
+    A exportação de painéis não está disponível no momento. Este recurso está em nosso roadmap.
+  </Accordion>
+
+  <Accordion title="Posso compartilhar painéis com usuários externos?">
+    Não, compartilhar painéis com usuários fora do seu espaço de trabalho da Twenty (usuários que não são da Twenty) não é suportado no momento.
+  </Accordion>
+
+  <Accordion title="Como adiciono um painel aos meus favoritos?">
+    Abra o painel que você quer adicionar aos favoritos e clique no ícone de estrela. Os favoritos são pessoais — não afetam outros usuários.
+  </Accordion>
+
+  <Accordion title="Qual é a diferença entre abas e widgets?">
+    * **Abas** organizam seu painel em seções (como páginas dentro do painel)
+    * **Widgets** são as visualizações individuais (gráficos, números, iFrames) dentro de cada aba
+
+    Estrutura: Painel → Abas → Widgets
+  </Accordion>
+
+  <Accordion title="Posso filtrar um painel inteiro de uma só vez?">
+    Filtros no nível do painel ainda não estão disponíveis, mas este recurso está em nosso roadmap. No momento, é preciso aplicar filtros a cada widget individualmente.
+  </Accordion>
+
+  <Accordion title="Gráficos de medidor estão disponíveis?">
+    Ainda não. Gráficos de medidor estão em nosso roadmap e serão adicionados em uma versão futura.
+  </Accordion>
+
+  <Accordion title="Como duplico um painel?">
+    1. Certifique-se de que está no modo de visualização (não de edição)
+    2. Abra a barra de comandos com **Cmd + K** (ou **Ctrl + K** no Windows)
+    3. Selecione **Duplicar painel**
+  </Accordion>
+
+  <Accordion title="Com que frequência os dados do painel são atualizados?">
+    Os widgets são atualizados automaticamente conforme seus dados de CRM mudam:
+    * Atualizações em tempo real para a maioria das métricas
+    * Use o botão Atualizar para uma atualização manual, se necessário
+    * Os dados históricos são preservados para análise de tendências
+  </Accordion>
+</AccordionGroup>

packages/twenty-docs/l/pt/user-guide/dashboards/how-tos/widget-faq.mdx

@@ -0,0 +1,67 @@
+---
+title: FAQ do Widget
+description: Perguntas frequentes e mensagens de erro explicadas.
+---
+
+<AccordionGroup>
+  <Accordion title="Como exibir porcentagens em vez de contagens?">
+    Três opções:
+
+    * **Percentual vazio/não vazio**: Em Dados exibidos, selecione Percentual vazio ou Percentual não vazio
+    * **Proporção**: Para campos Seleção ou Caixa de seleção, ative Proporção para mostrar uma opção específica como porcentagem de todos os registros
+    * **Sufixo**: Para gráficos agregados, adicione `%` como Sufixo nas configurações de Estilo
+  </Accordion>
+
+  <Accordion title="Qual é a diferença entre barras agrupadas e empilhadas?">
+    Ao usar **Agrupar por**, você pode exibir as séries de duas maneiras:
+
+    * **Agrupadas**: Barras lado a lado—ideal para comparar valores exatos
+    * **Empilhadas**: Barras uma sobre a outra—ideal para mostrar composição
+
+    Alterne **Empilhadas** nas configurações de Estilo para mudar.
+  </Accordion>
+
+  <Accordion title="Por que não consigo ver as opções Soma ou Média?">
+    As operações disponíveis dependem do **tipo de campo**:
+
+    * **Campos numéricos**: Soma, Média, Mín., Máx.
+    * **Campos de data**: Mais antigo, Mais recente (apenas para gráficos agregados)
+    * **Campos de caixa de seleção**: Contar verdadeiro, Contar falso
+
+    Se você não vir uma opção, verifique se selecionou um tipo de campo compatível.
+  </Accordion>
+
+  <Accordion title="Por que algumas configurações estão acinzentadas ou ausentes?">
+    Muitas configurações só aparecem quando os pré-requisitos são atendidos:
+
+    * **Granularidade de data**: Selecione primeiro um campo de data
+    * **Agrupar por, Legenda, Empilhadas**: Defina a Fonte primeiro
+    * **Alternadores de Legenda e Empilhadas**: Defina Agrupar por primeiro
+
+    Se uma configuração estiver ausente, configure primeiro seu pré-requisito.
+  </Accordion>
+
+  <Accordion title="O que significa 'Sem dados'?">
+    O gráfico não encontrou nenhum registro que corresponda à sua configuração.
+
+    **Como corrigir:** Remova ou ajuste os filtros, verifique se você selecionou o objeto Fonte correto ou confirme se existem registros para seu intervalo de datas.
+  </Accordion>
+
+  <Accordion title="O que significa 'Configuração inválida'?">
+    Uma configuração obrigatória está ausente ou é incompatível.
+
+    **Como corrigir:** Certifique-se de que a Fonte esteja definida, que Dados exibidos estejam configurados e que quaisquer campos de agrupamento obrigatórios estejam selecionados.
+  </Accordion>
+
+  <Accordion title="O que significa 'Dados não exibidos'?">
+    Seus dados excedem os limites de exibição (100 barras, 100 pontos de dados ou 100 fatias).
+
+    **Como corrigir:** Adicione filtros para restringir seus dados ou altere a granularidade de data de Dia para Semana ou Mês.
+  </Accordion>
+
+  <Accordion title="Por que um dos eixos não mostra dados?">
+    O campo selecionado não tem valores para os registros no seu filtro, ou o tipo de campo não corresponde aos dados esperados.
+
+    **Como corrigir:** Tente um campo diferente ou verifique se os registros têm valores para o campo selecionado.
+  </Accordion>
+</AccordionGroup>

packages/twenty-docs/l/pt/user-guide/dashboards/overview.mdx

@@ -0,0 +1,75 @@
+---
+title: Painéis
+description: Aprenda o básico sobre relatórios e painéis no Twenty.
+---
+
+## Entendendo os painéis
+
+Os painéis no Twenty oferecem uma forma visual de acompanhar suas principais métricas de desempenho e obter insights dos seus dados de CRM.
+
+<img src="/images/user-guide/dashboard/dashboards_v2.png" alt="Painéis" />
+
+## Conceitos principais
+
+### Painéis
+
+Um painel é uma coleção de abas que exibem seus dados de CRM num relance. Você pode criar vários painéis para diferentes finalidades:
+
+* Desempenho de vendas
+* Atividade da equipe
+* Saúde do pipeline
+* Métricas personalizadas
+
+### Abas
+
+As abas permitem organizar seu painel em seções. Cada aba contém um ou mais widgets.
+
+### Widgets
+
+Widgets são visualizações individuais que exibem dados específicos. Os tipos incluem:
+
+* Gráficos de barras
+* Gráficos de pizza
+* Gráficos de linha
+* Gráficos agregados
+* iFrames
+* Texto enriquecido
+
+<Note>
+**Limitações atuais**:
+* A exportação de painéis e o compartilhamento com usuários externos (usuários não-Twenty) não estão disponíveis no momento.
+* Gráficos de indicador ainda não estão disponíveis.
+</Note>
+
+## Primeiros passos
+
+### Criando seu primeiro painel
+
+1. Navegue até a seção **Dashboards**
+2. Clique em **+ New Dashboard**
+3. Dê um nome ao seu painel
+4. Adicione abas para organizar seu conteúdo
+5. Adicione widgets para exibir seus dados
+6. Salvar
+
+### Adicionando widgets
+
+1. Abra uma aba no seu painel
+2. Clique em **+ Add Widget**
+3. Selecione o tipo de widget
+4. Escolha a fonte de dados (objeto)
+5. Configure as configurações do widget
+6. Salve e visualize seu widget
+
+## Melhores Práticas
+
+* **Comece simples**: Inicie com algumas métricas-chave e adicione mais ao longo do tempo
+* **Foque em dados acionáveis**: Exiba métricas que orientem as decisões
+* **Revisão regular**: Verifique seus painéis regularmente para identificar tendências
+* **Compartilhe com a equipe**: Torne os painéis visíveis para os membros relevantes da equipe
+
+## Próximos Passos
+
+* [Widgets e visualizações](/l/pt/user-guide/dashboards/capabilities/widgets)
+* [Referência das configurações de gráfico](/l/pt/user-guide/dashboards/capabilities/chart-settings)
+* [FAQ de painéis](/l/pt/user-guide/dashboards/how-tos/dashboards-faq)

packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/error-handling.mdx

@@ -0,0 +1,76 @@
+---
+title: Tratamento de erros e validação
+description: Revise e corrija os erros de importação diretamente na IU antes de confirmar.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Validação pré-importação
+
+Depois de carregar o seu ficheiro e mapear os campos, o Twenty valida os seus dados **antes** de os importar. Isto permite detetar e corrigir erros sem afetar os seus dados existentes.
+
+## Como Funciona
+
+1. **Carregue** o seu ficheiro CSV
+2. **Mapeie** as suas colunas para os campos do Twenty
+3. **Revise** os potenciais erros destacados em amarelo
+4. **Corrija os erros** diretamente na IU
+5. **Confirme** a importação
+
+<VimeoEmbed videoId="1145273857" title="Demonstração em vídeo" />
+
+## Apresentação de erros
+
+As linhas com erros são destacadas em **amarelo**. Pode:
+
+* **Edite a célula diretamente** para corrigir o erro
+* **Remova a linha** para a ignorar por completo
+
+Esta edição em linha poupa tempo — não é necessário voltar à sua folha de cálculo, corrigir os erros e voltar a carregar.
+
+## Tipos de erro comuns
+
+### Valores duplicados
+
+**Causa**: Um campo único (email, domínio) já existe no Twenty ou aparece duas vezes no seu ficheiro.
+
+**Correção**:
+
+* Edite o valor duplicado na IU de importação
+* Remova uma das linhas duplicadas
+
+Consulte [Restrições de unicidade](/l/pt/user-guide/data-migration/capabilities/uniqueness-constraints) para mais detalhes sobre como a unicidade é aplicada.
+
+### Formato inválido
+
+**Causa**: Os dados não correspondem ao formato esperado (por exemplo, email inválido, formato de data incorreto).
+
+**Correção**: Edite a célula para usar o formato correto.
+
+Consulte [Mapeamento de Campos](/l/pt/user-guide/data-migration/capabilities/field-mapping) para o formato esperado de cada tipo de campo.
+
+### Campos obrigatórios ausentes
+
+**Causa**: Um campo obrigatório está vazio.
+
+**Correção**: Introduza um valor no campo obrigatório ou remova a linha.
+
+### Relação não encontrada
+
+**Causa**: O registo referenciado não existe (por exemplo, um domínio de Empresa que não foi importado).
+
+**Correção**:
+
+* Importe primeiro os registos pai
+* Ou corrija o valor de referência
+
+Consulte [Importar relações](/l/pt/user-guide/data-migration/capabilities/import-relations) para conhecer a ordem correta de importação e como ligar registos.
+
+## Dicas para reduzir erros
+
+1. **Baixe o modelo** para ver o formato esperado antes de importar o seu arquivo
+2. **Limpe os seus dados** primeiro na folha de cálculo
+3. **Importe os ficheiros na ordem correta** para importar relações (Empresas → Pessoas → Oportunidades)
+4. **Teste com pequenos lotes** antes da importação completa
+5. **Verifique se existem duplicados** antes de carregar
+6. **Limite de cada arquivo a 10.000 registros**

packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/field-mapping.mdx

@@ -0,0 +1,198 @@
+---
+title: Mapeamento de Campos
+description: Como o mapeamento de campos funciona durante a importação de dados.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Como funciona o mapeamento de campos
+
+Ao fazer upload de um arquivo, a Twenty analisa as suas colunas e tenta associá-las aos campos existentes.
+
+### Mapeamento automático
+
+A Twenty tenta associar as colunas com base em:
+
+* Nomes dos cabeçalhos das colunas (correspondências exatas ou semelhantes)
+* Detecção de tipo de dados (datas, números, e-mails)
+* Padrões comuns de campos
+
+<Note>**Dica rápida:** Exporte algumas linhas do objeto que você deseja importar. O arquivo exportado terá exatamente os nomes de coluna que a Twenty espera, facilitando o mapeamento automático durante a importação.</Note>
+
+### Opções de mapeamento manual
+
+Para cada coluna, você pode:
+
+* **Mapear para um campo**: selecione o campo correspondente da Twenty em um menu suspenso
+* **Não mapear**: ignore a coluna completamente (os dados não serão importados)
+
+<Note>**Os campos devem existir antes da importação.** A importação cria registros, não campos. Crie campos personalizados em **Configurações → Modelo de Dados** antes de importar.</Note>
+
+## Compatibilidade de tipos de campo
+
+Todos os tipos de campos disponíveis no Modelo de Dados são compatíveis com a importação.
+
+Você também pode importar valores de `id` para atribuir um ID específico a novos registros ou atualizar os existentes.
+
+<img src="/images/user-guide/fields/all-field-types.png" style={{width:'100%'}} />
+
+## Requisitos de formato de dados
+
+<Note>**Alguns campos têm sintaxe especial.** Recomendamos baixar o arquivo de exemplo antes de preparar sua importação para ver a sintaxe esperada para cada tipo de campo.</Note>
+
+### Campos de Endereço
+
+Endereço é um campo aninhado com várias colunas. Algumas podem ficar em branco.
+
+* **Endereço / Endereço 1**: Linha 1 do endereço
+* **Endereço / Endereço 2**: Linha 2 do endereço
+* **Endereço / Cidade**: Nome da cidade
+* **Endereço / Estado**: Estado ou província
+* **Endereço / País**: Nome do país
+* **Endereço / Código Postal**: Código Postal/CEP
+
+### Campos de Array
+
+Use o seguinte formato:
+
+```
+["value1","value2"]
+```
+
+### Campos Booleanos
+
+Use `TRUE` ou `FALSE` (em maiúsculas) - não `true` ou `false`
+
+### Campos de Moeda
+
+Moeda é um campo aninhado com duas colunas que **ambas devem ser preenchidas**:
+
+* **Valor / Valor**: O valor numérico (por exemplo, `1234.56`)
+* **Valor / Moeda**: O código da moeda (por exemplo, `USD`, `EUR`)
+
+### Campos de Data
+
+Formatos suportados:
+
+* `YYYY-MM-DD` (recomendado)
+* `MM/DD/YYYY`
+* `DD/MM/YYYY`
+* Formato ISO 8601
+
+### Campos de Domínio
+
+* Recomenda-se usar o formato `https://domain.com` para evitar a criação de duplicatas, pois esse é o formato usado para Empresas criadas pelas sincronizações da caixa de correio e do calendário
+* Um `Domain Label` e uma `Domain URL` podem ser preenchidos: a boa prática é preencher `domain.com` no rótulo e `https://domain.com` na URL
+* Domínios devem ser exclusivos no objeto Empresas
+* **Os domínios devem ser exclusivos dentro do arquivo a ser importado**
+
+### Campos de E-mail
+
+* Deve estar em um formato de e-mail válido
+* Os e-mails devem ser exclusivos dentro do objeto Pessoas
+* **Os e-mails devem ser exclusivos dentro do arquivo a ser importado**
+* Para e-mails adicionais: use **E-mails / E-mail principal** para o e-mail principal e **E-mails / E-mails adicionais** com este formato:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### Campos de ID
+
+Especificar um `id` durante a importação é opcional. A Twenty gera um automaticamente se não for fornecido.
+
+Casos de uso para mapear uma coluna `id`:
+
+* **Definir um ID específico**: escolha o UUID para registros recém-criados
+* **Atualizar registros existentes**: faça a correspondência com registros existentes para atualizá-los, em vez de criar duplicatas. Nesse caso, recomenda-se não mapear os outros campos exclusivos: mapear apenas um campo exclusivo garante uma importação mais tranquila.
+
+<Note>Se você fornecer um `id`, ele deve estar no formato UUID (por exemplo, `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
+
+### Campos JSON
+
+Use um formato JSON válido:
+
+```
+{"key":"value","key2":"value2"}
+```
+
+### Campos de Links
+
+Semelhante aos campos de Domínio:
+
+* Preencha as colunas de rótulo e URL: **Links / URL do link** e **Links / Rótulo do link**
+* Use o formato completo de URL: `https://example.com`
+* Para links secundários, use a coluna **Links / Links Secundários** com este formato:
+
+```
+[{"url":"https://twenty.com","label":"Twenty"}]
+```
+
+### Campos de Seleção Múltipla
+
+Use os **nomes da API** (não os rótulos de exibição) no seguinte formato:
+
+```
+["VALUE1","VALUE2"]
+```
+
+Veja [aqui](#finding-api-names-for-select-fields) onde encontrar os nomes da API.
+
+<Note>Novas opções de seleção não serão criadas automaticamente pela importação. Elas devem ser adicionadas em **Configurações → Modelo de Dados** antes de importar.</Note>
+
+<Warning>
+**Importar sobrescritas; ele não adiciona.**
+
+Se um registro já tiver `VALUE2` e `VALUE3` selecionados e você importar `["VALUE1"]`, o registro terá apenas `VALUE1` após a importação. As seleções anteriores são substituídas, não mescladas.
+</Warning>
+
+### Campos Numéricos
+
+* Apenas números
+* Decimais usam ponto: `1234.56`
+* Sem separadores de milhares
+
+### Campos de Telefone
+
+Telefone é um campo aninhado com várias colunas que devem ser preenchidas
+
+* **Telefones / Número de telefone principal**: O número de telefone (por exemplo, `4159095555`)
+* **Telefones / Código do país do telefone principal**: Código do país (por exemplo, `US`)
+* **Telefones / Código de chamada do telefone principal**: Código de discagem (por exemplo, `+1`)
+
+### Campos de Classificação
+
+Use o formato de nome da API: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4`, `RATING_5`
+
+### Campos de Relação
+
+Consulte nosso artigo dedicado: [Importar relações entre objetos](/l/pt/user-guide/data-migration/capabilities/import-relations)
+
+### Campos de Seleção
+
+Use o **nome da API** da opção (não o rótulo de exibição):
+
+```
+VALUE1
+```
+
+Veja [aqui](#finding-api-names-for-select-fields) onde encontrar os nomes da API.
+<Note>Novas opções de seleção não serão criadas automaticamente pela importação. Elas devem ser adicionadas em **Configurações → Modelo de Dados** antes de importar.</Note>
+
+### Campos de Texto
+
+* Nenhuma formatação especial é necessária
+* Espaços no início e no fim são removidos
+
+## Encontrar Nomes da API
+
+Para campos Select, Multi-Select e Array com opções predefinidas, você deve usar os **nomes da API**, não os rótulos de exibição.
+
+### Como encontrar nomes da API
+
+1. Vá para **Configurações → Modelo de Dados**
+2. Selecione o objeto e o campo
+3. Ative o **Modo Avançado** (alternador no canto inferior direito da página de configurações)
+4. Visualize o nome da API de cada opção
+
+<VimeoEmbed videoId="1144910809" title="Demonstração em vídeo" />

packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/file-formats.mdx

@@ -0,0 +1,48 @@
+---
+title: Formatos de Ficheiro Suportados
+description: Formatos de ficheiro suportados para importação de dados no Twenty.
+---
+
+## Formatos Suportados
+
+O Twenty suporta três formatos de ficheiro para importação:
+
+| Formato            | Extensão | Notas                        |
+| ------------------ | -------- | ---------------------------- |
+| **CSV**            | .csv     | Recomendado, mais compatível |
+| **Excel**          | .xlsx    | Formato moderno do Excel     |
+| **Excel (Legado)** | .xls     | Formato antigo do Excel      |
+
+## Requisitos do Ficheiro
+
+| Requisito              | Valor                                                  |
+| ---------------------- | ------------------------------------------------------ |
+| **Codificação**        | UTF-8 recomendado                                      |
+| **Limite de registos** | 10 000 registos por ficheiro                           |
+| **Estrutura**          | A primeira linha deve conter os cabeçalhos das colunas |
+| **Conteúdo**           | Um tipo de objeto por ficheiro                         |
+
+## Melhores Práticas para CSV
+
+* **Delimitador**: Utilize vírgula (`,`) ou ponto e vírgula (`;`)
+* **Qualificador de texto**: Utilize aspas duplas (`"`) para texto que contenha vírgulas
+* **Finais de linha**: Windows (CRLF) ou Unix (LF), ambos são suportados
+* **Valores vazios**: Deixe as células em branco, não utilize "NULL" ou "N/A"
+
+## Melhores Práticas para o Excel
+
+Ao exportar do Excel:
+
+* Remova as fórmulas (exporte apenas valores)
+* Elimine as linhas vazias no final
+* Garanta que não existam células combinadas
+* Utilize apenas a primeira folha
+
+## Grandes Conjuntos de Dados
+
+Para conjuntos de dados com mais de 10 000 registos:
+
+* Divida em vários ficheiros
+* Ou utilize a [importação via API](/l/pt/user-guide/data-migration/how-tos/import-data-via-api) para registos ilimitados
+
+<Note>Para migrações muito grandes (100 000+ registos), a API é significativamente mais rápida e fiável do que as importações em CSV.</Note>

packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/import-relations.mdx

@@ -0,0 +1,148 @@
+---
+title: Importar Relações Entre Objetos
+description: Importar relações entre registos via CSV.
+---
+
+## Visão Geral
+
+O Twenty suporta a importação de relações entre objetos durante a importação por CSV. Isto permite-lhe ligar registos (por exemplo, associar Pessoas a Empresas) como parte da sua migração de dados.
+
+<Note>**Atualmente suportado para importação**: Relações um-para-muitos que apontam para um único tipo de objeto de cada lado (por exemplo, Pessoas → Empresas). Relações que apontam para vários tipos de objeto ainda não são suportadas na importação/exportação.</Note>
+
+## Como funcionam as relações no Twenty
+
+### Um para Muitos / Muitos para Um
+
+O Twenty suporta relações padrão em que um registo se liga a muitos outros:
+
+* **Uma Empresa → Muitas Pessoas**: Uma empresa pode ter vários colaboradores, mas cada pessoa pertence a uma empresa
+* **Uma Empresa → Muitas Oportunidades**: Uma empresa pode ter vários negócios, mas cada oportunidade pertence a uma empresa
+
+### Relações que podem apontar para vários tipos de objeto
+
+Algumas relações podem ligar-se a diferentes tipos de objetos. Isto funciona de duas formas:
+
+**Padrão 1: Muitos registos a ligar-se, cada um, a um registo de diferentes tipos de objeto**
+
+Várias Notas ou Tarefas podem ser anexadas a vários tipos de objeto de uma só vez:
+
+* **Notas** podem ser ligadas a uma Pessoa, uma Empresa e uma Oportunidade em simultâneo
+* **Tarefas** podem ser ligadas a uma Pessoa, uma Empresa e uma Oportunidade em simultâneo
+
+Aqui, as Notas/Tarefas estão do lado "muitos". Cada uma liga-se a um registo por tipo de objeto.
+
+<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
+
+**Padrão 2: Um registo a receber ligações de muitos registos de diferentes tipos de objeto**
+
+Um Projeto pode receber ligações de vários registos de diferentes tipos de objeto:
+
+* **Um Projeto** pode ter muitas Pessoas ligadas a ele, muitas Empresas ligadas a ele e muitas Notas anexadas a ele
+
+Aqui, o Projeto está do lado "um". Vários registos de diferentes objetos podem ligar-se todos ao mesmo Projeto.
+
+<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
+
+<Warning>
+**Limitação de Importação/Exportação**: Relações que apontam para vários tipos de objeto (como Notas → Pessoas/Empresas/Oportunidades) **ainda não são suportadas** na importação ou exportação por CSV.
+
+* **Importação**: Apenas podem ser importadas relações um-para-muitos que apontem para um único tipo de objeto de cada lado
+* **Exportação**: As colunas para relações que apontam para vários tipos de objeto são, atualmente, deixadas em branco
+
+Isto está no nosso roadmap.
+</Warning>
+
+### O que não é suportado hoje
+
+**Relações muitos-para-muitos** ainda não estão disponíveis. Por exemplo, atualmente não pode criar uma relação em que:
+
+* Muitas Pessoas estão ligadas a muitos Projetos
+
+<Note>Relações muitos-para-muitos estão planeadas para o 2.º semestre de 2026.</Note>
+
+## Ligar registos durante a importação
+
+<Note>**Lembrete**: Só podem ser importadas relações um-para-muitos que apontem para um único tipo de objeto (por exemplo, Pessoas → Empresas). Relações que apontem para vários tipos de objeto (por exemplo, Notas → Pessoas/Empresas/Oportunidades) ainda não são suportadas.</Note>
+
+### Passo 1: Identificar os lados "Um" e "Muitos"
+
+Primeiro, determine qual o objeto que está do lado "um" e qual está do lado "muitos" da relação.
+
+**Exemplo**:
+
+* **Empresa** é o lado "um" (uma empresa tem muitos colaboradores)
+* **Pessoas** é o lado "muitos" (cada pessoa pertence a uma empresa)
+
+### Passo 2: Garanta que existem os registos do lado "Um"
+
+Antes de importar o lado "muitos", os registos do lado "um" já devem existir no Twenty.
+
+* Importe ou crie primeiro os registos do lado "um" (por exemplo, Empresas)
+* Valide o seu identificador único. Isto pode ser:
+  * O `id` (UUID do Twenty)
+  * Um campo definido como único (por exemplo, `domain` para Empresas, ou um ID externo do seu sistema anterior)
+
+<Warning>A importação falhará se for feita referência a um registo que não existe.</Warning>
+
+### Passo 3: Prepare o seu ficheiro CSV
+
+Adicione uma coluna no seu ficheiro CSV do lado "muitos" que referencia o registo do lado "um".
+
+**Exemplo**: Para um ficheiro CSV de Pessoas ligado a Empresas:
+
+```
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+**Importante**:
+
+* O valor deve **corresponder exatamente** ao campo único no registo da Empresa
+* Para domínios, use o **URL de domínio** (por exemplo, `https://acme.com`), não o rótulo do domínio
+* Mapeie apenas **um** identificador único por relação: isto leva a uma importação mais fluida
+
+### Passo 4: Verifique se o campo de relação existe
+
+Antes de carregar o seu ficheiro, garanta que o campo de relação existe entre os seus objetos.
+
+Se não existir:
+
+1. Vá a **Definições → Modelo de Dados**
+2. Selecione o seu objeto (por exemplo, Pessoas)
+3. Crie um campo de relação que aponte para o objeto de destino (por exemplo, Empresa)
+
+### Passo 5: Carregue e mapeie a relação
+
+1. Carregue o seu ficheiro CSV através da interface de importação
+2. No passo de mapeamento de campos, encontre a sua coluna de relação (por exemplo, `companyDomain`)
+3. Mapeie-a para o campo de relação (por exemplo, Empresa)
+4. O Twenty ligará automaticamente cada registo ao pai correspondente
+
+### Campos únicos disponíveis para relações
+
+| Objeto                                     | Campos únicos disponíveis                          |
+| ------------------------------------------ | -------------------------------------------------- |
+| **Empresas**                               | `id`, `domain`, qualquer campo único personalizado |
+| **Pessoas**                                | `id`, `email`, qualquer campo único personalizado  |
+| **Membros do Espaço de Trabalho**          | `id`, `email` (não o nome)                         |
+| **Outros objetos padrão e personalizados** | `id`, qualquer campo marcado como único            |
+
+<Note>**Ligação a Membros do Espaço de Trabalho**: Quando a relação aponta para Membros do Espaço de Trabalho (a sua equipa que inicia sessão no Twenty), refira-os pelo seu **endereço de email**, não pelo nome.</Note>
+
+<Note>Recomendamos usar `domain` para Empresas e `email` para Pessoas, pois são legíveis para humanos e fáceis de manter em folhas de cálculo.</Note>
+
+<Note>**Lembrete**: Registos suavemente eliminados (visíveis em Menu de Comandos → Ver registos eliminados) contam para os critérios de unicidade. Se importar um registo com o mesmo valor único que um registo eliminado, o registo eliminado será restaurado. Veja [Restrições de unicidade](/l/pt/user-guide/data-migration/capabilities/uniqueness-constraints) para mais detalhes.</Note>
+
+## Regra da Ordem de Importação
+
+<Warning>
+**Importe sempre primeiro o lado "um"!**
+
+1. **Empresas** primeiro (sem dependências)
+2. **Pessoas** em segundo (ligadas a Empresas)
+3. **Oportunidades** em terceiro (ligadas a Empresas/Pessoas)
+4. **Objetos personalizados** seguindo as suas dependências
+
+O registo pai deve existir antes de o poder referenciar.
+</Warning>

packages/twenty-docs/l/pt/user-guide/data-migration/capabilities/uniqueness-constraints.mdx

@@ -0,0 +1,72 @@
+---
+title: Restrições de Unicidade
+description: Como o Twenty impõe a unicidade dos dados durante a importação.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Visão geral
+
+O Twenty impõe unicidade em determinados campos para evitar registos duplicados e garantir a integridade dos dados. Compreender estas restrições é essencial para importações bem-sucedidas.
+
+## Campos Únicos por Predefinição
+
+| Objeto                     | Campos Únicos                  |
+| -------------------------- | ------------------------------ |
+| **Pessoas**                | `id`, `email`                  |
+| **Empresas**               | `id`, `domain`                 |
+| **Objetos personalizados** | `id` apenas (por predefinição) |
+
+<Note>O campo `id` é o identificador interno do Twenty, gerado automaticamente para cada registo. Utiliza o formato UUID (por exemplo, `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
+
+## Campos Únicos Personalizados
+
+Pode definir campos únicos adicionais em **Definições → Modelo de Dados**:
+
+1. Vá a **Definições → Modelo de Dados**
+2. Selecione o objeto
+3. Clique num campo
+4. Ative **Único** nas definições do campo
+
+### Casos de Utilização para Campos Únicos Personalizados
+
+* **IDs externos**: Guardar IDs de outros sistemas (Salesforce ID, HubSpot ID)
+* **Identificadores empresariais**: Números de colaborador, códigos de cliente
+* **Informações de contacto alternativas**: Perfil do LinkedIn, número de telefone
+
+<Note>O nome do campo `id` é reservado para o ID interno do Twenty. Utilize um nome diferente, como `externalId` ou `legacyId`, para identificadores externos.</Note>
+
+## Comportamento da Importação
+
+### Criação de Novos Registos
+
+Se o valor de um campo único não existir, é criado um novo registo.
+
+### Atualização de Registos Existentes
+
+Se o valor de um campo único corresponder a um registo existente, esse registo é **atualizado** com os novos dados.
+<Warning>Para **atualizar registos existentes**, recomenda-se **corresponder apenas a um campo único**.</Warning>
+
+### Registos Eliminados Logicamente
+
+<Warning>
+**Os registos eliminados contam para a unicidade.**
+
+Registos eliminados logicamente (visíveis em Menu de Comandos → Ver registos eliminados) são incluídos nas verificações de unicidade. Se importar um registo com o mesmo valor único que um registo eliminado, o registo eliminado será **restaurado** com os novos dados.
+</Warning>
+
+## Deteção de Duplicados Durante a Importação
+
+Durante a fase de validação:
+
+* Os duplicados no seu ficheiro são realçados a amarelo
+* Pode editar ou remover linhas duplicadas na interface antes de iniciar a importação
+
+<VimeoEmbed videoId="1145246326" title="Demonstração em vídeo" />
+
+## Melhores Práticas
+
+1. **Remova os duplicados** do seu ficheiro antes de importar
+2. **Verifique se existem registos** no Twenty antes de importar
+3. **Utilize IDs externos** ao migrar de outros sistemas
+4. **Inclua campos únicos** se quiser atualizar registos existentes

packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/export-faq.mdx

@@ -0,0 +1,32 @@
+---
+title: Exportar FAQ
+description: Perguntas frequentes sobre a exportação de dados.
+---
+
+<AccordionGroup>
+<Accordion title="Podemos exportar todos os dados do espaço de trabalho antes do cancelamento, incluindo objetos personalizados, campos personalizados, relações, notas, tarefas, oportunidades, anexos, fluxos de trabalho, permissões e histórico de auditoria?">
+Os dados da Área de Trabalho podem ser exportados antes do cancelamento com algumas exceções: painéis, fluxos de trabalho e permissões devem ser transferidos manualmente; os logs de auditoria não podem ser transferidos.
+</Accordion>
+<Accordion title="Quais elementos não podem ser exportados ou migrados?">
+A maioria dos elementos pode ser exportada ou migrada com algumas exceções:
+* workflows, dashboards e todas as configurações (chaves API, webhooks, logs de auditoria, configurações de usuário, etc.) deve ser migrado manualmente
+* objetos e campos criados pelo app podem ser migrados instalando o aplicativo dito em um espaço de trabalho diferente. Eles não deveriam ser migrados manualmente
+* alguns registros, como versões do fluxo de trabalho e execução de fluxo de trabalho, não são transferíveis e espera-se que sejam perdidos
+* alguns objetos como mensagem e objetos relacionados à agenda não devem ser exportados como são criados quando uma conta é conectada e sincronizada periodicamente. Eles serão sincronizados novamente assim que você conectar sua conta (desde que você tenha acesso a essa conta, se é uma conta de um membro da equipe que deixou a sua empresa, então essas mensagens devem ser exportadas, caso contrário serão perdidas)
+</Accordion>
+<Accordion title="Existe uma nuvem oficial para o procedimento de migração auto-hospedado ou um serviço de migração assistido?">
+A partir de agora, não existe um procedimento oficial de migração em nuvem por auto-hospedado. A ideia geral é:
+* primeiramente, instale aplicativos para introduzir objetos e campos do app
+* replicar objetos e campos personalizados adicionados por usuários
+* usar um script com chaves de API ou ferramentas de IA para migrar todos os dados de uma área de trabalho para outra
+* todos os objetos não transferíveis devem ser migrados manualmente
+
+Peço-lhe que esteja ciente de algumas coisas:
+* você pode enviar até 50 solicitações por minuto no plano Pro ou 100 solicitações por minuto no plano da Organização antes de atingir o limite de uma solicitação/min
+* Cada solicitação de API pode ter até 200 registros
+* alguns dados em campos como criados por atividades da Linha do tempo e atualizados serão perdidos durante a importação e substituídos pelo sistema
+</Accordion>
+<Accordion title="Os arquivos exportados são fornecidos em formatos abertos e documentados?">
+Os arquivos exportados na interface do usuário estão no formato Excel, e todas as solicitações de API podem ser salvas no formato JSON.
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/export-your-data.mdx

@@ -0,0 +1,209 @@
+---
+title: Exporte Seus Dados
+description: Guia completo passo a passo para exportar dados do Twenty.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Visão geral
+
+Exporte os dados do seu espaço de trabalho para CSV para backups, relatórios ou migração.
+
+**Casos de uso:**
+
+* **Backups regulares** — mantenha cópias dos seus dados
+* **Relatórios externos** — analise os dados no Excel, Google Sheets ou em ferramentas de BI
+* **Migração** — mova dados para outro sistema
+* **Atualizações em massa** — exporte, edite e reimporte para atualizar registros
+
+## O Que Você Precisa Saber
+
+### Limites de Exportação
+
+* **Máximo de 20,000 registros** por exportação
+* Apenas **as colunas visíveis** são exportadas
+* Apenas **os registros filtrados** são exportados (com base na sua visualização atual)
+
+<Note>Para exportações maiores (20,000+ registros), use filtros para exportar em lotes ou use a [API](/l/pt/developers/extend/api).</Note>
+
+### Permissões
+
+Você precisa da permissão **"Export CSV"** para exportar dados. Entre em contato com o administrador do seu espaço de trabalho se você não tiver essa opção.
+
+## Etapa 1: Navegue até o Objeto
+
+Vá para o objeto que você deseja exportar:
+
+* **Pessoas** — para contatos
+* **Empresas** — para organizações
+* **Oportunidades** — para negócios
+* **Objetos personalizados** — qualquer objeto que você criou
+
+## Etapa 2: Configure Sua Visualização
+
+**Importante:** A exportação inclui apenas o que está visível na sua visualização atual.
+
+### Adicionar/Remover Colunas
+
+1. Clique em **Opções → Campos** (ou no **+** no final das colunas)
+2. Marque os campos que você deseja exportar
+3. Desmarque os campos de que você não precisa
+
+### Filtrar Registros (Opcional)
+
+Se você precisa apenas de um subconjunto de dados:
+
+1. Clique em **Filtrar**
+2. Adicione condições de filtro (ex.: "Data de criação > 1 de janeiro de 2024")
+3. Somente os registros correspondentes serão exportados
+
+### Ordenar Registros (Opcional)
+
+1. Clique no cabeçalho de uma coluna para ordenar
+2. A exportação seguirá sua ordem de classificação
+
+<Note>**Crie uma visualização dedicada para exportação.** Salve uma visualização configurada especificamente para exportações para que você não precise reconfigurar a cada vez.</Note>
+
+## Etapa 3: Exporte os Dados
+
+1. Clique no ícone **⋮** no canto superior direito da tabela
+2. Selecione **Exportar visualização**
+3. Escolha onde salvar o arquivo CSV
+4. Aguarde a conclusão do download
+
+## O Que É Exportado
+
+| Incluído                                      | Não incluído                         |
+| --------------------------------------------- | ------------------------------------ |
+| Todas as colunas visíveis                     | Colunas ocultas                      |
+| Registros que correspondem aos filtros atuais | Registros excluídos pelos filtros    |
+| Valores de campos personalizados              | Campos que não estão na visualização |
+| IDs dos registros                             | Anexos de arquivo                    |
+| IDs de relacionamento                         | Imagens                              |
+
+### Campos de Relação
+
+IDs de relacionamento são exportados apenas no **lado "muitos"** de um relacionamento:
+
+* **Exportação de Pessoas** inclui uma coluna `companyId` (relação Pessoas → Empresa)
+* **Exportação de Empresas** NÃO inclui `peopleIds` (Empresas é o lado "um")
+
+Isso significa que você pode usar a exportação de Pessoas para reimportar e manter o vínculo com Empresas, mas será necessário reimportar Pessoas após Empresas para recriar os relacionamentos.
+
+## Exportação para Finalidades Específicas
+
+### Para Backups
+
+1. Crie uma visualização com **todos os campos** visíveis
+2. Remova todos os filtros para incluir todos os registros
+3. Exporte cada tipo de objeto separadamente
+4. Armazene as exportações em um local seguro
+5. Defina um lembrete recorrente (semanal/mensal)
+
+### Para Relatórios Externos
+
+1. Inclua apenas os campos necessários para a análise
+2. Aplique filtros para focar nos dados relevantes
+3. Considere ordenar pelo campo que você analisará
+
+### Para Atualizações em Massa
+
+1. Exporte os registros que você deseja atualizar
+2. Inclua o identificador único (`email`, `domain` ou `id`)
+3. Edite o arquivo exportado
+4. Reimporte para atualizar os registros
+   Veja: [Como Atualizar Registros Existentes](/l/pt/user-guide/data-migration/how-tos/update-existing-records-via-import)
+
+### Para Migração
+
+Se você está exportando para migrar para outro sistema:
+
+1. **Exporte cada objeto separadamente** — Pessoas, Empresas, Oportunidades, etc.
+2. **Inclua campos de ID** — eles ajudam a manter os relacionamentos
+3. **Documente os mapeamentos de campos** — observe como os campos do Twenty se mapeiam para o seu sistema de destino
+
+## Como Lidar com Conjuntos de Dados Grandes (20,000+ Registros)
+
+O limite de exportação é de 20,000 registros. Para conjuntos de dados maiores:
+
+### Opção 1: Exportar em Lotes
+
+1. Adicione um filtro (por exemplo, intervalos de "Data de criação")
+2. Exporte o primeiro lote
+3. Altere o filtro
+4. Exporte o próximo lote
+5. Combine os arquivos na sua planilha
+
+**Exemplos de filtros para lotes:**
+
+* Por intervalo de datas (janeiro, fevereiro, março...)
+* Por responsável (Membro da equipe A, Membro da equipe B...)
+* Por status (Ativo, Inativo...)
+
+### Opção 2: Usar a API
+
+A API não tem limite de registros:
+
+1. Obtenha sua chave de API em **Configurações → Desenvolvedores**
+2. Use a API GraphQL para consultar registros
+3. Processe os resultados no seu aplicativo
+
+Veja: [Documentação da API](/l/pt/developers/extend/api)
+
+## Dicas e Boas Práticas
+
+### Crie Visualizações de Exportação
+
+Salve visualizações configuradas especificamente para exportações:
+
+1. Configure colunas e filtros
+2. Clique em **Opções da visualização** → **Salvar como nova visualização**
+3. Nomeie como "Export - [Finalidade]"
+
+### Proteja Suas Exportações
+
+Arquivos exportados podem conter dados sensíveis:
+
+* Armazene em locais seguros
+* Exclua exportações antigas quando não forem mais necessárias
+* Tenha cuidado ao compartilhar arquivos de exportação
+
+### Verifique Antes de Exportar
+
+<Check>As colunas corretas estão visíveis</Check>
+<Check>Os filtros estão configurados corretamente (ou removidos para exportação completa)</Check>
+<Check>Você tem permissão de Exportação</Check>
+
+## Perguntas frequentes
+
+<AccordionGroup>
+  <Accordion title="Por que algumas colunas estão ausentes na minha exportação?">
+    Apenas as colunas visíveis são exportadas. Adicione as colunas necessárias em **Opções → Campos** antes de exportar.
+  </Accordion>
+
+  <Accordion title="Por que minha exportação não tem todos os registros?">
+    Verifique seus filtros. A exportação inclui apenas registros que correspondem aos filtros da sua visualização atual. Remova os filtros para exportar todos os registros.
+  </Accordion>
+
+  <Accordion title="Posso exportar mais de 20,000 registros?">
+    Não em uma única exportação. Use filtros para exportar em lotes ou use a API para conjuntos de dados maiores.
+  </Accordion>
+
+  <Accordion title="Qual é o formato do arquivo de exportação?">
+    CSV (valores separados por vírgula). Abre no Excel, Google Sheets ou qualquer aplicativo de planilha.
+  </Accordion>
+
+  <Accordion title="Os IDs de relacionamento são incluídos?">
+    Sim, mas apenas no lado "muitos" dos relacionamentos. Por exemplo, uma exportação de Pessoas inclui `companyId`, mas uma exportação de Empresas não inclui IDs de pessoas.
+  </Accordion>
+
+  <Accordion title="Posso automatizar exportações?">
+    Não diretamente pela interface. Use a API para criar fluxos de trabalho de exportação automatizados.
+  </Accordion>
+</AccordionGroup>
+
+## Próximos Passos
+
+* [Como Atualizar Registros Existentes](/l/pt/user-guide/data-migration/how-tos/update-existing-records-via-import) — edite e reimporte sua exportação
+* [Como Importar Dados via API](/l/pt/user-guide/data-migration/how-tos/import-data-via-api) — para conjuntos de dados grandes
+* [Documentação da API](/l/pt/developers/extend/api) — crie fluxos de trabalho de exportação personalizados

packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/fix-import-errors.mdx

@@ -0,0 +1,430 @@
+---
+title: Corrigir erros de importação
+description: Guia completo de solução de problemas para corrigir erros de importação de CSV.
+---
+
+## Visão Geral
+
+A importação não está funcionando? Este guia ajuda-o a identificar e corrigir, passo a passo, erros comuns de importação.
+
+## Como funciona a validação da importação
+
+Depois de carregar o seu ficheiro e mapear as colunas, o Twenty valida os seus dados:
+
+1. **A validação é executada** — o Twenty verifica cada linha quanto a erros
+2. **Os erros são realçados** — as linhas problemáticas aparecem a **amarelo**
+3. **Pode corrigir no local** — edite as células diretamente na interface de importação
+4. **Ou remova linhas** — ignore completamente os registos problemáticos
+
+<Note>**Corrija os erros na interface.** Não precisa de voltar à sua folha de cálculo. Edite as células diretamente durante a importação para poupar tempo.</Note>
+
+## Resolução de problemas passo a passo
+
+### Passo 1: Identifique o tipo de erro
+
+Clique numa linha realçada para ver a mensagem de erro específica. Tipos de erro comuns:
+
+| Mensagem de Erro                                                            | O que significa                                                   |
+| --------------------------------------------------------------------------- | ----------------------------------------------------------------- |
+| Valores duplicados realçados a amarelo                                      | O valor já existe no Twenty ou aparece duas vezes no seu ficheiro |
+| `{field} is not a valid {type}` (passe o cursor sobre a célula amarela)     | Os dados não correspondem ao formato esperado                     |
+| Campo obrigatório realçado                                                  | O campo obrigatório está vazio                                    |
+| `Can't connect to {object}. No unique record found...` (a importação falha) | O registo referenciado não existe                                 |
+| `Too many records. Up to 10000 allowed` (carregamento bloqueado)            | O ficheiro tem mais de 10 000 registos                            |
+
+### Passo 2: Corrija o erro
+
+Siga as instruções específicas abaixo para cada tipo de erro.
+
+---
+
+## Erro: Valor duplicado
+
+### O Que Você Verá
+
+As linhas com valores duplicados são realçadas a amarelo na interface de importação antes de a importação começar.
+
+### O que significa
+
+Um campo único (email, domínio) pode:
+
+* Já existe no Twenty
+* Aparece duas vezes no seu ficheiro
+
+### Como corrigir
+
+**Opção 1: Edite o valor duplicado**
+
+1. Clique na célula com o erro
+2. Altere para um valor único
+3. Continue com a importação
+
+**Opção 2: Remova a linha duplicada**
+
+1. Clique no X ao lado da linha
+2. A linha será ignorada durante a importação
+
+**Opção 3: Deixe o Twenty atualizar o registo existente**
+
+1. Garanta que o seu ficheiro inclui um identificador único (`email`, `domain` ou `id`)
+2. Mapeie o campo do identificador único
+3. O Twenty atualizará o registo existente em vez de criar um duplicado
+
+<Note>
+**Também pode atualizar campos únicos.**
+
+* Se mantiver o `id` mas alterar o `email` → o email será atualizado
+* Se mantiver o `email` mas alterar o `id` → o id será atualizado
+
+Desde que um identificador único corresponda, o Twenty atualiza o registo.
+</Note>
+
+### Como prevenir este erro
+
+Antes de importar:
+
+1. Ordene a sua folha de cálculo pelo campo único
+2. Remova linhas duplicadas
+3. Verifique se os registos já existem no Twenty
+
+<Warning>
+**Registos eliminados logicamente contam para a unicidade.**
+
+Verifique o Menu de Comandos → Ver registos eliminados. Os registos lá continuam a impor a unicidade. Elimine-os permanentemente ou restaure e atualize.
+</Warning>
+
+Para mais detalhes: [Restrições de Unicidade](/l/pt/user-guide/data-migration/capabilities/uniqueness-constraints)
+
+---
+
+## Erro: Formato inválido
+
+### O Que Você Verá
+
+O valor da célula está realçado a amarelo. Passe o cursor sobre ele para ver a mensagem de erro:
+
+```
+{field name} is not a valid {field type}
+```
+
+### O que significa
+
+Os dados não correspondem ao formato esperado para esse tipo de campo.
+
+### Como corrigir — Por tipo de campo
+
+#### E-mail
+
+**Problema:** Formato de email inválido
+**Solução:** Use o formato `name@domain.com`
+
+```
+❌ john.smith@
+❌ john smith@acme.com
+✓ john.smith@acme.com
+```
+
+#### Domínio
+
+**Problema:** Formato inconsistente pode causar duplicados
+**Solução:** Use o formato `https://domain.com` (recomendado)
+
+```
+⚠️ acme.com         (valid, but not recommended)
+⚠️ www.acme.com     (valid, but not recommended)
+✅ https://acme.com  (recommended)
+```
+
+<Note>Todos os formatos são válidos, mas `https://domain.com` é recomendado porque corresponde ao formato usado pela sincronização de email/calendário. Usar outros formatos pode criar empresas duplicadas.</Note>
+
+#### Data
+
+**Problema:** Formato de data não reconhecido
+**Solução:** Use o formato `YYYY-MM-DD` de forma consistente em todo o ficheiro
+
+```
+✓ 2024-03-15        (YYYY-MM-DD)
+❌ 03/15/2024        (MM/DD/YYYY)
+❌ 15/03/2024        (DD/MM/YYYY)
+```
+
+#### Telefone
+
+**Problema:** Colunas obrigatórias em falta
+**Solução:** Inclua todas as colunas de telefone
+
+| Coluna                                  | Exemplo      |
+| --------------------------------------- | ------------ |
+| **Phones / Primary Phone Number**       | `4159095555` |
+| **Phones / Primary Phone Country Code** | `US`         |
+| **Phones / Primary Phone Calling Code** | `+1`         |
+
+#### Booleano
+
+**Problema:** Valor booleano incorreto
+**Solução:** Use `TRUE` ou `FALSE` em maiúsculas
+
+```
+❌ true
+❌ yes
+❌ 1
+✓ TRUE
+✓ FALSE
+```
+
+#### Seleção / Seleção múltipla
+
+**Problema:** O valor não corresponde às opções existentes
+**Solução:** Use **nomes da API**, não rótulos de exibição
+
+Como encontrar nomes da API:
+
+1. Vá a **Definições → Modelo de Dados**
+2. Selecione o objeto e o campo
+3. Ative o **Modo Avançado** (alternador no canto inferior direito)
+4. Use o nome da API (por exemplo, `OPTION_1`, não "Option 1")
+
+```
+❌ High Priority
+✓ HIGH_PRIORITY
+```
+
+#### Moeda
+
+**Problema:** Valor ou código de moeda em falta
+**Solução:** Preencha ambas as colunas
+
+| Coluna            | Exemplo   |
+| ----------------- | --------- |
+| **Valor / Valor** | `1234.56` |
+| **Valor / Moeda** | `USD`     |
+
+#### Número
+
+**Problema:** Caracteres não numéricos
+**Solução:** Apenas números; ponto para decimais
+
+```
+❌ $1,234.56
+❌ 1,234.56
+✓ 1234.56
+```
+
+Para referência completa de formatos: [Referência de Mapeamento de Campos](/l/pt/user-guide/data-migration/capabilities/field-mapping)
+
+---
+
+## Erro: Campo obrigatório em falta
+
+### O Que Você Verá
+
+A linha está realçada a amarelo com a célula do campo obrigatório assinalada.
+
+### O que significa
+
+Um campo obrigatório está vazio nesta linha.
+
+### Como corrigir
+
+**Opção 1: Introduza um valor**
+
+1. Clique na célula vazia
+2. Introduza um valor
+3. Continue com a importação
+
+**Opção 2: Remova a linha**
+
+1. Se não tiver os dados, clique em X para ignorar a linha
+
+### Como prevenir este erro
+
+Antes de importar, identifique os campos obrigatórios:
+
+1. Vá a **Definições → Modelo de Dados**
+2. Selecione o seu objeto
+3. Verifique quais os campos marcados como obrigatórios
+
+---
+
+## Erro: Relação não encontrada
+
+### O Que Você Verá
+
+Este erro aparece após o início da importação — a importação falha com uma mensagem como:
+
+```
+Can't connect to company. No unique record found with condition: id = 7776ee49-f608-4a77-8cc8-6fe96ae1e43f
+```
+
+Isto significa que não existe nenhuma Empresa no Twenty com esse identificador específico.
+
+<Note>Ao contrário de outros erros, este não é detetado durante a etapa de revisão dos dados. A importação começará e depois falhará quando encontrar a relação em falta.</Note>
+
+### O que significa
+
+Está a tentar ligar a um registo que não existe no Twenty.
+
+### Como corrigir
+
+**Opção 1: Importe primeiro os registos pai**
+
+1. Cancele a importação atual
+2. Importe os registos pai (por exemplo, Empresas)
+3. Depois, importe os registos filho (por exemplo, Pessoas)
+
+**Opção 2: Corrija o valor de referência**
+
+1. Verifique o valor de referência no seu ficheiro
+2. Garanta que corresponde exatamente a um registo existente
+3. Verifique o formato: os domínios devem ser `https://domain.com`
+
+**Opção 3: Remova a relação**
+
+1. Limpe a célula para importar sem a relação
+2. Adicione a relação manualmente mais tarde
+
+### Como prevenir este erro
+
+1. **Importe na ordem correta:**
+   * Empresas primeiro
+   * Pessoas em segundo (com referências à empresa)
+   * Oportunidades em terceiro
+
+2. **Verifique os valores de referência:**
+   * Exporte os registos pai para obter identificadores exatos
+   * Use o formato de domínio `https://domain.com`
+   * Verifique erros de digitação e sensibilidade a maiúsculas/minúsculas
+
+<Warning>
+**A importação falhará se for feita referência a um registo inexistente.**
+
+Importe sempre os objetos pai antes dos objetos filho.
+</Warning>
+
+Para mais detalhes: [Importação de Relações](/l/pt/user-guide/data-migration/capabilities/import-relations)
+
+---
+
+## Erro: Ficheiro demasiado grande
+
+### O Que Você Verá
+
+Este erro aparece ao carregar o seu ficheiro — o carregamento é totalmente bloqueado:
+
+```
+Too many records. Up to 10000 allowed
+```
+
+Não poderá avançar para a etapa de revisão dos dados até reduzir o tamanho do ficheiro.
+
+### O que significa
+
+O seu ficheiro tem mais de 10 000 registos.
+
+### Como corrigir
+
+**Opção 1: Divida em vários ficheiros**
+
+1. Divida os seus dados em ficheiros de 10 000 registos ou menos
+2. Importe cada ficheiro separadamente
+3. Mantenha a ordem de importação (Empresas antes de Pessoas)
+
+**Opção 2: Use a importação via API**
+Para conjuntos de dados muito grandes, use a API, que não tem limite de registos.
+Consulte: [Como Importar Dados via API](/l/pt/user-guide/data-migration/how-tos/import-data-via-api)
+
+---
+
+## Erro: Campo não reconhecido
+
+### O que significa
+
+Uma coluna no seu ficheiro não pode ser mapeada porque o campo não existe no Twenty.
+
+### Como corrigir
+
+1. Vá a **Definições → Modelo de Dados**
+2. Selecione o objeto que está a importar
+3. Clique em **+ Adicionar campo**
+4. Crie o campo personalizado com o tipo apropriado
+5. Carregue novamente o seu ficheiro
+
+<Note>A importação de CSV cria registos, não campos. Todos os campos devem existir antes de importar.</Note>
+
+---
+
+## Erro: Relação de utilizador vazia
+
+### O que significa
+
+Está a tentar atribuir um registo a um utilizador (Proprietário, Responsável), mas a relação não está a ser mapeada.
+
+### Causas comuns
+
+1. **O utilizador não aceitou o convite** — o utilizador ainda não existe no Twenty
+2. **A usar o ID de utilizador do sistema antigo** — o Twenty não consegue corresponder IDs de outro sistema
+3. **Formato de email incorreto** — o email não corresponde à conta do utilizador no Twenty
+
+### Como corrigir
+
+1. Garanta que todos os utilizadores aceitaram o convite para o seu espaço de trabalho no Twenty
+2. Use o **endereço de email** do utilizador (não o nome nem o ID do sistema antigo)
+3. Use o mesmo email que utilizaram para aderir ao Twenty
+
+<Warning>
+**Os utilizadores devem aceitar os convites antes de importar.**
+
+Se um utilizador não tiver aceite o convite, os registos que o referenciem terão relações de utilizador vazias.
+</Warning>
+
+---
+
+## Lista de verificação antes da importação
+
+Evite erros verificando isto antes de importar:
+
+### Requisitos do ficheiro
+
+<Check>O ficheiro está no formato CSV, XLSX ou XLS</Check>
+<Check>O ficheiro tem menos de 10 000 registos</Check>
+<Check>O ficheiro usa codificação UTF-8</Check>
+
+### Qualidade dos dados
+
+<Check>Sem emails duplicados (para Pessoas)</Check>
+<Check>Sem domínios duplicados (para Empresas)</Check>
+<Check>Todas as datas usam um formato consistente</Check>
+<Check>Todos os domínios usam o formato `https://domain.com`</Check>
+
+### Formatos de campos
+
+<Check>Campos booleanos usam `TRUE` ou `FALSE` (maiúsculas)</Check>
+<Check>Campos de seleção usam nomes da API, não rótulos de exibição</Check>
+<Check>Campos de telefone têm todas as colunas necessárias</Check>
+<Check>Campos de moeda têm tanto o Valor como o Código da Moeda</Check>
+
+### Relações
+
+<Check>Registos pai importados antes dos registos filho</Check>
+<Check>Colunas de relação referenciam registos existentes</Check>
+<Check>O formato de domínio corresponde exatamente ao formato do Twenty</Check>
+
+### Modelo de dados
+
+<Check>Todos os campos personalizados existem em Definições → Modelo de Dados</Check>
+<Check>As opções de seleção existem antes de importar</Check>
+
+---
+
+## Ainda com problemas?
+
+Se já tentou as soluções acima:
+
+1. **Transfira o ficheiro de exemplo** — veja o formato exato que o Twenty espera
+2. **Exporte os registos existentes** — compare o seu ficheiro com dados funcionais
+3. **Teste com um pequeno lote** — experimente primeiro 5–10 linhas
+4. **Consulte os artigos de referência:**
+   * [Mapeamento de Campos](/l/pt/user-guide/data-migration/capabilities/field-mapping)
+   * [Restrições de Unicidade](/l/pt/user-guide/data-migration/capabilities/uniqueness-constraints)
+   * [Importação de Relações](/l/pt/user-guide/data-migration/capabilities/import-relations)
+   * [Tratamento de Erros](/l/pt/user-guide/data-migration/capabilities/error-handling)

packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/import-companies-via-csv.mdx

@@ -0,0 +1,201 @@
+---
+title: Importar Empresas via CSV
+description: Guia completo passo a passo para importar empresas para o Twenty.
+---
+
+## Visão Geral
+
+Este guia explica como importar as suas empresas para o Twenty. **As empresas devem ser importadas primeiro** porque Pessoas e Oportunidades se ligam a Empresas.
+
+## Antes de Começar
+
+### Lista de Verificação de Pré-requisitos
+
+<Check>
+O seu ficheiro está no formato CSV, XLSX ou XLS
+</Check>
+
+<Check>
+O ficheiro tem menos de 10 000 registos
+</Check>
+
+<Check>
+Sem domínios duplicados no seu ficheiro
+</Check>
+
+<Check>
+Todos os campos personalizados existem em **Settings → Data Model**
+</Check>
+
+<Note>
+Precisa de importar mais de 10 000 empresas? Divida em vários ficheiros ou use a [importação via API](/l/pt/user-guide/data-migration/how-tos/import-data-via-api).
+</Note>
+
+## Passo 1: Prepare os seus dados de empresas
+
+### Campos Obrigatórios e Recomendados
+
+| Campo                     | Obrigatório? | Formato              | Notas                           |
+| ------------------------- | ------------ | -------------------- | ------------------------------- |
+| **Name**                  | Recomendado  | Texto                | Nome de apresentação da empresa |
+| **Domínio**               | Recomendado  | `https://domain.com` | Identificador único             |
+| **Endereço**              | Opcional     | Várias colunas       | Veja abaixo                     |
+| **Empregados**            | Opcional     | Número               | Número de empregados            |
+| **Campos personalizados** | Opcional     | Varia                | Deve existir no Data Model      |
+
+### Formato de Domínio
+
+<Warning>
+**Use o formato `https://domain.com` para domínios.**
+
+Isto corresponde ao formato utilizado quando as Empresas são criadas automaticamente a partir da sincronização de e-mail/calendário, evitando duplicados posteriormente.
+</Warning>
+
+**Colunas de domínio:**
+
+* **Domain / Domain Label**: `acme.com`
+* **Domain / Domain URL**: `https://acme.com`
+
+### Formato de Endereço
+
+Endereço é um campo aninhado com várias colunas:
+
+```
+Address / Address 1,Address / City,Address / State,Address / Country,Address / Post Code
+123 Main Street,San Francisco,CA,USA,94105
+```
+
+### Exemplo de estrutura de CSV
+
+```csv
+name,Domain / Domain URL,Domain / Domain Label,Address / City,Address / Country,employees
+Acme Corp,https://acme.com,acme.com,San Francisco,USA,250
+Widget Co,https://widgets.co,widgets.co,New York,USA,50
+```
+
+<Note>
+**Dica profissional:** Clique em **Download sample file** durante a importação para ver os nomes de colunas exatos que o Twenty espera.
+</Note>
+
+## Passo 2: Aceda à funcionalidade de importação
+
+**Opção 1: A partir da vista Empresas**
+
+1. Navegue até **Empresas** na barra lateral esquerda
+2. Clique no ícone **⋮** no canto superior direito
+3. Selecione **Import records**
+
+**Opção 2: Utilizando o Menu de Comando**
+
+1. Prima `Cmd + K` (Mac) ou `Ctrl + K` (Windows)
+2. Escreva "import"
+3. Selecione **Import records**
+4. Escolha **Empresas**
+
+## Passo 3: Carregue o seu ficheiro
+
+1. Clique em **Select file**
+2. Escolha o seu ficheiro CSV, XLSX ou XLS
+3. Aguarde que o Twenty analise o seu ficheiro
+
+## Passo 4: Mapeie as suas colunas
+
+O Twenty tenta automaticamente corresponder as suas colunas aos campos. Revise e ajuste:
+
+1. **Verifique os mapeamentos automáticos** — confirme que estão corretos
+2. **Corrija mapeamentos incorretos** — clique no menu suspenso para selecionar o campo correto
+3. **Ignorar colunas** — selecione **Do not map** para as colunas que não quer importar
+
+### Regras Importantes de Mapeamento
+
+* **Domínio**: Faça o mapeamento para **Domain / Domain URL** (não para Domain Label)
+* **Endereço**: Mapeie cada parte para a respetiva coluna (Cidade, Estado, etc.)
+* **Campos Select**: Os valores devem corresponder às opções existentes (ou irá mapeá-los no passo seguinte)
+
+<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
+
+## Passo 5: Mapear valores de campos Select
+
+Se tiver campos Select ou Multi-Select:
+
+1. O Twenty mostra os seus valores ao lado das opções existentes
+2. Relacione cada valor no seu ficheiro a uma opção do Twenty
+3. Ou crie novas opções, se necessário
+
+<Note>
+As opções de Select usam **nomes de API**, não os rótulos de apresentação. Em **Settings → Data Model** → Ative o **Modo avançado** para ver os nomes de API.
+</Note>
+
+## Passo 6: Rever e corrigir erros
+
+Antes de concluir a importação, o Twenty valida os seus dados:
+
+1. Clique em **Next Steps**
+2. As linhas com erros são destacadas em **amarelo**
+3. **Corrija os erros diretamente** — clique numa célula e edite o valor
+4. **Remova as linhas problemáticas** — clique no X para ignorar essa linha
+
+### Erros comuns na importação de empresas
+
+| Erro                            | Causa                          | Solução                                            |
+| ------------------------------- | ------------------------------ | -------------------------------------------------- |
+| **Domínio duplicado**           | O domínio já existe no Twenty  | Remova do ficheiro ou atualize o registo existente |
+| **Formato de domínio inválido** | Formato incorreto              | Use `https://domain.com`                           |
+| **Campo obrigatório ausente**   | O campo obrigatório está vazio | Preencha o valor ou remova a linha                 |
+
+## Passo 7: Concluir a importação
+
+1. Revise o resumo da importação
+2. Clique em **Confirm** para importar
+3. Aguarde a conclusão da importação
+4. Verifique consultando alguns registos
+
+## Após importar empresas
+
+Agora pode importar registos que se ligam a Empresas:
+
+1. **[Importar Pessoas](/l/pt/user-guide/data-migration/how-tos/import-contacts-via-csv)** — ligue-as a Empresas utilizando o domínio
+2. **Importar Oportunidades** — ligue-as a Empresas
+3. **Verifique a importação** — faça uma verificação pontual de alguns registos para garantir que os dados estão corretos
+
+## Atualizar Empresas existentes
+
+Para atualizar empresas em vez de criar novas:
+
+1. Inclua a coluna `domain` ou `id` no seu ficheiro
+2. O Twenty faz a correspondência dos registos por este identificador único
+3. As empresas existentes são atualizadas; as novas são criadas
+
+Veja [Como Atualizar Registos Existentes](/l/pt/user-guide/data-migration/how-tos/update-existing-records-via-import) para obter detalhes.
+
+## Perguntas Frequentes
+
+<AccordionGroup>
+  <Accordion title="Porque é que duas Empresas não podem ter o mesmo domínio?">
+    O domínio é um identificador único no Twenty. Isto evita empresas duplicadas e garante que a sincronização de e-mail associe corretamente os e-mails à empresa certa.
+  </Accordion>
+
+  <Accordion title="E se tiver empresas sem domínio?">
+    Pode deixar o domínio em branco. No entanto, recomendamos adicionar domínios quando possível para melhorar a qualidade dos dados e a ligação automática de e-mails.
+  </Accordion>
+
+  <Accordion title="Posso importar empresas sem quaisquer Pessoas associadas?">
+    Sim! Pode importar as empresas primeiro, depois importar as Pessoas e associá-las usando o domínio da empresa.
+  </Accordion>
+
+  <Accordion title="O que acontece se importar um domínio que já existe?">
+    Se incluir um identificador único (domínio ou id) que corresponda a uma empresa existente, a Twenty atualiza essa empresa em vez de criar um duplicado.
+  </Accordion>
+
+  <Accordion title="Como corrijo erros de 'domínio duplicado'?">
+    Remova o duplicado do seu ficheiro ou inclua o `id` da empresa para, em vez disso, atualizar o registo existente.
+  </Accordion>
+</AccordionGroup>
+
+## Resolução de Problemas
+
+Está a ter problemas? Consulte:
+
+* [Como Corrigir Erros de Importação](/l/pt/user-guide/data-migration/how-tos/fix-import-errors)
+* [Referência de Mapeamento de Campos](/l/pt/user-guide/data-migration/capabilities/field-mapping)
+* [Restrições de Unicidade](/l/pt/user-guide/data-migration/capabilities/uniqueness-constraints)

packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/import-contacts-via-csv.mdx

@@ -0,0 +1,242 @@
+---
+title: Importar contactos via CSV
+description: Guia completo passo a passo para importar pessoas/contactos para o Twenty.
+---
+
+## Visão Geral
+
+Este guia explica como importar os seus contactos (People) para o Twenty.
+
+## Antes de Começar
+
+### Lista de Verificação de Pré-requisitos
+
+<Check>
+O seu ficheiro está no formato CSV, XLSX ou XLS
+</Check>
+
+<Check>
+O ficheiro tem menos de 10 000 registos
+</Check>
+
+<Check>
+Sem endereços de e-mail duplicados no seu ficheiro
+</Check>
+
+<Check>
+**Empresas importadas primeiro** (se estiver a associar Pessoas a Empresas)
+</Check>
+
+<Check>
+Todos os campos personalizados existem em **Settings → Data Model**
+</Check>
+
+<Warning>
+**Importe Empresas Antes de Pessoas**
+
+Se quiser associar Pessoas a Empresas, importe primeiro as Empresas. A Empresa deve existir antes de poder referenciá-la.
+</Warning>
+
+## Passo 1: Prepare os seus dados de contactos
+
+### Campos Obrigatórios e Recomendados
+
+| Campo                     | Obrigatório? | Formato           | Notas                      |
+| ------------------------- | ------------ | ----------------- | -------------------------- |
+| **Email**                 | Recomendado  | `name@domain.com` | Deve ser único             |
+| **Nome**                  | Recomendado  | Texto             |                            |
+| **Apelido**               | Recomendado  | Texto             |                            |
+| **Empresa**               | Opcional     | Domínio ou ID     | Liga à Empresa existente   |
+| **Telefone**              | Opcional     | Várias colunas    | Veja abaixo                |
+| **Cargo**                 | Opcional     | Texto             |                            |
+| **Campos personalizados** | Opcional     | Varia             | Deve existir no Data Model |
+
+### Formato de E-mail
+
+* Deve estar num formato de e-mail válido: `name@domain.com`
+* **Deve ser único** — sem duplicados no seu ficheiro ou no Twenty
+* Para e-mails adicionais, utilize a coluna **Emails / Additional Emails**:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### Formato de Telefone
+
+Telefone é um **campo aninhado** que requer várias colunas:
+
+| Coluna                                  | Exemplo      |
+| --------------------------------------- | ------------ |
+| **Phones / Primary Phone Number**       | `4159095555` |
+| **Phones / Primary Phone Country Code** | `US`         |
+| **Phones / Primary Phone Calling Code** | `+1`         |
+
+### A associar a Empresas
+
+Adicione uma coluna com o identificador único da Empresa:
+
+| Nome da Coluna  | Formato        | Exemplo                                |
+| --------------- | -------------- | -------------------------------------- |
+| `companyDomain` | Formato de URL | `https://acme.com`                     |
+| `companyId`     | UUID           | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
+
+<Note>
+**Use o formato de URL de domínio** (`https://acme.com`), não o rótulo. Isto corresponde à forma como as Empresas são armazenadas no Twenty.
+</Note>
+
+### Exemplo de estrutura de CSV
+
+```csv
+firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
+John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US
+Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US
+```
+
+<Note>
+**Dica profissional:** Clique em **Download sample file** durante a importação ou exporte algumas Pessoas existentes para ver os nomes de colunas exatos que o Twenty espera.
+</Note>
+
+## Passo 2: Aceda à funcionalidade de importação
+
+**Opção 1: A partir da vista Pessoas**
+
+1. Navegue até **Pessoas** na barra lateral esquerda
+2. Clique no ícone **⋮** no canto superior direito
+3. Selecione **Import records**
+
+**Opção 2: Utilizando o Menu de Comando**
+
+1. Prima `Cmd + K` (Mac) ou `Ctrl + K` (Windows)
+2. Escreva "import"
+3. Selecione **Import records**
+4. Escolha **Pessoas**
+
+## Passo 3: Carregue o seu ficheiro
+
+1. Clique em **Select file**
+2. Escolha o seu ficheiro CSV, XLSX ou XLS
+3. Aguarde que o Twenty analise o seu ficheiro
+
+## Passo 4: Mapeie as suas colunas
+
+O Twenty tenta automaticamente corresponder as suas colunas aos campos. Revise e ajuste:
+
+1. **Verifique os mapeamentos automáticos** — confirme que estão corretos
+2. **Corrija mapeamentos incorretos** — clique no menu suspenso para selecionar o campo correto
+3. **Ignorar colunas** — selecione **Do not map** para as colunas que não quer importar
+
+### Regras Importantes de Mapeamento
+
+| Tipo de Coluna        | Mapear Para                    | Notas                                     |
+| --------------------- | ------------------------------ | ----------------------------------------- |
+| Referência de Empresa | campo de relação **Empresa**   | Use domínio OU ID, não ambos              |
+| E-mail                | **Email**                      | Endereço de e-mail principal              |
+| E-mails adicionais    | **Emails / Additional Emails** | Formato de array                          |
+| Telefone              | Colunas separadas              | Número, Código do País, Código de Chamada |
+
+<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
+
+### Mapeamento da Relação com a Empresa
+
+Ao mapear a coluna de empresa:
+
+1. Encontre a sua coluna de referência de empresa (por exemplo, `companyDomain`)
+2. Mapeie-a para o campo de relação **Empresa**
+3. O Twenty irá associar cada Pessoa à Empresa correspondente
+
+<Warning>
+**Mapeie apenas UM identificador único para relações.**
+
+Não mapeie ambos `companyId` E `companyDomain`. Escolha um — de preferência o domínio, pois é legível para humanos.
+</Warning>
+
+## Etapa 5: Mapear valores de campos Select
+
+Se você tiver campos Select ou Multi-Select (como Origem do lead):
+
+1. O Twenty exibe seus valores ao lado das opções existentes
+2. Relacione cada valor no seu arquivo a uma opção do Twenty
+3. Ou crie novas opções, se necessário
+
+<Note>
+As opções de Select usam **nomes de API**, não os rótulos de exibição. Em **Configurações → Modelo de dados** → Ative o **Modo avançado** para ver os nomes de API.
+</Note>
+
+## Etapa 6: Revisar e corrigir erros
+
+Antes de concluir a importação, o Twenty valida seus dados:
+
+1. Clique em **Próximos Passos**
+2. As linhas com erros são destacadas em **amarelo**
+3. **Corrija os erros diretamente** — clique em uma célula e edite o valor
+4. **Remova as linhas problemáticas** — clique no X para ignorar essa linha
+
+### Erros comuns na importação de contatos
+
+| Erro                           | Causa                                      | Solução                                              |
+| ------------------------------ | ------------------------------------------ | ---------------------------------------------------- |
+| **E-mail duplicado**           | O e-mail já existe no Twenty ou no arquivo | Remova o duplicado ou atualize o registro existente  |
+| **Formato de e-mail inválido** | Formato de e-mail incorreto                | Corrija para `name@domain.com`                       |
+| **Relação não encontrada**     | A empresa não existe                       | Importe as Empresas primeiro ou corrija a referência |
+| **Campo obrigatório ausente**  | O campo obrigatório está vazio             | Preencha o valor ou remova a linha                   |
+
+## Etapa 7: Concluir a importação
+
+1. Revise o resumo da importação
+2. Clique em **Confirmar** para importar
+3. Aguarde a conclusão da importação
+4. Verifique conferindo alguns registros e seus vínculos com a Empresa
+
+## Após importar contatos
+
+Seus contatos agora estão no Twenty! Próximos passos:
+
+1. **Verifique os vínculos com a Empresa** — abra alguns registros de Pessoas para confirmar que estão vinculados à Empresa correta
+2. **Importe Oportunidades** — se necessário, vincule-as a Pessoas e Empresas
+3. **Configure a sincronização de e-mail** — conecte sua caixa de correio para ver o histórico de e-mails nos registros de contato
+
+## Atualizando contatos existentes
+
+Para atualizar contatos em vez de criar novos:
+
+1. Inclua a coluna `email` ou `id` no seu arquivo
+2. O Twenty faz a correspondência dos registros por esse identificador único
+3. Os contatos existentes são atualizados; os novos são criados
+
+Veja [Como Atualizar Registros Existentes](/l/pt/user-guide/data-migration/how-tos/update-existing-records-via-import) para obter detalhes.
+
+## Perguntas frequentes
+
+<AccordionGroup>
+  <Accordion title="Por que duas Pessoas não podem ter o mesmo e-mail?">
+    O e-mail é um identificador único no Twenty. Isso evita contatos duplicados e garante que a sincronização de e-mail vincule corretamente os e-mails à pessoa certa.
+  </Accordion>
+
+  <Accordion title="E se eu tiver pessoas sem e-mail?">
+    Você pode deixar o e-mail em branco. No entanto, recomendamos adicionar e-mails quando possível para melhorar a qualidade dos dados e a funcionalidade de sincronização de e-mail.
+  </Accordion>
+
+  <Accordion title="Como vinculo Pessoas a Empresas durante a importação?">
+    Adicione uma coluna com o domínio da Empresa (por exemplo, `https://acme.com`) ou o ID. Durante o mapeamento, conecte essa coluna ao campo de relação da Empresa.
+  </Accordion>
+
+  <Accordion title="E se a Empresa ainda não existir?">
+    Importe as Empresas primeiro e, depois, as Pessoas. A Empresa deve existir antes que você possa referenciá-la.
+  </Accordion>
+
+  <Accordion title="Posso importar o ID do meu CRM anterior?">
+    Sim! Crie um campo personalizado marcado como "único" no seu modelo de dados para armazenar o ID externo. Observação: o nome do campo `id` é reservado para o ID interno do Twenty.
+  </Accordion>
+
+  <Accordion title="Como corrijo erros de 'relação não encontrada'?">
+    A Empresa que você está referenciando não existe. Importe a Empresa primeiro ou verifique se o domínio/ID corresponde exatamente a uma Empresa existente.
+  </Accordion>
+</AccordionGroup>
+
+## Resolução de Problemas
+
+Com problemas? Confira:
+
+* [Como corrigir erros de importação](/l/pt/user-guide/data-migration/how-tos/fix-import-errors)
+* [Como importar relações](/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+* [Referência de mapeamento de campos](/l/pt/user-guide/data-migration/capabilities/field-mapping)

packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/import-data-via-api.mdx

@@ -0,0 +1,176 @@
+---
+title: Importar dados via API
+description: Quando e como usar as APIs da Twenty para importações de dados em larga escala.
+---
+
+## Visão Geral
+
+A Twenty oferece tanto **GraphQL** como **APIs REST** para a importação programática de dados. Use a API quando a importação por CSV não for prática para o seu volume de dados ou quando precisar de importações automatizadas e recorrentes.
+
+## Quando usar a importação via API
+
+| Cenário                            | Método recomendado                        |
+| ---------------------------------- | ----------------------------------------- |
+| Menos de 10 000 registos           | Importação CSV                            |
+| 10 000 - 50 000 registos           | Importação CSV (dividida em ficheiros)    |
+| **Mais de 50 000 registos**        | **Importação via API**                    |
+| Migração única                     | Qualquer um dos dois (com base no volume) |
+| **Importações recorrentes**        | **Importação via API**                    |
+| **Sincronização em tempo real**    | **Importação via API**                    |
+| **Integração com outros sistemas** | **Importação via API**                    |
+
+<Note>Para conjuntos de dados na casa das centenas de milhares, a API é significativamente mais rápida e mais fiável do que múltiplas importações CSV.</Note>
+
+## Limites de taxa da API
+
+A Twenty impõe limites de taxa para assegurar a estabilidade do sistema:
+
+| Limite                           | Valor                  |
+| -------------------------------- | ---------------------- |
+| **Pedidos por minuto**           | 100                    |
+| **Registos por chamada em lote** | 60                     |
+| **Taxa de transferência máxima** | ~6 000 registos/minuto |
+
+<Warning>
+**Planeie a sua importação em função destes limites.**
+
+Para 100 000 registos à taxa de transferência máxima, conte com aproximadamente 17 minutos de tempo de importação. Adicione tempo de margem para tratamento de erros e novas tentativas.
+</Warning>
+
+## Primeiros passos
+
+### Passo 1: Obtenha a sua chave de API
+
+1. Vá para **Configurações → Programadores**
+2. Clique em **+ Criar chave de API**
+3. Dê à sua chave um nome descritivo
+4. Copie imediatamente a chave de API (não será mostrada novamente)
+5. Guarde-a em segurança
+
+<Warning>
+**Mantenha a sua chave de API em segredo.**
+
+Qualquer pessoa com a sua chave de API pode aceder e modificar os dados do seu espaço de trabalho. Nunca a faça commit em repositórios de código nem a partilhe publicamente.
+</Warning>
+
+### Passo 2: Escolha a sua API
+
+A Twenty suporta dois tipos de API:
+
+| API         | Melhor para                                                              | Documentação                                  |
+| ----------- | ------------------------------------------------------------------------ | --------------------------------------------- |
+| **GraphQL** | Consultas flexíveis, obtenção de dados relacionados, operações complexas | [Documentação da API](/l/pt/developers/extend/api) |
+| **REST**    | Operações CRUD simples, padrões REST familiares                          | [Documentação da API](/l/pt/developers/extend/api) |
+
+Ambas as APIs suportam:
+
+* Criar, ler, atualizar e eliminar registos
+* **Operações em lote** — criar ou atualizar até 60 registos por chamada
+
+**Para importações, use operações em lote** para maximizar a taxa de transferência dentro dos limites de taxa.
+
+### Passo 3: Planeie a ordem da importação
+
+Tal como nas importações por CSV, **a ordem importa** para as relações:
+
+1. **Empresas** primeiro (sem dependências)
+2. **Pessoas** em segundo (podem ligar-se a Empresas)
+3. **Oportunidades** em terceiro (podem ligar-se a Empresas e Pessoas)
+4. **Tarefas/Notas** (podem ligar-se a qualquer um dos anteriores)
+5. **Objetos personalizados** (seguindo as suas dependências)
+
+## Melhores Práticas
+
+### Agrupe os seus pedidos
+
+* Não envie registos um de cada vez
+* Agrupe até **60 registos por chamada de API**
+* Isto maximiza a taxa de transferência dentro dos limites de taxa
+
+### Lide com os limites de taxa
+
+* Implemente atrasos entre pedidos (mínimo de 600 ms para importações contínuas)
+* Use backoff exponencial quando atingir os limites
+* Monitorize respostas 429 (Too Many Requests)
+
+### Valide os dados primeiro
+
+* Limpe e valide os seus dados antes de importar
+* Verifique se os campos obrigatórios estão preenchidos
+* Verifique se os formatos correspondem aos requisitos da Twenty (veja [Mapeamento de Campos](/l/pt/user-guide/data-migration/capabilities/field-mapping))
+
+### Registe tudo
+
+* Registe cada registo importado (incluindo IDs)
+* Registe erros com todo o contexto
+* Isto ajuda a depurar problemas e a verificar a conclusão
+
+### Teste primeiro
+
+* Teste com um pequeno lote (10-20 registos)
+* Verifique se os dados aparecem corretamente na Twenty
+* Depois, execute a importação completa
+
+### Upsert para evitar duplicados
+
+A API GraphQL suporta **upsert em lote** — atualize se o registo existir, crie se não existir. Isto evita duplicados ao voltar a executar importações.
+
+## Encontrar nomes de objetos e campos
+
+Para ver os objetos e campos disponíveis:
+
+1. Vá para **Configurações → API e Webhooks**
+2. Explore a **API de Metadados**
+3. Veja todos os objetos padrão e personalizados com os seus campos
+
+A documentação mostra todos os objetos padrão e personalizados, os seus campos e os tipos de dados esperados.
+
+## Serviços Profissionais
+
+Para migrações de API complexas, os nossos parceiros podem ajudar:
+
+| Serviço                               | O que está incluído                          |
+| ------------------------------------- | -------------------------------------------- |
+| **Conceção do Modelo de Dados**       | conceber a sua estrutura de dados ideal      |
+| **Scripts de migração**               | escrever e executar os scripts de importação |
+| **Transformação de dados**            | tratar de mapeamentos complexos e limpeza    |
+| **Validação e Garantia de Qualidade** | verificar que a migração está concluída      |
+
+**Melhor para:**
+
+* Migrações de mais de 100 000 registos
+* Transformações de dados complexas
+* Prazos apertados
+* Equipas sem recursos de programadores
+
+Contacte-nos em [contact@twenty.com](mailto:contact@twenty.com) ou explore os nossos [Serviços de Implementação](/l/pt/user-guide/getting-started/capabilities/implementation-services).
+
+## Perguntas Frequentes
+
+<AccordionGroup>
+  <Accordion title="Qual é a diferença entre GraphQL e REST?">
+    O GraphQL permite solicitar exatamente os dados de que precisa numa única consulta e é melhor para operações complexas. O REST utiliza métodos HTTP padrão (GET, POST, PUT, DELETE) e pode ser mais familiar se já trabalhou com APIs tradicionais.
+  </Accordion>
+
+  <Accordion title="Posso atualizar registos existentes via API?">
+    Sim! Utilize mutations de atualização (GraphQL) ou pedidos PUT/PATCH (REST) com o `id` do registo.
+  </Accordion>
+
+  <Accordion title="Como devo lidar com duplicados?">
+    Pesquise primeiro por registos existentes usando identificadores únicos (email, domínio). Atualize se existir, crie se não existir.
+  </Accordion>
+
+  <Accordion title="Posso eliminar registos via API?">
+    Sim, utilize mutations de eliminação (GraphQL) ou pedidos DELETE (REST).
+  </Accordion>
+
+  <Accordion title="Existe um SDK para Python ou Node.js?">
+    De momento não, mas ambas as APIs funcionam com qualquer cliente HTTP em qualquer linguagem.
+  </Accordion>
+</AccordionGroup>
+
+## Documentação da API
+
+Para detalhes completos de implementação, exemplos de código e referência de esquema:
+
+* [Documentação da API](/l/pt/developers/extend/api)

packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv.mdx

@@ -0,0 +1,225 @@
+---
+title: Importar Relações Entre Objetos via CSV
+description: Guia completo, passo a passo, para associar registos durante a importação de CSV.
+---
+
+## 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.
+
+<Note>**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.</Note>
+
+## 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
+
+| Relação                  | Lado "Um" (Pai) | Lado "Muitos" (Filho) |
+| ------------------------ | --------------- | --------------------- |
+| Empresas → Pessoas       | Empresa         | Pessoas               |
+| Empresas → Oportunidades | Empresa         | Oportunidades         |
+| Pessoas → Tarefas        | Pessoa          | Tarefas               |
+| Pessoas → Notas          | Pessoa          | Notas                 |
+
+## 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)
+
+<Warning>
+**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.
+</Warning>
+
+## Passo 3: Anote o identificador único do pai
+
+Precisa de referenciar o registo pai usando um **identificador único**. Opções disponíveis:
+
+| Objeto Pai                 | Identificadores Únicos Disponíveis                                        |
+| -------------------------- | ------------------------------------------------------------------------- |
+| **Empresas**               | `id` (UUID), `domain` (recomendado) ou qualquer campo único personalizado |
+| **Pessoas**                | `id` (UUID), `email` ou qualquer campo único personalizado                |
+| **Membros do Workspace**   | `id` (UUID), `email` (não o nome)                                         |
+| **Objetos personalizados** | `id` (UUID) ou qualquer campo marcado como único                          |
+
+<Note>**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.</Note>
+
+### 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:**
+
+```csv
+firstName,lastName,email,jobTitle,companyDomain
+John,Smith,john@acme.com,CEO,https://acme.com
+Jane,Doe,jane@widgets.co,CTO,https://widgets.co
+Bob,Johnson,bob@techstart.io,Developer,https://techstart.io
+```
+
+A coluna `companyDomain` faz referência ao domínio da Empresa.
+
+### Requisitos de Formato
+
+| Identificador | Formato        | Exemplo                                |
+| ------------- | -------------- | -------------------------------------- |
+| Domínio       | Formato de URL | `https://acme.com`                     |
+| E-mail        | Email padrão   | `john@acme.com`                        |
+| ID            | UUID           | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
+
+<Warning>
+**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.
+</Warning>
+
+### 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
+
+| Erro                                           | Problema                                         | Solução                                                                |
+| ---------------------------------------------- | ------------------------------------------------ | ---------------------------------------------------------------------- |
+| **Ordem de importação incorreta**              | Importar Pessoas antes de Empresas               | Importe sempre primeiro os pais e depois os filhos                     |
+| **Formato de domínio incorreto**               | Usar `acme.com` em vez de `https://acme.com`     | Use o formato completo de URL com `https://`                           |
+| **Vários campos únicos**                       | Mapear ambos `companyId` E `companyDomain`       | Mapeie apenas UM identificador único                                   |
+| **Campo de relação em falta**                  | O campo de relação não existe no modelo de dados | Crie-o em **Definições → Modelo de Dados** antes de importar           |
+| **Registos inexistentes**                      | O registo pai não existe no Twenty               | Importe primeiro os registos pai ou verifique se há erros ortográficos |
+| **Incompatibilidade de maiúsculas/minúsculas** | `Acme.com` no ficheiro mas `acme.com` no Twenty  | Garanta correspondência exata de maiúsculas/minúsculas                 |
+
+## 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"
+
+```csv
+taskName,assignedTo
+Follow up with client,john@yourcompany.com
+Review proposal,jane@yourcompany.com
+```
+
+## Perguntas Frequentes
+
+<AccordionGroup>
+  <Accordion title="E se o meu registo pai não tiver um domínio ou email?">
+    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
+  </Accordion>
+
+  <Accordion title="Posso atualizar relações em registos existentes?">
+    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.
+  </Accordion>
+
+  <Accordion title="Posso importar relações muitos-para-muitos?">
+    Relações muitos-para-muitos ainda não são suportadas para importação. Isto está planeado para o 1.º semestre de 2026.
+  </Accordion>
+
+  <Accordion title="Posso ligar a vários tipos de objeto (como Notas a Pessoas E Empresas)?">
+    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.
+  </Accordion>
+
+  <Accordion title="O que acontece se um registo pai não existir?">
+    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
+  </Accordion>
+
+  <Accordion title="Porque é que a minha relação não está a ligar corretamente?">
+    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)
+  </Accordion>
+</AccordionGroup>
+
+<Warning>
+**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.
+</Warning>
+
+## Resolução de Problemas
+
+Está a ter problemas? Consulte:
+
+* [Como Corrigir Erros de Importação](/l/pt/user-guide/data-migration/how-tos/fix-import-errors)
+* [Capacidades de Importação de Relações](/l/pt/user-guide/data-migration/capabilities/import-relations)
+* [Restrições de Unicidade](/l/pt/user-guide/data-migration/capabilities/uniqueness-constraints)

packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/migrating-from-other-crms.mdx

@@ -0,0 +1,289 @@
+---
+title: Migração de Outros CRMs
+description: Guia passo a passo para migrar os seus dados de qualquer CRM para o Twenty.
+---
+
+## Visão Geral
+
+Este guia explica como migrar os seus dados de qualquer CRM para o Twenty. O processo envolve auditar os seus dados, preparar o seu espaço de trabalho no Twenty, exportar do seu sistema atual e importar para o Twenty.
+
+<Note>Vistas, fluxos de trabalho e permissões devem ser recriados manualmente após a migração. Reserve tempo para este trabalho de configuração.</Note>
+
+## Passo 1: Auditar os seus dados atuais
+
+A migração é uma oportunidade para um novo começo. Não traga dados desnecessários.
+
+**O que manter:**
+
+* Contactos ativos e empresas ativas
+* Oportunidades e negócios em aberto
+* Notas e atividades importantes
+* Campos personalizados que realmente utiliza
+
+**O que deixar para trás:**
+
+* Contactos desatualizados (sem atividade há mais de 2 anos)
+* Registos duplicados
+* Dados de teste
+* Campos personalizados não utilizados
+
+## Passo 2: Mapear o seu modelo de dados
+
+Crie um documento de mapeamento entre o seu CRM atual e o Twenty:
+
+| O seu CRM              | Twenty                   |
+| ---------------------- | ------------------------ |
+| Conta / Organização    | **Empresa**              |
+| Contacto / Pessoa      | **Pessoas**              |
+| Negócio / Oportunidade | **Oportunidade**         |
+| Atividade              | **Tarefa** ou **Nota**   |
+| Objeto personalizado   | **Objeto personalizado** |
+
+**Para cada campo, documente:**
+
+* O nome do campo de origem
+* O campo de destino no Twenty
+* Quaisquer transformações de formato necessárias (datas, números de telefone, etc.)
+
+<Note>Mantenha este documento de mapeamento à mão durante a importação — irá referenciá-lo ao mapear as colunas.</Note>
+
+## Passo 3: Configure o seu espaço de trabalho no Twenty
+
+Antes de importar dados, prepare o seu espaço de trabalho no Twenty:
+
+### Crie objetos e campos personalizados
+
+1. Vá a **Definições → Modelo de Dados**
+2. Crie todos os objetos personalizados de que necessita
+3. Adicione campos personalizados a objetos padrão e personalizados
+4. Configure as definições dos campos (único, obrigatório, opções de seleção, etc.)
+
+<Warning>
+**Os campos devem existir antes da importação.**
+
+A importação de CSV cria registos, não campos. Crie todos os campos personalizados em Definições → Modelo de Dados antes de importar.
+</Warning>
+
+### Convide a sua equipa
+
+<Warning>
+**Convide os utilizadores ANTES de importar dados.**
+
+Se os seus dados incluírem referências a utilizadores (Proprietário da conta, Responsável, etc.), esses utilizadores devem existir no Twenty antes da importação. Caso contrário, essas relações não podem ser mapeadas.
+</Warning>
+
+1. Vá para **Configurações → Membros**
+2. Convide todos os membros da equipa
+3. **Aguarde que todos aceitem** o convite
+4. Verifique se todos os utilizadores aparecem na sua lista de Membros
+
+## Passo 4: Exporte a partir do seu CRM atual
+
+Exporte os seus dados do seu CRM atual:
+
+1. Procure uma função **Exportar** (normalmente em Definições, Gestão de Dados ou Administração)
+2. Exporte para o **formato CSV** sempre que possível
+3. Exporte cada tipo de objeto separadamente (Empresas, Contactos, Negócios, etc.)
+4. Inclua todos os campos que pretende migrar
+
+**Exporte estes objetos (nesta ordem, para referência):**
+
+1. Empresas / Contas / Organizações
+2. Contactos / Pessoas
+3. Negócios / Oportunidades
+4. Notas e Atividades
+5. Objetos personalizados
+
+## Passo 5: Limpe e formate os seus dados
+
+Abra cada CSV exportado numa aplicação de folha de cálculo e prepare-o para o Twenty.
+
+### Remova duplicados
+
+1. Ordene pelo campo único (e-mail para Pessoas, domínio para Empresas)
+2. Remova ou una linhas duplicadas
+3. Verifique se não existem já duplicados no Twenty
+
+### Formate os campos corretamente
+
+| Tipo de campo         | Formato obrigatório                                     |
+| --------------------- | ------------------------------------------------------- |
+| **Domínio**           | `https://domain.com`                                    |
+| **Email**             | `name@domain.com` (deve ser único)                      |
+| **Data**              | `YYYY-MM-DD`                                            |
+| **Telefone**          | Três colunas: Número, Código do País, Código de Chamada |
+| **Booleano**          | `TRUE` ou `FALSE` (maiúsculas)                          |
+| **Campos de seleção** | Use nomes de API, não os rótulos de apresentação        |
+
+<Warning>
+**O formato do domínio é crítico.**
+
+Use `https://domain.com` (não `domain.com` nem `www.domain.com`). Isto corresponde ao formato do Twenty e evita duplicados quando ligar a sincronização de e-mail/calendário.
+</Warning>
+
+Veja [Como preparar os seus ficheiros CSV](/l/pt/user-guide/data-migration/how-tos/prepare-your-csv-files) para requisitos completos de formatação para todos os tipos de campo.
+
+### Adicione colunas de relação
+
+Para ligar registos (por exemplo, Pessoas a Empresas), adicione uma coluna com o identificador único do registo pai.
+
+**Exemplo: CSV de Pessoas com ligação à Empresa**
+
+```csv
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+Veja [Como importar relações](/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) para instruções detalhadas sobre como ligar registos.
+
+### Atualize as referências a utilizadores
+
+Se os seus dados incluírem atribuições de utilizador (Proprietário, Responsável):
+
+1. Adicione uma coluna com o **e-mail do utilizador** (não apenas o ID dele do sistema antigo)
+2. Use os mesmos endereços de e-mail que os utilizadores usaram para aderir ao seu espaço de trabalho no Twenty
+
+Veja [Como preparar os seus ficheiros CSV](/l/pt/user-guide/data-migration/how-tos/prepare-your-csv-files) para o guia completo de formatação.
+
+## Passo 6: Importe para o Twenty
+
+<Warning>
+**A ordem de importação é importante!**
+
+Importe sempre por esta ordem:
+1. **Empresas** primeiro (sem dependências)
+2. **Pessoas** em segundo (ligadas a Empresas)
+3. **Oportunidades** em terceiro (ligadas a Empresas/Pessoas)
+4. **Notas e Tarefas** (ligadas a registos)
+5. **Objetos personalizados** seguindo as suas dependências
+
+O registo pai deve existir antes de o poder referenciar.
+</Warning>
+
+### Importe cada objeto
+
+Para cada ficheiro CSV, por ordem:
+
+1. Navegue até ao objeto no Twenty
+2. Clique em **⋮ → Importar registos**
+3. Carregue o ficheiro CSV
+4. Mapeie as colunas para os campos:
+   * Mapeie as colunas de e-mail do utilizador para os campos de relação apropriados
+   * Mapeie as colunas de relação (como `companyDomain`) para campos de relação
+5. Revise e corrija quaisquer erros na interface
+6. Confirme a importação
+7. Verifique alguns registos antes de avançar para o ficheiro seguinte
+
+**Guias detalhados:**
+
+* [Como importar empresas](/l/pt/user-guide/data-migration/how-tos/import-companies-via-csv)
+* [Como importar contactos](/l/pt/user-guide/data-migration/how-tos/import-contacts-via-csv)
+* [Como importar relações](/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+
+## Passo 7: Migrações de grande dimensão (50 000+ registos)
+
+Para migrações de grande dimensão:
+
+| Volume                   | Abordagem recomendada          |
+| ------------------------ | ------------------------------ |
+| Menos de 10 000 registos | Uma única importação CSV       |
+| 10 000 - 50 000 registos | Divida em vários ficheiros CSV |
+| Mais de 50 000 registos  | Utilize a API                  |
+
+**Para importações via API:**
+
+* Mais rápido e fiável para conjuntos de dados grandes
+* Suporta operações em lote (até 60 registos por chamada)
+* Consulte [Como importar dados via API](/l/pt/user-guide/data-migration/how-tos/import-data-via-api)
+
+## Passo 8: Configuração pós-migração
+
+Após importar os dados, complete a configuração do seu espaço de trabalho:
+
+### Recrie vistas
+
+* Configure vistas guardadas com filtros, ordenações e configurações de colunas
+* Crie quaisquer vistas kanban ou de calendário de que necessite
+
+### Recriar Fluxos de Trabalho
+
+* Recrie as suas automatizações em **Definições → Fluxos de trabalho**
+* Comece pelos fluxos de trabalho mais críticos
+* Teste cada um antes de confiar nele
+
+### Configure funções e permissões
+
+* Configure as funções em **Definições → Membros → Funções**
+* Atribua os utilizadores às funções apropriadas
+
+### Ligue o e-mail e o calendário
+
+* Cada utilizador liga a sua própria conta em **Definições → Contas**
+* O Twenty começará a sincronizar e-mails com os registos de contactos
+* Consulte [E-mail e Calendário](/l/pt/user-guide/calendar-emails/overview)
+
+### Forme a sua equipa
+
+* Percorram juntos a nova interface
+* Documente quaisquer processos específicos da equipa
+
+## Problemas Comuns e Soluções
+
+| Problema                        | Causa                                 | Solução                                                                                                 |
+| ------------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| **Erros de duplicados**         | E-mail/domínio já existe              | Remova os duplicados do ficheiro ou inclua um identificador único para atualizar os registos existentes |
+| **Relação não encontrada**      | O registo pai não existe              | Importe primeiro os objetos pai (Empresas antes de Pessoas)                                             |
+| **Campos em falta**             | O campo personalizado não existe      | Crie o campo em Definições → Modelo de Dados antes de importar                                          |
+| **Erros em campos de seleção**  | Utilização de rótulos de apresentação | Use nomes de API (ative o modo Avançado em Definições para os encontrar)                                |
+| **Relação de utilizador vazia** | O utilizador não aceitou o convite    | Garanta que todos os utilizadores aceitam os convites antes de importar                                 |
+
+Consulte [Como Corrigir Erros de Importação](/l/pt/user-guide/data-migration/how-tos/fix-import-errors) para passos detalhados de resolução de problemas.
+
+## Lista de Verificação Pós-Migração
+
+### Integridade dos dados
+
+<Check>Todos os registos importados (compare contagens com o sistema de origem)</Check>
+<Check>Relações a funcionar corretamente (Pessoas ligadas a Empresas)</Check>
+<Check>Atribuições de utilizador mapeadas corretamente (Proprietário, Responsável)</Check>
+<Check>Campos personalizados preenchidos</Check>
+<Check>Sem duplicados inesperados</Check>
+
+### Configuração
+
+<Check>Vistas recriadas</Check>
+<Check>Fluxos de trabalho recriados e testados</Check>
+<Check>Funções e permissões configuradas</Check>
+<Check>Sincronização de e-mail/calendário ligada</Check>
+
+### Preparação da equipa
+
+<Check>Equipa formada no novo sistema</Check>
+<Check>Plano de acesso ao CRM antigo decidido (manter para referência? Quando desativar?)</Check>
+
+## Perguntas Frequentes
+
+<AccordionGroup>
+  <Accordion title="Posso migrar fluxos de trabalho automaticamente?">
+    De momento, não. Os fluxos de trabalho devem ser recriados manualmente no Twenty.
+  </Accordion>
+
+  <Accordion title="E quanto aos anexos de ficheiros?">
+    Os anexos de ficheiros não estão incluídos nas exportações CSV. Terá de voltar a carregá-los manualmente, migrá-los via API ou contactar a nossa equipa para obter assistência.
+  </Accordion>
+
+  <Accordion title="Posso manter ambos os sistemas a funcionar durante a migração?">
+    Sim, recomendamos manter o seu CRM antigo a funcionar até verificar que a migração está concluída. Apenas tenha cuidado para não criar novos dados em ambos os locais.
+  </Accordion>
+
+  <Accordion title="Quanto tempo demora normalmente a migração?">
+    Depende do volume e da complexidade dos dados. Migrações pequenas (menos de 10 000 registos) podem ser feitas em poucas horas. Migrações grandes podem demorar vários dias, incluindo limpeza de dados e testes.
+  </Accordion>
+</AccordionGroup>
+
+## Precisa de ajuda?
+
+<Tip>
+  Quer ajuda com a sua migração? [Encontre um Vinte Parceiro certificado](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-migrate-crm) para mover seus dados, pipelines e usuários de ponta a ponta.
+</Tip>

packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/migrating-from-self-hosted-to-cloud.mdx

@@ -0,0 +1,173 @@
+---
+title: Migração de Auto-Hospedagem para Nuvem
+description: Guia passo a passo para migrar a sua instância Twenty auto-hospedada para a Twenty Cloud.
+---
+
+## Visão Geral
+
+Este guia orienta-o na migração dos seus dados de uma instância Twenty auto-hospedada para a Twenty Cloud. O processo envolve configurar o seu espaço de trabalho na cloud, exportar os seus dados e voltar a importá-los.
+
+<Note>Vistas, fluxos de trabalho e funções devem ser recriados manualmente após a migração. Reserve tempo para este trabalho de configuração.</Note>
+
+## Passo 1: Crie o seu espaço de trabalho na Cloud
+
+1. Aceda a [app.twenty.com](https://app.twenty.com) e crie um novo espaço de trabalho
+2. Conclua o assistente de configuração inicial
+3. Anote o URL do seu novo espaço de trabalho
+
+## Passo 2: Recrie o seu Modelo de Dados
+
+Antes de importar os dados, recrie os seus objetos e campos personalizados:
+
+1. Aceda a **Configurações → Modelo de Dados** na sua instância na cloud
+2. Crie objetos personalizados que correspondam à sua configuração auto-hospedada
+3. Adicione campos personalizados a objetos padrão e personalizados
+4. Configure as definições dos campos (único, obrigatório, etc.)
+
+<Note>Tire capturas de ecrã do seu modelo de dados auto-hospedado para referência ou mantenha ambas as instâncias abertas lado a lado.</Note>
+
+## Passo 3: Convide todos os utilizadores
+
+<Warning>
+**Crítico: Convide os utilizadores ANTES de importar dados.**
+
+Os utilizadores devem aceitar os convites antes de importar quaisquer registos que os referenciem (como campos Account Owner). Se os utilizadores ainda não existirem, essas relações não poderão ser mapeadas.
+</Warning>
+
+1. Aceda a **Configurações → Membros** na sua instância na cloud
+2. Convide todos os membros da equipa que tinham contas na instância auto-hospedada
+3. **Aguarde que todos aceitem** o convite
+4. Verifique se todos os utilizadores aparecem na sua lista de Membros
+
+## Passo 4: Exportar dados da instância auto-hospedada
+
+Exporte cada objeto da sua instância auto-hospedada:
+
+1. Aceda a cada objeto (Empresas, Pessoas, Oportunidades, etc.)
+2. Configure a vista para mostrar **todas as colunas** que pretende migrar
+3. Clique em **⋮ → Export view**
+4. Guarde cada ficheiro CSV com um nome claro (por exemplo, `companies-export.csv`)
+
+**Exporte nesta ordem** (para referência durante a importação):
+
+1. Empresas
+2. Pessoas
+3. Oportunidades
+4. Objetos personalizados (seguindo as suas dependências)
+5. Tarefas, Notas
+
+## Passo 5: Atualizar referências de Membros do espaço de trabalho
+
+Os CSV exportados contêm IDs de utilizador da sua instância auto-hospedada. Esses IDs não corresponderão à sua instância na cloud, por isso precisa de os substituir por endereços de e-mail.
+
+**Para cada ficheiro CSV com referências a utilizadores (Owner, Assignee, etc.):**
+
+1. Abra o CSV numa aplicação de folha de cálculo
+2. Adicione uma nova coluna ao lado de cada coluna de ID de utilizador (por exemplo, `accountOwnerEmail` ao lado de `accountOwnerId`)
+3. Preencha o **endereço de e-mail** de cada utilizador
+4. Pode apagar a coluna de ID antiga ou deixá-la (será ignorada durante a importação)
+
+**Exemplo:**
+
+Antes:
+
+```csv
+name,domain,accountOwnerId
+Acme Corp,https://acme.com,old-uuid-123
+```
+
+Depois:
+
+```csv
+name,domain,accountOwnerEmail
+Acme Corp,https://acme.com,john@yourcompany.com
+```
+
+<Note>Use os mesmos endereços de e-mail que os utilizadores usaram para aceitar o convite do espaço de trabalho na cloud.</Note>
+
+## Passo 6: Planeie a ordem de importação
+
+Importe os ficheiros na ordem correta para manter as relações:
+
+1. **Empresas** primeiro (sem dependências)
+2. **Pessoas** em segundo (ligadas a Empresas)
+3. **Oportunidades** em terceiro (ligadas a Empresas e Pessoas)
+4. **Objetos personalizados** (seguindo as suas dependências)
+5. **Tarefas e Notas** por último (ligadas a outros registos)
+
+Veja [Como importar relações](/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) para detalhes sobre a manutenção das relações.
+
+## Passo 7: Importar para a Cloud
+
+Para cada ficheiro CSV, por ordem:
+
+1. Aceda ao objeto na sua instância na cloud
+2. Clique em **⋮ → Import records**
+3. Carregue o ficheiro CSV
+4. Mapeie as colunas para os campos:
+   * Mapeie as colunas de e-mail do utilizador para os campos de relação apropriados
+   * Mapeie as outras colunas como de costume
+5. Revise e corrija quaisquer erros
+6. Confirme a importação
+7. Verifique alguns registos antes de avançar para o ficheiro seguinte
+
+## Passo 8: Recriar a configuração
+
+Depois de importar os dados, recrie manualmente:
+
+### Visualizações
+
+* Recrie vistas guardadas com filtros, ordenações e configurações de colunas
+* Configure quaisquer vistas kanban ou de calendário
+
+### Fluxos de trabalho
+
+* Recrie automatizações em **Configurações → Fluxos de trabalho**
+* Teste cada fluxo de trabalho antes de confiar nele
+
+### Funções e Permissões
+
+* Configure as funções em **Definições → Membros → Funções**
+* Atribua os utilizadores às funções apropriadas
+
+### Integrações
+
+* Volte a ligar a sincronização de e-mail e calendário para cada utilizador
+* Reconfigure quaisquer integrações de API com novas chaves de API
+
+## Lista de Verificação Pós-Migração
+
+<Check>Todos os dados importados com sucesso</Check>
+<Check>Relações entre objetos a funcionar corretamente</Check>
+<Check>Atribuições de utilizadores (Owner, Assignee) mapeadas corretamente</Check>
+<Check>Vistas recriadas</Check>
+<Check>Fluxos de trabalho recriados e testados</Check>
+<Check>Funções e permissões configuradas</Check>
+<Check>Sincronização de e-mail/calendário restabelecida</Check>
+<Check>Integrações de API atualizadas com novas chaves</Check>
+
+## Perguntas Frequentes
+
+<AccordionGroup>
+  <Accordion title="Posso migrar fluxos de trabalho automaticamente?">
+    De momento, não. Os fluxos de trabalho devem ser recriados manualmente na sua instância na cloud.
+  </Accordion>
+
+  <Accordion title="E quanto a anexos de ficheiros e imagens?">
+    Os anexos de ficheiros não estão incluídos nas exportações CSV. Terá de voltar a carregar quaisquer anexos manualmente, migrá-los via API ou contactar a nossa equipa para obter assistência em migrações de grande dimensão.
+  </Accordion>
+
+  <Accordion title="Posso manter ambas as instâncias a funcionar durante a migração?">
+    Sim, recomendamos manter a sua instância auto-hospedada em funcionamento até verificar que a migração para a cloud está concluída. Apenas tenha cuidado para não criar novos dados em ambos os locais.
+  </Accordion>
+
+  <Accordion title="E se um utilizador ainda não tiver aceite o convite?">
+    Os registos que referenciam esse utilizador não serão importados ou a relação ficará vazia. Garanta que todos os utilizadores aceitam os convites antes de importar os dados.
+  </Accordion>
+</AccordionGroup>
+
+## Precisa de ajuda?
+
+<Tip>
+  Migrando um espaço de trabalho grande ou complexo? [Encontre um parceiro Twenty certificado](https://twenty.com/partners/list?categories=HOSTING\&ref=docs-migrate-cloud) para cuidar da migração de ponta a ponta. *(Ou envolva a nossa equipe: [contact@twenty.com](mailto:contact@twenty.com).)*
+</Tip>

packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx

@@ -0,0 +1,267 @@
+---
+title: Prepare seus arquivos CSV
+description: Guia completo passo a passo para formatar seus dados para importação no Twenty.
+---
+
+## Visão Geral
+
+Este guia orienta você na preparação do seu arquivo CSV para uma importação bem-sucedida. Siga estas etapas para evitar erros.
+
+## Etapa 1: Verifique os requisitos do arquivo
+
+Antes de começar, verifique se o seu arquivo atende a estes requisitos:
+
+| Requisito             | Detalhes                      |
+| --------------------- | ----------------------------- |
+| **Formato**           | CSV, XLSX ou XLS              |
+| **Limite de tamanho** | 10.000 registros por arquivo  |
+| **Codificação**       | UTF-8 recomendado             |
+| **Estrutura**         | Um tipo de objeto por arquivo |
+
+<Note>Para conjuntos de dados maiores que 10.000 registros, divida em vários arquivos ou use a [importação via API](/l/pt/user-guide/data-migration/how-tos/import-data-via-api).</Note>
+
+## Etapa 2: Baixe o arquivo de exemplo
+
+**Esta é a etapa mais importante.** O arquivo de exemplo mostra os nomes exatos das colunas e o formato que o Twenty espera.
+
+1. Navegue até qualquer objeto (Pessoas, Empresas, etc.)
+2. Clique em **⋮** → **Importar registros**
+3. Clique em **Baixar arquivo de exemplo**
+4. Use este arquivo como seu modelo
+
+<Note>**Dica de especialista:** Em vez disso, exporte alguns registros existentes. Isso fornece exemplos reais de como os dados devem ser formatados, e os nomes das colunas serão mapeados automaticamente durante a importação.</Note>
+
+## Etapa 3: Remova valores duplicados
+
+O Twenty impõe unicidade em determinados campos. Duplicados causarão erros de importação.
+
+| Objeto                     | Campos exclusivos                                                  |
+| -------------------------- | ------------------------------------------------------------------ |
+| **Pessoas**                | `id`, `email`                                                      |
+| **Empresas**               | `id`, `domain`                                                     |
+| **Objetos personalizados** | `id`, além de qualquer campo que você tenha marcado como exclusivo |
+
+**Antes de importar:**
+
+1. Ordene sua planilha pelo campo exclusivo (email ou domínio)
+2. Remova ou mescle linhas duplicadas
+3. Verifique se há duplicados que já existem no Twenty
+
+<Warning>**Registros excluídos logicamente contam para a unicidade.** Registros em Menu de Comando → Ver registros excluídos causarão erros de duplicação. Exclua-os permanentemente ou restaure e atualize-os.</Warning>
+
+## Etapa 4: Formate corretamente cada tipo de campo
+
+Tipos de campo diferentes exigem formatos específicos. Aqui está a referência completa:
+
+### Campos de texto
+
+* Nenhuma formatação especial é necessária
+* Espaços no início/fim são automaticamente removidos
+
+### Campos de email
+
+* Deve estar em um formato de email válido: `name@domain.com`
+* Deve ser exclusivo (sem duplicados no arquivo ou no Twenty)
+* Para emails adicionais, use este formato na coluna **Emails / Additional Emails**:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### Campos de domínio
+
+* **Formato recomendado**: `https://domain.com`
+* Isso corresponde ao formato usado pela sincronização de caixa de correio/calendário (evita duplicados)
+* Preencha ambas as colunas:
+  * **Domain / Domain Label**: `domain.com`
+  * **Domain / Domain URL**: `https://domain.com`
+* Deve ser exclusivo dentro do seu arquivo e no Twenty
+
+### Campos de telefone
+
+Telefone é um **campo aninhado** que requer várias colunas:
+
+| Coluna                                  | Exemplo      |
+| --------------------------------------- | ------------ |
+| **Phones / Primary Phone Number**       | `4159095555` |
+| **Phones / Primary Phone Country Code** | `US`         |
+| **Phones / Primary Phone Calling Code** | `+1`         |
+
+### Campos de Endereço
+
+Endereço é um **campo aninhado** com várias colunas (algumas podem ficar em branco):
+
+* **Endereço / Endereço 1**: Linha 1 do endereço
+* **Endereço / Endereço 2**: Linha 2 do endereço (opcional)
+* **Endereço / Cidade**: Nome da cidade
+* **Endereço / Estado**: Estado ou província
+* **Endereço / País**: Nome do país
+* **Endereço / Código Postal**: Código Postal/CEP
+
+### Campos de Data
+
+Use formatação consistente em todo o seu arquivo:
+
+* `YYYY-MM-DD` (recomendado): `2024-03-15`
+* ISO 8601: `2024-03-15T10:30:00Z`
+
+### Campos Numéricos
+
+* Apenas números (sem texto)
+* Use ponto para decimais: `1234.56`
+* Sem separadores de milhares (não `1,234.56`)
+
+### Campos de Moeda
+
+Moeda é um **campo aninhado** que requer duas colunas que **ambas devem ser preenchidas**:
+
+| Coluna            | Exemplo   |
+| ----------------- | --------- |
+| **Valor / Valor** | `1234.56` |
+| **Valor / Moeda** | `USD`     |
+
+### Campos Booleanos
+
+Use maiúsculas: `TRUE` ou `FALSE`
+
+<Warning>`true` ou `false` em minúsculas não funcionam.</Warning>
+
+### Campos de Seleção
+
+Use o **nome da API** da opção, não o rótulo de exibição.
+
+**Como encontrar nomes da API:**
+
+1. Vá para **Configurações → Modelo de Dados**
+2. Selecione o objeto e o campo
+3. Ative o **Modo Avançado** (alternador no canto inferior direito)
+4. Copie o nome da API (por exemplo, `OPTION_1`, não "Option 1")
+
+<Note>Novas opções de seleção não são criadas automaticamente. Adicione-as em **Configurações → Modelo de Dados** antes de importar.</Note>
+
+### Campos de Seleção Múltipla
+
+Use os nomes da API no formato de array:
+
+```
+["VALUE1","VALUE2"]
+```
+
+### Campos de Array
+
+Use o formato de array JSON:
+
+```
+["value1","value2"]
+```
+
+### Campos de Classificação
+
+Use o formato: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4` ou `RATING_5`
+
+### Campos de Links/URL
+
+Preencha ambas as colunas:
+
+* **Links / Rótulo do Link**: `Twenty`
+* **Links / URL do Link**: `https://twenty.com`
+
+Para links secundários, use a coluna **Links / Links Secundários**:
+
+```
+[{"url":"https://twenty.com","label":"Twenty"}]
+```
+
+### Campos JSON
+
+Use um formato JSON válido:
+
+```
+{"key":"value","key2":"value2"}
+```
+
+### Campos de ID
+
+* **Opcional**: a Twenty gera IDs automaticamente se não forem fornecidos
+* **Formato**: UUID (por exemplo, `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`)
+* **Caso de uso**: Inclua o ID para atualizar registros existentes em vez de criar novos
+
+## Etapa 5: Adicione Colunas de Relação (se estiver vinculando registros)
+
+Para vincular registros a outros objetos (por exemplo, Pessoas a Empresas), adicione uma coluna com o identificador exclusivo do registro relacionado.
+
+**Exemplo**: Vinculando Pessoas a Empresas
+
+Adicione uma coluna ao seu CSV de Pessoas:
+
+```
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+**Regras importantes para relações:**
+
+* O registro pai já deve existir na Twenty
+* Use o formato **URL de domínio** (`https://domain.com`), não o rótulo
+* Mapeie apenas UM identificador exclusivo (não inclua `companyId` E `companyDomain`)
+* Para Membros do Workspace, use o **email** deles (não o nome)
+
+<Warning>
+**A ordem de importação é importante!**
+
+Importe o lado "um" antes do lado "muitos":
+1. **Empresas** primeiro
+2. **Pessoas** em segundo (com referência à empresa)
+3. **Oportunidades** em terceiro
+
+O registro pai deve existir antes de você poder referenciá-lo.
+</Warning>
+
+Veja [Como importar relações](/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) para instruções detalhadas.
+
+## Etapa 6: Garanta que os campos existam na Twenty
+
+A importação cria registros, não campos. Todos os campos que você deseja importar já devem existir no seu modelo de dados.
+
+**Antes de importar:**
+
+1. Vá para **Configurações → Modelo de Dados**
+2. Selecione o seu objeto
+3. Crie todos os campos personalizados necessários
+4. Anote os nomes exatos dos campos (eles devem corresponder aos cabeçalhos das suas colunas)
+
+## Etapa 7: Lista de Verificação Final
+
+Antes de enviar seu arquivo, verifique:
+
+<Check>O arquivo está no formato CSV, XLSX ou XLS</Check>
+<Check>O arquivo tem menos de 10.000 registros</Check>
+<Check>A codificação é UTF-8</Check>
+<Check>Sem emails duplicados (para Pessoas) ou domínios (para Empresas)</Check>
+<Check>As datas usam formato consistente em todo o arquivo</Check>
+<Check>Os domínios usam o formato `https://domain.com`</Check>
+<Check>Os campos booleanos usam `TRUE` ou `FALSE` (maiúsculas)</Check>
+<Check>Os campos de Seleção usam nomes da API, não rótulos de exibição</Check>
+<Check>Todos os campos personalizados existem em Configurações → Modelo de Dados</Check>
+<Check>Registros pai importados antes dos registros filho</Check>
+<Check>As colunas de relação referenciam registros existentes</Check>
+
+## Erros Comuns a Evitar
+
+| Erro                                            | Solução                                         |
+| ----------------------------------------------- | ----------------------------------------------- |
+| Usar `true` em vez de `TRUE`                    | Valores booleanos devem estar em maiúsculas     |
+| Usar rótulos de exibição para campos de Seleção | Encontre e use os nomes da API em Configurações |
+| Importar Pessoas antes de Empresas              | Sempre importe os objetos pai primeiro          |
+| Falta o código de moeda nos campos de Moeda     | Preencha as colunas Valor e Moeda               |
+| Formato de domínio incorreto                    | Use `https://domain.com` de forma consistente   |
+| Mapeando vários campos exclusivos para relações | Mapeie apenas UM (domínio OU ID, não ambos)     |
+
+## Próximos Passos
+
+Seu arquivo está pronto! Agora:
+
+* [Importar Empresas](/l/pt/user-guide/data-migration/how-tos/import-companies-via-csv) (importe-as primeiro)
+* [Importar Contatos](/l/pt/user-guide/data-migration/how-tos/import-contacts-via-csv)
+* [Corrigir quaisquer erros de importação](/l/pt/user-guide/data-migration/how-tos/fix-import-errors)

packages/twenty-docs/l/pt/user-guide/data-migration/how-tos/update-existing-records-via-import.mdx

@@ -0,0 +1,198 @@
+---
+title: Atualizar Registos Existentes via Importação
+description: Guia completo passo a passo para atualizar em massa registos através da importação de CSV.
+---
+
+## 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 existente | **Atualizar** o registo existente                         |
+| Não corresponde a nenhum registo   | **Criar** um novo registo                                 |
+| Está em falta no ficheiro          | **Criar** um novo registo (com ID gerado automaticamente) |
+
+<Warning>
+**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"]`
+</Warning>
+
+## 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
+
+<Note>**Porquê exportar primeiro?** O ficheiro exportado tem o formato correto, inclui identificadores únicos e é mapeado automaticamente durante a importação.</Note>
+
+### 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:**
+
+```csv
+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:**
+
+```csv
+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
+```
+
+<Warning>
+**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.
+</Warning>
+
+## 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
+
+| Objeto                     | Recomendado          | Alternativa | Notas                               |
+| -------------------------- | -------------------- | ----------- | ----------------------------------- |
+| **Pessoas**                | `email`              | `id`        | O email é legível por humanos       |
+| **Empresas**               | `domínio`            | `id`        | O domínio é legível por humanos     |
+| **Objetos personalizados** | Qualquer campo único | `id`        | Use o seu campo único personalizado |
+
+<Note>**Utilize apenas UM identificador único.** Não mapeie `email` E `id`. Isto pode causar confusão e erros.</Note>
+
+### 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`, `jobTitle`          | Apenas `jobTitle` é atualizado; os outros campos permanecem iguais |
+| `email`, `jobTitle`, `phone` | `jobTitle` 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:
+
+```csv
+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
+
+| Erro                                           | Problema                                                         | Resultado                                | Solução                                        |
+| ---------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------- | ---------------------------------------------- |
+| **Alterar o identificador único**              | Alterado de `john@acme.com` para `john.smith@acme.com`           | Cria um novo registo em vez de atualizar | Mantenha os identificadores únicos inalterados |
+| **Vários campos únicos**                       | Mapear `email` E `id`                                            | Potenciais conflitos de correspondência  | Mapeie apenas UM identificador único           |
+| **Sem identificador único**                    | O ficheiro tem apenas `firstName`, `lastName`, `jobTitle`        | Todas as linhas criam novos registos     | Inclua sempre `email`, `domain` ou `id`        |
+| **Incompatibilidade de maiúsculas/minúsculas** | O ficheiro tem `John@acme.com`, mas a Twenty tem `john@acme.com` | Cria novo registo                        | Exporte da Twenty para obter os valores exatos |
+
+## Perguntas Frequentes
+
+<AccordionGroup>
+  <Accordion title="E se alguns registos ainda não existirem?">
+    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.
+  </Accordion>
+
+  <Accordion title="Posso limpar/esvaziar o valor de um campo?">
+    Sim, deixe a célula vazia no seu CSV. A importação irá limpar o valor desse campo no registo existente.
+  </Accordion>
+
+  <Accordion title="O que acontece aos campos que não incluo na importação?">
+    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.
+  </Accordion>
+
+  <Accordion title="Posso atualizar campos de relação (como Empresa)?">
+    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.
+  </Accordion>
+
+  <Accordion title="Como sei quais os registos que serão atualizados vs. criados?">
+    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.
+  </Accordion>
+
+  <Accordion title="Posso desfazer uma atualização em massa?">
+    Não existe desfazer automático. Recomendamos exportar os seus dados como cópia de segurança antes de fazer atualizações em massa.
+  </Accordion>
+</AccordionGroup>
+
+## 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:
+
+* [Como Corrigir Erros de Importação](/l/pt/user-guide/data-migration/how-tos/fix-import-errors)
+* [Restrições de Unicidade](/l/pt/user-guide/data-migration/capabilities/uniqueness-constraints)
+* [Referência de Mapeamento de Campos](/l/pt/user-guide/data-migration/capabilities/field-mapping)

packages/twenty-docs/l/pt/user-guide/data-migration/overview.mdx

@@ -0,0 +1,83 @@
+---
+title: Migração de dados
+description: Importe e exporte os seus dados de CRM através de ficheiros CSV ou da API.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Métodos de importação
+
+A Twenty suporta dois métodos principais para importar dados:
+
+| Método                 | Melhor para                               | Limite de volume             |
+| ---------------------- | ----------------------------------------- | ---------------------------- |
+| **Importação de CSV**  | Migrações padrão, atualizações regulares  | 10 000 registos por ficheiro |
+| **Importação via API** | Migrações em grande escala, automatização | Sem limite                   |
+
+<Note>Para conjuntos de dados muito grandes (centenas de milhares de registos), utilize a API. Os nossos [parceiros de implementação](/l/pt/user-guide/getting-started/capabilities/implementation-services) podem ajudar a executar estes scripts, se necessário.</Note>
+
+## Noções básicas da importação de CSV
+
+Pode importar dados para qualquer objeto utilizando ficheiros CSV, XLSX ou XLS. Cada ficheiro deve conter **apenas um tipo de objeto** (por exemplo, apenas registos de Pessoas).
+
+<Note>**Os campos têm de existir antes da importação.** Carregar um CSV cria registos, mas não cria campos. Se precisar de campos personalizados, crie-os primeiro em **Definições → Modelo de dados**.</Note>
+
+### Passos
+
+1. Navegue até ao objeto onde pretende importar dados
+2. Clique no ícone **⋮** no canto superior direito (este é o Menu de Comandos) e clique em **Importar registos**
+3. Descarregue o ficheiro de modelo para garantir que os seus dados estão no formato esperado
+4. Carregue o seu ficheiro CSV formatado
+5. Mapeie as suas colunas para os campos da Twenty
+6. Revise os erros (realçados a amarelo) e corrija-os, editando diretamente na interface
+7. Confirme a importação
+
+### Importar Relações Entre Objetos
+
+Você pode importar relações entre objetos usando a função de importação CSV. Tem de referenciar o objeto relacionado utilizando um campo único desse objeto: o `id`, o `email` para Pessoas e Membros do espaço de trabalho, o `domain` para empresas, ou qualquer outro campo definido como único no modelo de dados para qualquer outro objeto.
+
+<Note>**Os registos eliminados contam para a unicidade.** Os registos eliminados logicamente (visíveis no Menu de Comandos → Ver registos eliminados) são incluídos nas verificações de unicidade. Se importar um registo com o mesmo valor único que um registo eliminado, o registo eliminado será restaurado.</Note>
+
+<Warning>
+**A ordem de importação é importante!**
+
+Ao importar objetos relacionados, carregue os ficheiros por esta ordem:
+1. **Empresas** primeiro (o lado "um" das relações)
+2. **Pessoas** em segundo (ligadas a Empresas via companyId)
+3. **Oportunidades** em terceiro (ligadas a Empresas/Pessoas)
+4. **Objetos personalizados** com relações por último
+
+Porquê? O lado "um" de uma relação um-para-muitos tem de existir antes de o poder referenciar. Por exemplo, o registo da Empresa tem de existir antes de importar uma Pessoa com o ID dessa empresa.
+</Warning>
+
+Consulte [este artigo](/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) para um guia passo a passo sobre como proceder.
+
+## Exportar Dados
+
+Exporte os dados do seu espaço de trabalho para cópias de segurança, relatórios ou migração.
+
+### Passos
+
+1. Navegue até ao objeto que pretende exportar
+2. Configure a visualização com as colunas de que necessita
+3. Clique em **⋮** → **Exportar visualização**
+4. Guarde o ficheiro CSV
+
+<Note>**Apenas as colunas visíveis são exportadas.** O ficheiro CSV conterá apenas as colunas apresentadas na sua visualização atual. Adicione ou oculte colunas antes de exportar para controlar que dados são incluídos.</Note>
+
+<Note>**Limites de exportação**: Até 20 000 registos por exportação.</Note>
+
+## Permissões
+
+A importação e a exportação de dados requerem permissões específicas:
+
+* **Importar**: Requer a permissão "Import CSV"
+* **Exportar**: Requer a permissão "Export CSV"
+
+Contacte o administrador do seu espaço de trabalho se não tiver estas permissões.
+
+## Próximos Passos
+
+* [Prepare os seus ficheiros CSV](/l/pt/user-guide/data-migration/how-tos/prepare-your-csv-files)
+* [Importar relações entre objetos](/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
+* [Importar via API para conjuntos de dados de grande dimensão](/l/pt/user-guide/data-migration/how-tos/import-data-via-api)

packages/twenty-docs/l/pt/user-guide/data-model/capabilities/fields.mdx

@@ -0,0 +1,122 @@
+---
+title: Campos
+description: Compreenda o papel dos campos e como geri-los.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Sobre Campos
+
+Os campos são como colunas em uma planilha. Eles armazenam diferentes tipos de dados como texto, números ou datas. Os campos podem ser padrão (incorporados) ou personalizados (os que você cria).
+
+### Campos Padrão
+
+Campos padrão vêm incorporados no Twenty para atender necessidades comuns de negócios.
+
+Por exemplo, `Nome` e `Sobrenome` são campos padrão no objeto `Pessoas`. Eles armazenam dados de texto para nomes individuais.
+
+Você não pode excluir campos padrão, mas pode desativá-los se não precisar deles.
+
+Também pode personalizar as opções dos campos padrão do tipo `SELECT`, por exemplo, as opções para o `Stage` em Oportunidades.
+
+<img src="/images/user-guide/fields/standard-fields.png" style={{width:'100%'}} />
+
+### Campos Personalizados
+
+Campos personalizados podem ser adicionados a qualquer objeto. Você pode armazenar texto, números, datas, seleções suspensas e mais. Use campos personalizados para rastrear informações específicas do seu negócio.
+
+Por exemplo, um campo personalizado para a SpaceX pode ser `Status Ativo do Foguete`, indicando se um foguete está operacional.
+
+<img src="/images/user-guide/fields/custom-fields.png" style={{width:'100%'}} />
+
+## Tipos de campo
+
+A Twenty suporta vários tipos de campo:
+
+| Tipo             | Descrição                                                         | Exemplo                  |
+| ---------------- | ----------------------------------------------------------------- | ------------------------ |
+| Endereço         | Endereço estruturado com rua, cidade, estado, país, código postal | Endereço do escritório   |
+| Matriz           | Lista de valores de texto                                         | Etiquetas                |
+| Booleano         | Caixa de seleção verdadeiro/falso                                 | Está ativo               |
+| Moeda            | Valor monetário com código de moeda                               | Valor do negócio (USD)   |
+| Data             | Valores de data                                                   | Data de Fecho            |
+| Data e hora      | Data com hora                                                     | Hora da reunião          |
+| Domínio          | Domínio do website (usado para Empresas)                          | acme.com                 |
+| E-mail           | Endereços de e-mail (com principal + adicionais)                  | E-mail do contacto       |
+| JSON             | Dados JSON estruturados                                           | Metadados personalizados |
+| Links            | URLs com rótulos (principal + secundário)                         | Website, LinkedIn        |
+| Texto longo      | Texto com várias linhas                                           | Descrição, Notas         |
+| Seleção Múltipla | Várias escolhas de uma lista predefinida                          | Etiquetas, Categorias    |
+| Número           | Valores numéricos (inteiros ou decimais)                          | Quantidade, Pontuação    |
+| Telefone         | Números de telefone com código do país                            | Telefone do trabalho     |
+| Avaliação        | Classificação por estrelas (1-5)                                  | Prioridade, Pontuação    |
+| Relação          | Ligações para registos noutros objetos                            | Empresa → Pessoas        |
+| Selecionar       | Escolha única de uma lista predefinida                            | Fase, Estado             |
+| Texto            | Uma única linha de texto                                          | Nome, Título             |
+
+## Criar um Campo Personalizado
+
+Para adicionar um campo personalizado a qualquer objeto, siga estas etapas:
+
+1. Acesse `Configurações` na barra lateral esquerda.
+2. Acesse `Modelo de Dados`, depois selecione o objeto que você deseja personalizar.
+3. Prossiga clicando em `+ Novo Campo`.
+4. Escolha um nome e tipo de campo que atenda aos seus requisitos. Considere adicionar uma descrição do campo para um melhor entendimento.
+
+Seu novo campo agora está disponível dentro dos campos do aplicativo. Para exibi-lo em uma vista específica, clique no menu de opções e selecione `Campos`.
+
+<VimeoEmbed videoId="927628219" title="Demonstração em vídeo" />
+
+**Modo rápido:** Clique no botão **+** no canto superior direito de qualquer tabela de objeto e selecione `Personalizar campos`. Isso leva você diretamente para as configurações do Modelo de Dados.
+
+<img src="/images/user-guide/fields/quick-new-field.png" style={{width:'100%'}} />
+
+## Desativar um campo
+
+Você pode desativar um campo para ocultá-lo no aplicativo sem perder seus dados. Pense nisso como esconder o campo em vez de excluí-lo.
+
+Veja como você pode fazer isso:
+
+1. Encontre o campo que deseja desativar nas configurações do seu objeto.
+2. Clique nos três pontos `⋮` ao lado do campo para abrir o menu.
+3. Selecione `Desativar` no menu suspenso.
+
+<img src="/images/user-guide/fields/deactivate-field.png" style={{width:'100%'}} />
+
+O que acontece quando você desativa um campo?
+
+1. **No aplicativo:** O campo desaparece e você não pode adicionar novos valores a ele.
+2. **Relações existentes:** Se for um campo de relação, conexões existentes permanecem, mas não é possível criar novas.
+3. **Acesso API:** Você ainda pode acessar o campo e seus dados através da API.
+
+Você pode reativar Campos Padrão e Personalizados ou ter a opção de excluí-los permanentemente.
+
+## Tornar Campos Únicos
+
+Torne um campo único para garantir que registros distintos não possam ter o mesmo valor. Por exemplo, endereços de e-mail são únicos para cada pessoa.
+
+Se você receber um erro ao definir exclusividade, verifique se há valores duplicados nos seus dados (incluindo registros excluídos).
+
+## Índices (Avançado)
+
+Os índices do banco de dados são gerenciados automaticamente — adicionar os seus próprios raramente é necessário e é fácil cometer erros. Com o modo Avançado ativado, cada objeto tem uma seção **Índices** em `Settings → Data Model → <object>` para os casos em que você sabe que precisa de um índice.
+
+## Melhores Práticas de Configuração de Campos
+
+### Convenções de Nomeação e Limitações
+
+* **Os nomes singular e plural devem ser distintos**: Nossa API GraphQL precisa de nomes distintos para mutações
+* **Nomes de campo protegidos**: alguns nomes são reservados para utilização do sistema (por exemplo, `Type`, `Application`)
+
+### Campos de Moeda e Telefone
+
+* **Moeda padrão**: pode ser configurada através do modelo de dados.
+* **Códigos de país padrão**: podem ser configurados para campos de telefone através do modelo de dados.
+
+### Campos de Seleção
+
+* **Uma opção padrão pode ser selecionada** para cada campo de Seleção.
+
+### Campos de Texto do Registro
+
+* **Cada objeto tem um campo principal de exibição**: Este campo aparece na coluna mais à esquerda e representa o registro quando vinculado a outros objetos. Ele deve ser um campo de texto. Por exemplo, `Pessoas` usa `Nome` como campo principal, então quando você vincula uma pessoa a uma empresa, verá seu nome na visão da empresa.

packages/twenty-docs/l/pt/user-guide/data-model/capabilities/objects.mdx

@@ -0,0 +1,92 @@
+---
+title: Objetos
+description: Saiba mais sobre objetos padrão e personalizados no Twenty.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Objetos Padrão
+
+Objetos padrão são entidades predefinidas no seu espaço de trabalho para ajudar você a começar. Eles fazem parte de um modelo de dados compartilhado acessível a todos os usuários do Twenty. Você pode usá-los como estão, personalizá-los ou desativá-los.
+
+<img src="/images/user-guide/objects/standard-objects.png" style={{width:'100%'}} />
+
+### Pessoas
+
+O objeto `Pessoas` armazena seus contatos. Inclui detalhes de contato e histórico de interação, para que você possa ver todas as interações com seus clientes em um só lugar.
+
+### Empresas
+
+O objeto `Empresas` armazena suas contas comerciais. Inclui detalhes como setor, tamanho e localização. Empresas conectam-se tanto aos objetos `Pessoas` quanto `Oportunidades`.
+
+### Oportunidades
+
+O objeto `Oportunidades` armazena dados relacionados a negócios. Acompanha o progresso das vendas potenciais, da prospecção ao fechamento, registrando etapas, tamanhos de negócios, conta associada e data prevista de fechamento. Você pode visualizar seu pipeline de vendas em um layout kanban.
+
+### Notas
+
+O objeto `Notes` armazena anotações em formato livre que podem ser anexadas a Pessoas, Empresas, Oportunidades e outros registros. Use anotações para registrar resumos de reuniões, detalhes importantes ou qualquer informação contextual.
+
+### Tarefas
+
+O objeto `Tasks` armazena tarefas e itens de ação. As tarefas podem ser vinculadas a Pessoas, Empresas, Oportunidades e outros registros. Acompanhe prazos, responsáveis e status de conclusão para manter o controle dos seus acompanhamentos.
+
+## Objetos personalizados
+
+Objetos personalizados permitem armazenar informações únicas para sua organização que os objetos padrão não podem acomodar. Por exemplo, se você é a SpaceX, pode querer criar um objeto personalizado para Foguetes e Lançamentos.
+
+<img src="/images/user-guide/objects/custom-objects.png" style={{width:'100%'}} />
+
+### Criando um novo objeto personalizado
+
+Para criar um novo objeto personalizado:
+
+1. Vá para Configurações na barra lateral esquerda.
+2. Na Área de Trabalho, vá para o Modelo de Dados. Aqui você poderá ver uma visão geral de todos os seus objetos Padrão e Personalizados existentes (ativos e desativados).
+
+<VimeoEmbed videoId="926288174" title="Demonstração em vídeo" />
+
+3. Clique em `+ Novo objeto` no topo. Digite o nome (tanto no singular quanto no plural), escolha um ícone e adicione uma descrição para o seu objeto personalizado e clique em Salvar (no canto superior direito). Usando Listagem como exemplo de objeto personalizado, o singular seria "listagem" e o plural seria "listagens", juntamente com uma descrição como "Listagens que anfitriões criaram para exibir sua propriedade."
+4. Seu objeto personalizado foi criado e aparecerá na sua barra lateral. Você já pode começar a adicionar registros a ele.
+
+## Gerenciando objetos
+
+### Desativando objetos
+
+Se você não precisar de um objeto padrão ou personalizado:
+
+1. Vá para Configurações → Modelo de Dados
+2. Encontre o objeto que deseja desativar e clique nele
+3. Ir para a guia **Configurações** do objeto
+4. Clique no botão `Desativar`
+5. O objeto ficará oculto no seu espaço de trabalho, mas os dados serão preservados
+
+### Reativando objetos
+
+Para restaurar um objeto desativado:
+
+1. Vá para Configurações → Modelo de Dados
+2. Ativar filtro `Desativado`
+3. Procure por objetos desativados (eles têm `desativado` ao lado de seu nome)
+4. Clique em 'se' e, em seguida, em 'Ativar' para reativá-lo
+5. O objeto e todos os seus dados serão restaurados
+
+## Melhores Práticas
+
+### Quando criar objetos personalizados
+
+* **Entidades de negócio exclusivas**: Itens específicos do seu setor ou processo
+* **Relações complexas**: Quando você precisa acompanhar conexões entre várias entidades
+* **Dados escaláveis**: Quando você pode ter muitas instâncias de algo
+
+### Quando usar campos em vez de objetos
+
+* **Atributos simples**: Propriedades que descrevem objetos existentes
+* **Categorias ou rótulos**: Formas de classificar registros existentes
+* **Valores únicos**: Informações que não precisam de um ciclo de vida próprio
+
+### Nomenclatura de objetos
+
+* **Use nomes claros e descritivos**: Torne óbvio o que o objeto representa
+* **Siga convenções**: Use singular para o nome do objeto e plural para a coleção
+* **Considere sua equipe**: Escolha nomes que todos entendam

packages/twenty-docs/l/pt/user-guide/data-model/capabilities/relation-fields.mdx

@@ -0,0 +1,94 @@
+---
+title: Campos de Relação
+description: Ligue registos entre diferentes objetos usando campos de relação.
+---
+
+## Tipos de Relações
+
+### Um-para-Muitos
+
+Um registo no Objeto A pode estar ligado a muitos registos no Objeto B.
+
+**Exemplo:** Uma Empresa pode ter muitas Pessoas (colaboradores).
+
+### Muitos-para-Um
+
+Muitos registos no Objeto A podem estar ligados a um registo no Objeto B.
+
+**Exemplo:** Muitas Pessoas podem pertencer a uma Empresa.
+
+### Relações com Múltiplos Tipos de Objeto
+
+Alguns objetos podem ligar-se a vários tipos de objeto de um dos lados da relação.
+
+**Exemplo:** Uma Nota pode ser anexada a uma Pessoa E a uma Empresa E a uma Oportunidade em simultâneo. A Nota está no lado "muitos", ligando-se a vários lados "um".
+
+<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
+
+De forma semelhante, um Projeto (do lado "um") pode receber ligações de várias Pessoas, várias Empresas e várias Notas.
+
+<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
+
+<Warning>
+**Limitação de Importação/Exportação**: Relações que apontam para vários tipos de objeto ainda não são suportadas para importação/exportação CSV. Isto está no nosso roadmap.
+</Warning>
+
+### Muitos-para-Muitos
+
+Muitos registos no Objeto A podem estar ligados a muitos registos no Objeto B.
+
+**Exemplo:** Muitas Pessoas podem estar ligadas a muitos Projetos e vice-versa.
+
+As relações muitos-para-muitos utilizam um padrão de **objeto de junção**: um objeto intermediário que conecta ambos os lados. Com o recurso de relação de junção, Twenty exibe diretamente os registros finais vinculados, ocultando o objeto intermediário da IU.
+
+<Warning>
+**Recurso beta**: As relações de junção devem ser ativadas em **Configurações → Comunidade → Recursos** antes do uso.
+</Warning>
+
+Consulte [Como criar relações muitos-para-muitos](/l/pt/user-guide/data-model/how-tos/create-many-to-many-relations) para um guia passo a passo completo.
+
+## Criar um Campo de Relação
+
+1. Vá a **Definições → Modelo de Dados**
+2. Selecione o objeto onde pretende adicionar a relação
+3. Clique em **+ Novo campo**
+4. Selecione **Relação** como o tipo de campo
+5. Escolha o(s) objeto(s) de destino a relacionar
+6. Configure as definições da relação:
+   * **Nome do campo no objeto de origem**: O nome do campo de relação no objeto que está a editar
+   * **Nome do campo no objeto de destino**: O nome do campo de relação que aparecerá no objeto de destino
+   * Tipo de relação (um-para-muitos, muitos-para-um)
+7. Clique em **Salvar**
+
+## Relações Padrão
+
+O Twenty inclui relações pré-criadas entre objetos padrão:
+
+| Objeto de Origem | Objeto de Destino | Tipo de Relação |
+| ---------------- | ----------------- | --------------- |
+| Pessoas          | Empresas          | Muitos-para-Um  |
+| Oportunidades    | Empresas          | Muitos-para-Um  |
+| Oportunidades    | Pessoas           | Muitos-para-Um  |
+
+## Melhores Práticas
+
+### Planear Relações
+
+* **Mapeie o seu modelo de dados**: Planeie as relações antes de as criar
+* **Considere a direção**: Pense em que objeto "detém" a relação
+* **Evite dependências circulares**: Mantenha o seu modelo de dados limpo
+
+### Nomear Relações
+
+* **Use nomes claros**: Torne óbvio o que a relação representa
+* **Seja consistente**: Utilize padrões de nomenclatura semelhantes em todas as relações
+* **Considere ambos os lados**: Nomeie adequadamente ambos os lados da relação
+
+### Desempenho
+
+* **Não exagere nas relações**: Relações em excesso podem abrandar o seu espaço de trabalho
+
+## Limitações
+
+* **Eliminar relações** remove a ligação mas não os registos relacionados
+* **Relações circulares** devem ser evitadas para garantir a integridade dos dados

packages/twenty-docs/l/pt/user-guide/data-model/how-tos/create-custom-fields.mdx

@@ -0,0 +1,72 @@
+---
+title: Criar Campos Personalizados
+description: Guia passo a passo para adicionar campos personalizados a qualquer objeto.
+---
+
+Os campos personalizados permitem capturar informações específicas do seu negócio. Adicione-os a qualquer objeto — padrão ou personalizado.
+
+## Etapas
+
+1. Vá a **Definições → Modelo de Dados**
+2. Selecione o objeto ao qual pretende adicionar um campo
+3. Clique **+ Novo Campo**
+4. Escolha um **tipo de campo** (consulte [Campos](/l/pt/user-guide/data-model/capabilities/fields) para ver todos os tipos)
+5. Introduza o **nome do campo** e uma descrição opcional
+6. Configure definições específicas do campo (ver abaixo)
+7. Clique em **Salvar**
+
+**Método rápido:** Clique em **+** no final dos cabeçalhos de coluna em qualquer visualização de tabela → **Personalizar campos**.
+
+## Mostrar o campo nas visualizações
+
+Novos campos não são visíveis automaticamente. Para exibir:
+
+1. Abra a visualização de tabela do objeto
+2. Clique em **Opções → Campos**
+3. Clique no **ícone de olho** ao lado do seu campo para mostrá-lo
+4. Arraste para reordenar
+
+## Opções de Configuração
+
+### Para Seleção / Seleção múltipla
+
+1. Clique em **+ Adicionar opção** para criar opções
+2. Defina uma **opção predefinida** se desejar
+3. Arraste para reordenar as opções
+
+<Note>
+**Use nomes de API para importações.** Ative o **modo Avançado** em Definições para ver os nomes de API. Consulte [Mapeamento de Campos](/l/pt/user-guide/data-migration/capabilities/field-mapping).
+</Note>
+
+### Para Campos de Moeda
+
+Defina a **moeda predefinida** (USD, EUR, etc.) para novos registos.
+
+### Para Campos de Telefone
+
+Defina o **código de país predefinido** para preencher automaticamente novos números de telefone.
+
+### Tornar um Campo Único
+
+Ative a opção **Único** para impedir valores duplicados entre registos.
+
+<Note>
+Se existirem duplicados (incluindo em registos eliminados), ocorrerá um erro. Elimine os duplicados primeiro.
+</Note>
+
+### Definir Valores Predefinidos
+
+Para campos de Seleção, pode escolher qual opção é pré-selecionada para novos registos. Para campos de Caixa de seleção, defina se fica marcado ou desmarcado por predefinição.
+
+## Desativar um Campo
+
+1. Vá a **Definições → Modelo de Dados**
+2. Localize o campo
+3. Clique em **⋮ → Desativar**
+
+Os dados são preservados. Pode reativar ou eliminar permanentemente mais tarde.
+
+## Relacionados
+
+* [Campos](/l/pt/user-guide/data-model/capabilities/fields) — todos os tipos de campo explicados
+* [Perguntas frequentes sobre o modelo de dados](/l/pt/user-guide/data-model/how-tos/data-model-faq) — perguntas comuns

packages/twenty-docs/l/pt/user-guide/data-model/how-tos/create-custom-objects.mdx

@@ -0,0 +1,51 @@
+---
+title: Criar Objetos Personalizados
+description: Guia passo a passo para criar objetos personalizados no Twenty.
+---
+
+Objetos personalizados permitem armazenar informações exclusivas do seu negócio que os objetos padrão não cobrem. Por exemplo: Projetos, Produtos, Tickets ou Listagens.
+
+<Note>
+**Não tem a certeza se precisa de um objeto ou de um campo?** Consulte [Compreender o seu modelo de dados](/l/pt/user-guide/data-model/overview) para orientação.
+</Note>
+
+## Etapas
+
+1. Vá a **Definições → Modelo de Dados**
+2. Clique **+ Adicionar objeto**
+3. Preencha:
+   * **Nome no singular** (por exemplo, "Listagem")
+   * **Nome no plural** (por exemplo, "Listagens")
+   * **Ícone**
+   * **Descrição** (opcional)
+4. Clique em **Salvar**
+
+O seu objeto aparece imediatamente na barra lateral.
+
+## A seguir: Adicionar campos
+
+Novos objetos começam com campos básicos. Adicione campos personalizados para capturar os dados de que precisa:
+
+1. Em **Definições → Modelo de Dados**, selecione o seu objeto
+2. Clique **+ Novo Campo**
+3. Escolha um tipo de campo, configure e guarde
+
+Consulte [Como criar campos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-fields) para obter detalhes sobre os tipos de campo e a configuração.
+
+## Ligar a outros objetos
+
+Para ligar o seu objeto a Pessoas, Empresas ou outros objetos, crie um campo de relação. Consulte [Como criar campos de relação](/l/pt/user-guide/data-model/how-tos/create-relation-fields).
+
+## Desativar um objeto
+
+Se já não precisar de um objeto:
+
+1. Vá para **Configurações → Modelo de dados → objeto de sua escolha → configurações**
+2. Clique no botão **Desativar**
+
+O objeto fica oculto, mas os dados são preservados. Pode reativar ou eliminar permanentemente mais tarde.
+
+## Relacionados
+
+* [Objetos](/l/pt/user-guide/data-model/capabilities/objects) — objetos padrão vs. personalizados
+* [Perguntas frequentes sobre o modelo de dados](/l/pt/user-guide/data-model/how-tos/data-model-faq) — perguntas comuns

packages/twenty-docs/l/pt/user-guide/data-model/how-tos/create-many-to-many-relations.mdx

@@ -0,0 +1,175 @@
+---
+title: Criar Relações Muitos-para-muitos
+description: Conecte registros em que muitos itens de ambos os lados podem ser vinculados usando objetos de junção.
+---
+
+Relações muitos-para-muitos permitem conectar vários registros em ambos os lados. Por exemplo: muitas Pessoas podem trabalhar em muitos Projetos, e cada Projeto pode ter muitas Pessoas.
+
+<Warning>
+**Recurso Beta**: As relações de junção estão atualmente em beta. Ative-as em **Settings → Community → Features** antes de seguir este guia.
+</Warning>
+
+<Note>
+Este recurso também requer que o **Modo Avançado** esteja ativado (alternador no canto inferior esquerdo de Settings).
+</Note>
+
+## Quando Usar Muitos-para-Muitos
+
+Use muitos-para-muitos quando ambos os lados de uma relação podem ter múltiplas conexões:
+
+| Relação              | Exemplo                                                                               |
+| -------------------- | ------------------------------------------------------------------------------------- |
+| Pessoas ↔ Projetos   | Uma pessoa trabalha em vários projetos; um projeto tem vários membros da equipe       |
+| Empresas ↔ Etiquetas | Uma empresa pode ter várias etiquetas; uma etiqueta pode se aplicar a várias empresas |
+| Produtos ↔ Pedidos   | Um produto pode estar em vários pedidos; um pedido contém vários produtos             |
+
+## Como Funciona
+
+A Twenty usa um padrão de **objeto de junção** para relações muitos-para-muitos. Um objeto de junção fica entre dois objetos e mantém as conexões:
+
+```
+People ←→ Project Assignments ←→ Projects
+```
+
+O objeto **Atribuições de Projeto** (junção) tem:
+
+* Uma relação com Pessoas (muitos-para-um)
+* Uma relação com Projetos (muitos-para-um)
+
+Ao ativar o alternador de relação de junção, a Twenty exibe os registros vinculados diretamente em vez de mostrar os registros intermediários de junção.
+
+## Pré-requisitos
+
+1. **Ative Relações de Junção em Recursos Beta**: Vá para **Settings → Community → Features** e ative **Junction Relations**
+2. **Ative o Modo Avançado**: Ative o **Modo Avançado** no canto inferior esquerdo da barra lateral de Settings
+3. Planeje seu modelo de dados:
+   * Quais dois objetos você está conectando?
+   * Qual deve ser o nome do objeto de junção?
+
+## Etapa 1: Criar o Objeto de Junção
+
+Primeiro, crie o objeto intermediário que manterá as conexões.
+
+1. Vá a **Definições → Modelo de Dados**
+2. Clique **+ Adicionar objeto**
+3. Dê um nome descritivo (por exemplo, "Atribuição de Projeto", "Membro da Equipe", "Pedido de Produto")
+4. Ative a opção "Ignorar a criação de um campo Nome"
+
+<img src="/images/user-guide/fields/new-pivot-object.png" alt="Novo objeto pivô" />
+
+5. Clique em **Salvar**
+
+<Tip>
+**Convenção de nomenclatura**: Use um nome que descreva a relação, como "Atribuição de Projeto" ou "Participação na Equipe". Isso torna o modelo de dados mais fácil de entender.
+</Tip>
+
+## Etapa 2: Crie relações entre os objetos e o objeto de junção
+
+Adicione campos de relação de cada um dos seus dois objetos ao objeto de junção.
+
+### Primeira Relação (Objeto A → Junção)
+
+1. Selecione seu primeiro objeto em **Settings → Data Model**
+2. Clique em **+ Adicionar relação**
+3. Selecione o objeto de junção (por exemplo, "Atribuições de Projeto")
+4. Defina o tipo de relação como **Um-para-muitos** (uma pessoa pode se vincular a muitas atribuições)
+5. Nomeie os campos:
+   * Campo em Pessoas: por exemplo, "Atribuições de Projeto"
+   * Campo na junção: por exemplo, "Pessoa"
+6. Clique em **Salvar**
+
+### Segunda Relação (Objeto B → Junção)
+
+1. Selecione seu segundo objeto em **Settings → Data Model**
+2. Clique em **+ Adicionar relação**
+3. Selecione o objeto de junção (por exemplo, "Atribuições de Projeto")
+4. Defina o tipo de relação como **Um-para-muitos** (um projeto pode se vincular a muitas atribuições)
+5. Ative **"Esta é uma relação com um objeto de junção"**
+
+<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}} />
+
+6. Nomeie os campos:
+   * Campo na junção: por exemplo, "Projeto"
+   * Campo em Projetos: por exemplo, "Membros da Equipe"
+7. Clique em **Salvar**
+
+## Etapa 3: Configurar a Exibição da Relação de Junção
+
+Agora configure os objetos de origem para exibir diretamente os registros vinculados, ignorando o objeto de junção intermediário.
+
+1. Vá a **Definições → Modelo de Dados**
+2. Selecione o primeiro objeto (por exemplo, "Pessoas")
+3. Encontre o campo de relação apontando para o objeto de junção (por exemplo, "Atribuições de Projeto")
+4. Clique para editar o campo
+5. Ative **"Esta é uma relação com um objeto de junção"**
+6. Selecione a **Relação de destino** (por exemplo, "Projeto" — o campo na junção que aponta para o outro lado)
+7. Clique em **Salvar**
+
+## Resultado
+
+Após a configuração:
+
+* Em um registro de **Pessoa**, o campo "Atribuições de Projeto" exibe **Projetos** diretamente (não registros de atribuição)
+* Em um registro de **Projeto**, o campo "Membros da Equipe" exibe **Pessoas** diretamente
+
+O objeto de junção ainda existe e armazena as conexões, mas a interface apresenta uma visualização muitos-para-muitos mais limpa.
+
+## Exemplo: Pessoas ↔ Projetos
+
+Aqui está um passo a passo completo:
+
+### Criar o Objeto de Junção
+
+* Nome: **Atribuição de Projeto**
+* Descrição: "Vincula pessoas aos projetos em que trabalham"
+
+### Adicionar Relações
+
+1. **Pessoas → Atribuição de Projeto**
+   * Tipo: Um-para-muitos
+   * Campo em Pessoas: "Atribuições de Projeto"
+   * Campo em Atribuição: "Pessoa"
+
+2. **Projetos → Atribuição de Projeto**
+   * Tipo: Um-para-muitos
+   * Campo em Projetos: "Membros da Equipe"
+   * Campo em Atribuição: "Projeto"
+
+### Configurar Exibição de Junção
+
+1. No objeto **Pessoas**:
+   * Edite o campo "Atribuições de Projeto"
+   * Ative o alternador de junção
+   * Destino: "Projeto"
+
+2. No objeto **Projetos**:
+   * Edite o campo "Membros da Equipe"
+   * Ative o alternador de junção
+   * Destino: "Pessoa"
+
+### Use
+
+* Abra um registro de Pessoa → Veja seus Projetos diretamente
+* Abra um registro de Projeto → Veja os membros da equipe diretamente
+* Crie novas conexões de qualquer um dos lados
+
+## Adicionando Dados Extras às Conexões
+
+Como o objeto de junção é um objeto real, você pode adicionar campos personalizados para armazenar informações sobre a relação:
+
+* **Função**: "Desenvolvedor", "Designer", "Gerente"
+* **Data de Início**: Quando a pessoa entrou no projeto
+* **Horas Alocadas**: Horas semanais neste projeto
+
+Para acessar esses dados, navegue diretamente até o objeto de junção ou consulte-o via API.
+
+## Limitações
+
+* **Importação/Exportação CSV**: A importação de relações muitos-para-muitos diretamente não é suportada. Em vez disso, importe registros para o objeto de junção.
+* **Filtros**: A filtragem por relações muitos-para-muitos pode ter opções limitadas.
+
+## Relacionados
+
+* [Campos de Relação](/l/pt/user-guide/data-model/capabilities/relation-fields) — tipos de relação explicados
+* [Criar Objetos Personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-objects) — como criar objetos
+* [Criar Campos de Relação](/l/pt/user-guide/data-model/how-tos/create-relation-fields) — configuração básica de relação

packages/twenty-docs/l/pt/user-guide/data-model/how-tos/create-relation-fields.mdx

@@ -0,0 +1,70 @@
+---
+title: Criar Campos de Relação
+description: Guia passo a passo para conectar objetos com campos de relação.
+---
+
+Campos de relação conectam registros de objetos diferentes — por exemplo, vinculando Pessoas a Empresas.
+
+<Note>
+**Os nomes das relações não podem ser alterados após a criação** (eles afetam a API). Planeje os nomes com cuidado.
+</Note>
+
+## Antes de Começar
+
+Decida:
+
+* Quais objetos você está conectando? (por exemplo, Pessoas → Empresas)
+* Qual é o lado "um"? (por exemplo, Empresa)
+* Qual é o lado "muitos"? (por exemplo, Pessoas — muitas pessoas trabalham em uma empresa)
+* Como o campo deve ser nomeado em cada lado?
+
+Veja [Campos de relação](/l/pt/user-guide/data-model/capabilities/relation-fields) para entender os tipos de relação.
+
+## Etapas
+
+1. Vá para **Configurações → Modelo de Dados**
+2. Selecione o objeto no qual você deseja a relação (normalmente o lado "muitos")
+3. Clique em **+ Novo campo**
+4. Selecione **Relação** como o tipo de campo
+5. Escolha o **objeto de destino**
+6. Selecione **Um-para-muitos** ou **Muitos-para-um**
+7. Insira os nomes dos campos para **ambos os lados** da relação
+8. Clique em **Salvar**
+
+## Exemplo: Pessoas → Empresas
+
+* Vá para **Configurações → Modelo de Dados → Pessoas**
+* Adicione um campo de Relação
+* Destino: **Empresas**
+* Tipo: **Muitos-para-um**
+* Campo em Pessoas: **Empresa**
+* Campo em Empresas: **Funcionários**
+
+Agora, cada Pessoa pode ser vinculada a uma Empresa, e cada Empresa mostra suas Pessoas.
+
+## Desativando uma Relação
+
+1. Vá para **Configurações → Modelo de dados → objeto de sua escolha**
+2. Encontre o campo de relação e clique nele
+3. Clique no botão **Desativar**
+
+Os vínculos são preservados, mas ficam ocultos. Reative para restaurar.
+
+<Note>
+**Desativar uma relação não exclui registros.** Apenas o vínculo entre eles é removido.
+</Note>
+
+## Excluindo uma Relação
+
+1. Vá para **Configurações → Modelo de dados → objeto de sua escolha**
+2. Encontre o campo de relação e clique nele
+3. Clique no botão **Excluir**
+
+<Note>
+Aplica-se apenas a relações personalizadas. Relações padrão só podem ser desativadas.
+</Note>
+
+## Relacionados
+
+* [Campos de relação](/l/pt/user-guide/data-model/capabilities/relation-fields) — tipos e limitações
+* [Como importar relações](/l/pt/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) — importar em massa registros vinculados

packages/twenty-docs/l/pt/user-guide/data-model/how-tos/customize-your-data-model.mdx

@@ -0,0 +1,22 @@
+---
+title: Personalize seu modelo de dados
+description: Visão geral das opções de personalização do modelo de dados.
+---
+
+O modelo de dados da Twenty é totalmente personalizável. Crie objetos, campos e relações para se adequar à sua empresa.
+
+## Links rápidos
+
+| Eu quero...                  | Guia                                                                                      |
+| ---------------------------- | ----------------------------------------------------------------------------------------- |
+| Criar um novo objeto         | [Como criar objetos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-objects) |
+| Adicionar campos a um objeto | [Como criar campos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-fields)   |
+| Conectar objetos entre si    | [Como criar campos de relação](/l/pt/user-guide/data-model/how-tos/create-relation-fields)     |
+
+## Saiba mais
+
+* [Compreendendo seu modelo de dados](/l/pt/user-guide/data-model/overview) — conceitos-chave e dicas de planejamento
+* [Objetos](/l/pt/user-guide/data-model/capabilities/objects) — objetos padrão vs. personalizados
+* [Campos](/l/pt/user-guide/data-model/capabilities/fields) — todos os tipos de campo
+* [Campos de relação](/l/pt/user-guide/data-model/capabilities/relation-fields) — conectando objetos
+* [Perguntas frequentes sobre o modelo de dados](/l/pt/user-guide/data-model/how-tos/data-model-faq) — perguntas comuns

packages/twenty-docs/l/pt/user-guide/data-model/how-tos/data-model-faq.mdx

@@ -0,0 +1,157 @@
+---
+title: Modelo de Dados FAQ
+description: Perguntas frequentes sobre o modelo de dados do Twenty.
+---
+
+## Gestão de Objetos
+
+<AccordionGroup>
+<Accordion title="Posso excluir um objeto personalizado?">
+Sim, objetos personalizados podem ser excluídos. Você também pode desativá-los primeiro, o que oculta o objeto e seus dados da interface, preservando os dados.
+</Accordion>
+
+<Accordion title="Posso excluir objetos padrão (Pessoas, Empresas, etc.)?">
+Não, os objetos padrão não podem ser excluídos. Você só pode desativá-los, o que os oculta da interface, mas preserva os dados.
+</Accordion>
+
+<Accordion title="Quantos objetos personalizados posso criar?">
+Você pode criar quantos objetos e campos personalizados precisar — o preço não muda.
+</Accordion>
+
+<Accordion title="Posso renomear um objeto padrão?">
+Você pode renomear o rótulo dos objetos padrão (Pessoas, Empresas, Oportunidades), mas não seus nomes de API. Os nomes de API são fixos para manter a consistência em todos os espaços de trabalho do Twenty.
+</Accordion>
+
+<Accordion title="Posso alterar o ícone de um objeto?">
+Sim, você pode alterar o ícone tanto de objetos padrão quanto personalizados em **Settings → Data Model**.
+</Accordion>
+
+<Accordion title="Posso reordenar objetos na barra de navegação esquerda?">
+Ainda não. A ordenação de objetos na navegação é atualmente fixa, mas esse recurso está previsto para uma versão futura.
+</Accordion>
+
+<Accordion title="Posso ocultar objetos da barra de navegação esquerda?">
+Todos os objetos ativos aparecem na navegação. Você pode desativar objetos que não precisa em **Configurações → Modelo de Dados**.
+</Accordion>
+</AccordionGroup>
+
+## Capacidades de Campos
+
+<AccordionGroup>
+<Accordion title="Posso alterar o tipo de um campo após a criação?">
+Não, os tipos de campo não podem ser alterados após a criação. Se você precisar de um tipo diferente, crie um novo campo com o tipo correto, migre seus dados e, em seguida, desative o campo antigo.
+</Accordion>
+
+<Accordion title="Por que preciso de nomes diferentes no singular e plural?">
+Nossa API GraphQL usa ambas as formas para diferentes operações:
+* `createPerson` (singular) para ações de registro único
+* `createPeople` (plural) para operações em massa
+
+Isto cria limitações quando as formas singular e plural são as mesmas, mas melhora a experiência do desenvolvedor.
+</Accordion>
+
+<Accordion title="Por que alguns nomes de campos são protegidos?">
+Certos nomes de campos como `Tipo` ou `Aplicação` são reservados para uso do sistema. Escolha nomes alternativos como `Categoria` ou `Classificação`.
+</Accordion>
+
+<Accordion title="O que acontece quando eu desativo um campo?">
+* O campo fica oculto na interface
+* Os dados existentes são preservados
+* Você ainda pode acessar o campo via API
+* As relações existentes permanecem, mas você não pode criar novas
+* Você pode reativar o campo mais tarde
+</Accordion>
+
+<Accordion title="Posso tornar um campo obrigatório?">
+Atualmente, não é possível tornar campos personalizados obrigatórios. Todos os campos aceitam valores vazios. Você pode usar fluxos de trabalho para impor campos obrigatórios, enviando alertas ou bloqueando ações quando os campos estiverem vazios.
+</Accordion>
+
+<Accordion title="Qual é a diferença entre único e obrigatório?">
+* **Único**: dois registros não podem ter o mesmo valor neste campo
+* **Obrigatório**: o campo deve ter um valor (atualmente não é suportado para campos personalizados)
+</Accordion>
+
+<Accordion title="Posso criar campos de fórmula?">
+Campos de fórmula estão chegando em **H2 2026**. Enquanto isso, você pode usar fluxos de trabalho para calcular e atualizar valores de campos automaticamente.
+</Accordion>
+
+<Accordion title="Posso ter campos aninhados nos meus objetos?">
+Campos aninhados estão vindo em **H2 2026**. Atualmente, você pode usar fluxos de trabalho para trazer valores de campos de objetos relacionados. Por exemplo, para exibir a indústria de uma empresa em um registro de Pessoa, crie um campo personalizado em Pessoas e use um fluxo de trabalho para sincronizar o valor.
+</Accordion>
+
+<Accordion title="Posso reordenar campos em objetos?">
+Sim, vá para Configurações → Modelo de dados → objeto de sua escolha → Layout e clique em **Personalizar página de registro**. Se este botão estiver desativado, você deve criar um registro.
+</Accordion>
+</AccordionGroup>
+
+## Relações
+
+<AccordionGroup>
+<Accordion title="Posso ter uma relação apontando para o mesmo objeto?">
+Sim! Relações autorreferenciadas são suportadas e recomendadas para casos de uso como hierarquias de contas. Por exemplo, crie uma relação de Empresas para Empresas para acompanhar contas pai/filho.
+</Accordion>
+
+<Accordion title="Posso criar relacionamentos muitos-para-muitos?">
+Relações entre muitíssimas estão chegando em **H2 2026**. Atualmente, crie um objeto intermediário com dois relacionamentos de um-para-muitos como uma solução alternativa.
+
+Por exemplo, para vincular Pessoas e Projetos (muitos-para-muitos), crie um objeto "Atribuições de Projeto" com:
+* Uma relação com Pessoas (muitas atribuições → uma pessoa)
+* Uma relação com Projetos (muitas atribuições → um projeto)
+</Accordion>
+
+<Accordion title="O que são relações com múltiplos tipos de objeto (relações Morph)?">
+Essas relações permitem que um objeto se relacione com vários tipos de objeto diferentes por meio de um único campo. Por exemplo, Notas podem ser anexadas a Pessoas E Empresas E Oportunidades simultaneamente.
+
+Cada Nota está vinculada a uma Pessoa, uma Empresa e uma Oportunidade ao mesmo tempo.
+
+Saiba mais em [Campos de relação](/l/pt/user-guide/data-model/capabilities/relation-fields).
+</Accordion>
+
+<Accordion title="Posso ter várias relações entre os mesmos objetos?">
+Sim, você pode criar várias relações entre os mesmos dois objetos. Por exemplo, uma Empresa poderia ter tanto uma relação "Contato Principal" quanto "Contato de Cobrança" com Pessoas.
+</Accordion>
+
+<Accordion title="O que acontece com as relações quando eu excluo um registro?">
+Quando você exclui um registro, o vínculo da relação é removido dos registros relacionados. Os próprios registros relacionados não são excluídos.
+</Accordion>
+
+<Accordion title="Posso criar relações circulares?">
+Apesar de tecnicamente possíveis, relações circulares (A → B → C → A) devem ser evitadas, pois podem causar confusão e possíveis problemas de desempenho.
+</Accordion>
+</AccordionGroup>
+
+## Acesso e Permissões
+
+<AccordionGroup>
+<Accordion title="Onde posso ver e editar meu modelo de dados?">
+Acesse **Settings → Data Model** para visualizar e editar todos os seus objetos e campos.
+</Accordion>
+
+<Accordion title="Por que não posso ver o Modelo de Dados em Configurações?">
+Entre em contato com o administrador do seu espaço de trabalho. O acesso ao modelo de dados é geralmente restrito apenas aos administradores.
+</Accordion>
+</AccordionGroup>
+
+## Gerenciamento de dados
+
+<AccordionGroup>
+<Accordion title="Existe um limite para quantos registros posso ter?">
+Não há um limite rígido para a quantidade de registros. No entanto, conjuntos de dados muito grandes podem impactar o desempenho em algumas visualizações. Use filtros e visualizações para gerenciar grandes conjuntos de dados com eficiência.
+</Accordion>
+
+<Accordion title="Posso importar dados para objetos personalizados?">
+Sim, você pode importar dados CSV para qualquer objeto, incluindo objetos personalizados. O processo de importação oferece suporte ao mapeamento de campos para campos personalizados. Consulte [Como preparar seus arquivos CSV](/l/pt/user-guide/data-migration/how-tos/prepare-your-csv-files).
+</Accordion>
+
+<Accordion title="Posso exportar minha configuração do modelo de dados?">
+Atualmente, não há exportação nativa para a configuração do modelo de dados. Entre em contato com o suporte se você precisar migrar seu modelo de dados entre espaços de trabalho.
+</Accordion>
+
+<Accordion title="Quantos campos um único objeto pode ter?">
+O número máximo de campos que um único objeto pode ter é de 1600 campos como limites por Postgres, incluindo campos existentes e excluídos. Esteja ciente de que Vinte não vão consertar sua área de trabalho se o limite de 1600 campos for atingido, conforme se enquadra em nossa política de Uso Justo.
+</Accordion>
+</AccordionGroup>
+
+## Precisa de mais ajuda?
+
+Confira nossos [Serviços de implementação](/l/pt/user-guide/getting-started/capabilities/implementation-services) para obter ajuda com o design de modelos de dados complexos.

packages/twenty-docs/l/pt/user-guide/data-model/overview.mdx

@@ -0,0 +1,177 @@
+---
+title: Modelo de dados
+description: Saiba o que é um modelo de dados e como projetar um que se ajuste ao seu negócio.
+---
+
+## O que é um modelo de dados?
+
+Um modelo de dados é a estrutura que define como as informações são organizadas em seu CRM. Pense nisso como a **planta** dos dados dos seus clientes — você o projeta uma vez e depois o preenche com seus dados reais.
+
+## Conceitos principais
+
+### Objetos
+
+**Objetos** são as principais categorias de dados no seu CRM. Cada objeto representa um tipo de coisa que você quer acompanhar.
+
+O Twenty vem com objetos padrão:
+
+* **Pessoas** — indivíduos (contatos, leads, parceiros)
+* **Empresas** — organizações
+* **Oportunidades** — negócios ou vendas
+* **Anotações** — notas anexadas aos registros
+* **Tarefas** — afazeres vinculados aos registros
+
+Você também pode criar **objetos personalizados** para qualquer coisa específica do seu negócio (por exemplo, Projetos, Assinaturas, Eventos).
+
+### Campos
+
+**Campos** são as propriedades ou atributos que descrevem cada objeto. Eles armazenam as informações reais.
+
+Por exemplo, o objeto **Pessoas** tem campos como:
+
+* Nome
+* E-mail
+* Telefone
+* Título do Emprego
+* Empresa (uma relação com o objeto Empresas)
+
+Os campos têm diferentes **tipos**: texto, número, data, seleção, seleção múltipla, relação e muito mais. Você pode adicionar campos personalizados a qualquer objeto.
+
+### Registros
+
+**Registros** são as entradas individuais dentro de um objeto — os dados reais que você cria e gerencia.
+
+Por exemplo:
+
+* "John Smith" é um **registro** no objeto Pessoas
+* "Acme Corp" é um **registro** no objeto Empresas
+
+**Uma analogia:**
+
+| Conceito do Modelo de Dados | Analogia do mundo real                     |
+| --------------------------- | ------------------------------------------ |
+| **Objetos**                 | Seções em um livro (as categorias)         |
+| **Campos**                  | Colunas em uma planilha (as propriedades)  |
+| **Registros**               | Linhas em uma planilha (as entradas reais) |
+
+Você projeta o modelo de dados (objetos + campos) uma vez e, em seguida, cria muitos registros dentro dessa estrutura.
+
+## Por que personalizar seu modelo de dados?
+
+Cada empresa trabalha de maneira diferente. Personalizar seu modelo de dados significa que você pode moldar o Twenty em torno dos **seus** processos, em vez de forçar os seus a caber em um sistema rígido.
+
+O Twenty oferece total flexibilidade:
+
+* Crie quantos objetos personalizados precisar
+* Adicione um número ilimitado de campos personalizados
+* O preço não muda com base na personalização
+
+## Dicas para projetar seu modelo de dados
+
+### 1. Comece com seus objetos principais
+
+Identifique os principais conceitos com os quais você trabalha. O Twenty já oferece:
+
+* **Pessoas** — seus contatos
+* **Empresas** — suas contas
+* **Oportunidades** — seus negócios
+
+Pense no que mais você pode precisar:
+
+* Stripe precisaria de um objeto `Subscriptions`
+* Airbnb precisaria de um objeto `Trips`
+* Uma aceleradora precisaria de um objeto `Batches`
+
+### 2. Use campos para variações, não novos objetos
+
+Se algo for apenas uma característica de um objeto existente, faça dele um **campo**.
+
+**Use campos para:**
+
+* Categorias e rótulos (por exemplo, `Industry` para Empresas)
+* Valores de status (por exemplo, `Stage` para Oportunidades)
+* Atributos e propriedades
+
+### 3. Crie um objeto quando ele se sustentar por si só
+
+Se o conceito tem seu próprio ciclo de vida, propriedades ou relacionamentos, ele merece um objeto.
+
+**Crie um objeto para:**
+
+* **Projetos** — têm prazos, responsáveis e tarefas
+* **Assinaturas** — conectam empresas, produtos e faturas
+* **Eventos** — envolvem participantes e ações de acompanhamento
+
+Estes vão além de um único campo, pois carregam seus próprios dados e relações.
+
+### 4. Crie um objeto quando os registros forem em quantidade indefinida
+
+Se algo puder ser vinculado várias vezes e você não souber quantas vezes, use um objeto.
+
+**Abordagem ruim:**
+Criar campos como `Product 1`, `Product 2`, `Product 3`...
+
+**Boa abordagem:**
+Crie um objeto `Products` e relacione-o aos registros. Dessa forma, você pode suportar um, dois ou cem produtos sem alterar seu modelo.
+
+### 5. Mantenha simples no início
+
+Comece pelos campos. Passe para novos objetos apenas quando perceber as limitações:
+
+* Muitos campos em um único objeto
+* Registros repetidos que deveriam ser separados
+* Relacionamentos que não se encaixam bem
+
+## Nota especial sobre Pessoas, Empresas e Oportunidades
+
+<Warning>
+**A sincronização de e-mail e calendário funciona apenas com Pessoas, Empresas e Oportunidades.**
+
+Estes são os únicos objetos nos quais você pode acessar e-mails e reuniões sincronizados da sua caixa de entrada/calendário. Recomendamos usá-los o máximo possível.
+</Warning>
+
+**Melhores Práticas:**
+
+* Se você precisar de categorias de Pessoas, use campos (não novos objetos)
+* Exemplo: Use um campo `Person Type` com os valores "Prospecto" e "Parceiro" em vez de criar objetos separados
+* Crie **exibições** diferentes para filtrar: uma mostrando parceiros, outra mostrando prospectos
+
+**Não há problema em ter campos que não se apliquem a todos os registros.** Por exemplo, um campo `Referral Link` em Pessoas que só se aplica quando `Person Type = Partner`. Oculte esse campo das exibições onde ele não for relevante.
+
+## Perguntas para guiar sua escolha
+
+Pergunte a si mesmo:
+
+<Check>É apenas uma propriedade de algo que já tenho, ou precisa ter suas próprias propriedades?</Check>
+<Check>Alguma vez precisarei acompanhar vários desses por registro, sem saber quantos de antemão?</Check>
+<Check>Este conceito se conecta a vários objetos diferentes, não apenas a um?</Check>
+<Check>Terá seu próprio ciclo de vida (estágios, datas de início/fim)?</Check>
+
+Se a resposta for "sim" para uma ou mais dessas, provavelmente é hora de um novo objeto.
+
+## Acessando seu Modelo de Dados
+
+1. Acesse **Configurações** na barra lateral esquerda
+2. Clique em **Modelo de Dados**
+3. Veja todos os seus objetos (padrões e personalizados)
+4. Clique em qualquer objeto para ver e editar seus campos
+
+<Note>
+**Não vê o Modelo de Dados em Configurações?**
+
+O acesso ao modelo de dados é geralmente restrito apenas aos administradores. Entre em contato com o administrador do seu espaço de trabalho se precisar de acesso.
+</Note>
+
+## Próximos Passos
+
+Depois de planejar seu modelo de dados:
+
+* [Como criar objetos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-objects)
+* [Como criar campos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-fields)
+* [Como criar campos de relação](/l/pt/user-guide/data-model/how-tos/create-relation-fields)
+
+## Precisa de ajuda?
+
+<Tip>
+  Quer ajuda para projetar seu modelo de dados? [Encontre um Vinte Parceiro certificado](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-data-model) para projetar e construir seus objetos, campos e relacionamentos.
+</Tip>

packages/twenty-docs/l/pt/user-guide/getting-started/capabilities/glossary.mdx

@@ -0,0 +1,104 @@
+---
+title: Glossário
+description: Familiarize-se com a terminologia essencial usada no Twenty.
+---
+
+## API
+
+API (Interface de Programação de Aplicações) permite que você conecte o Twenty com outros sistemas de software e construa integrações personalizadas.
+
+## Aplicativos
+
+Os aplicativos são extensões personalizadas escritas em código que podem definir modelos de dados e funções de lógica. Eles permitem que desenvolvedores criem personalizações reutilizáveis que podem ser implantadas em vários espaços de trabalho.
+
+## Ações de código
+
+As Ações de código são etapas de fluxo de trabalho que permitem escrever JavaScript personalizado para transformar dados, realizar cálculos ou executar lógica complexa que não é possível com as ações integradas.
+
+## Menu de Comandos
+
+O Menu de Comandos é uma interface de acesso rápido (aberta com `Cmd + K` no Mac e `Ctrl + K` no Windows) que permite realizar ações, criar registros e navegar no seu espaço de trabalho de forma eficiente.
+
+## Empresa e Pessoas
+
+O CRM tem dois tipos fundamentais de registros:
+
+* Uma `Empresa` representa um negócio ou organização.
+* `Pessoas` representam os atuais e potenciais clientes ou contatos da sua empresa.
+
+## Campos Personalizados
+
+Campos Personalizados são campos de dados que você cria para capturar informações específicas das necessidades e processos do seu negócio.
+
+## Modelo de dados
+
+Um Modelo de Dados é a estrutura que define como a informação é organizada no seu CRM, incluindo quais objetos existem, suas propriedades (campos) e como se relacionam entre si.
+
+## Favoritos
+
+Favoritos são registros que você marcou para acesso rápido, aparecendo na sua barra lateral para navegação instantânea a dados importantes.
+
+## Campo
+
+Um campo refere-se a uma área específica onde dados particulares são armazenados para uma entidade.
+
+## Iterador
+
+O Iterator é uma ação de fluxo de trabalho que percorre um array de itens, executando as ações subsequentes para cada item da lista.
+
+## Kanban
+
+Um `Kanban` é uma maneira visual de rastrear os seus processos de negócios usando cartões e colunas. Cada coluna representa um estágio em seu processo (por exemplo: novo, em andamento, ganho, perdido) e você move os registros através desses estágios conforme eles progridem.
+
+## Objeto
+
+Um Objeto é uma estrutura de dados que representa um tipo específico de entidade no seu CRM (como Pessoas, Empresas ou Oportunidades). Objetos podem ser padrão (pré-construídos) ou personalizados (criados por você).
+
+## Oportunidades
+
+Oportunidades no Twenty CRM são potenciais negócios ou vendas com contas ou contatos.
+
+## Registro
+
+Um registro é uma instância de um objeto, como uma conta ou contato específico.
+
+## Campos de Relação
+
+Campos de Relação criam conexões entre diferentes objetos, permitindo que você vincule registros juntos (como conectar uma Pessoa a uma Empresa).
+
+## Campos Padrão
+
+Campos Padrão são campos de dados pré-construídos que vêm com objetos por padrão e oferecem funcionalidades comuns em todos os espaços de trabalho.
+
+## Tarefas
+
+Tarefas no Twenty CRM são atividades atribuídas relacionadas a contatos, contas ou oportunidades.
+
+## Disparadores
+
+Os gatilhos são o ponto de partida de um fluxo de trabalho — o evento ou condição que inicia a automação. Exemplos incluem a criação de registros, atualizações de registros, webhooks ou horários agendados.
+
+## Visualizações
+
+Você pode personalizar a exibição dos seus registros usando visualizações, definindo diferentes filtros, layouts e opções de ordenação para cada visualização.
+
+## Upsert
+
+Upsert é uma operação que combina "update" e "insert" — atualiza um registro existente se for encontrada uma correspondência, ou cria um novo registro se nenhuma correspondência existir.
+
+## Webhooks
+
+Webhooks são mensagens automáticas enviadas do Twenty a outras aplicações quando eventos específicos ocorrem, permitindo a sincronização de dados em tempo real.
+
+## Fluxos de trabalho
+
+Fluxos de trabalho são processos automatizados que desencadeiam ações com base em condições específicas, ajudando você a automatizar tarefas repetitivas e processos de negócios.
+
+## Espaço de trabalho
+
+Um `Espaço de Trabalho` normalmente representa uma empresa usando o Twenty. Ele contém todos os registros e dados que você e os membros da sua equipe adicionam ao Twenty.
+Ele tem um único nome de domínio, que normalmente é o nome de domínio que sua empresa usa para endereços de e-mail de funcionários.
+
+## Membros do Espaço de Trabalho
+
+Membros do Espaço de Trabalho são os usuários do Twenty da sua equipe que têm acesso ao seu espaço de trabalho. Eles podem ser designados como proprietários ou responsáveis por registros.

packages/twenty-docs/l/pt/user-guide/getting-started/capabilities/implementation-services.mdx

@@ -0,0 +1,17 @@
+---
+title: Serviços de Implementação
+description: Se você precisa de ajuda para começar ou para criar personalizações avançadas, temos uma solução.
+---
+
+## Parceiros de Implementação
+
+Trabalhe com parceiros certificados do Twenty para personalizações e integrações avançadas, e suporte dedicado à implementação.
+
+<CardGroup cols={2}>
+  <Card title="Explorar parceiros certificados" icon="magnifying-glass" href="https://twenty.com/partners/list?ref=docs-implementation-services">
+    Encontre um parceiro e entre em contato diretamente — filtre por região, idioma e especialização.
+  </Card>
+  <Card title="Seja conectado pela Twenty" icon="envelope" href="mailto:contact@twenty.com">
+    Conte-nos do que você precisa e nós conectaremos você ao parceiro certo.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/pt/user-guide/getting-started/capabilities/what-is-twenty.mdx

@@ -0,0 +1,42 @@
+---
+title: O que é Twenty
+description: O Twenty é um CRM de código aberto que oferece os blocos de construção para criar exatamente o que a sua empresa precisa.
+---
+
+## Visão
+
+Criar um bom CRM é difícil porque é um ato de equilíbrio.
+Para cada empresa, os requisitos parecem simples, mas as necessidades de cada um são distintas.
+O resultado é um CRM que é muito básico ou que tenta ser um faz-tudo, mas não se destaca em nada.
+
+À primeira vista, o Twenty parece como a maioria dos CRMs que você já conhece: você pode acompanhar negócios, organizar contatos, gerenciar tarefas e anotações.
+**Mas o que o diferencia é nossa abordagem à extensibilidade. Estamos construindo uma plataforma aberta que fornece os blocos de construção para você resolver seus problemas de negócios únicos.**
+
+Priorizamos princípios universais e padrões comuns sobre listas de funcionalidades.
+Não tentamos ter todas as respostas e, em vez disso, capacitamos os usuários a encontrar o que funciona melhor para eles.
+O código aberto é a base da nossa abordagem, garantindo que o Twenty evolua com sua comunidade, para sua comunidade.
+
+## Benefícios
+
+**Personalizável:** Projetado para atender às suas necessidades de negócios.
+
+**Guiado pela Comunidade:** Construído e mantido por uma grande comunidade de código aberto.
+
+**Custo-benefício:** Você nunca ficará preso a um fornecedor, porque você sempre pode hospedar por conta própria.
+
+## Principais Características
+
+* **Calendário e E-mails:** Sincronize sua caixa de entrada e calendário para ver todas as comunicações nos seus registros do CRM. [Saiba mais](/l/pt/user-guide/calendar-emails/overview).
+* **Modelo de Dados:** Crie objetos e campos personalizados para atender aos seus processos de negócios específicos. [Explorar](/l/pt/user-guide/data-model/overview).
+* **Migração de Dados:** Importe e exporte seus dados via CSV ou API. [Comece](/l/pt/user-guide/data-migration/overview).
+* **Visualizações e Pipelines:** Organize seus dados com visualizações em tabela, quadros kanban e pipelines de vendas. [Descubra](/l/pt/user-guide/views-pipelines/overview).
+* **Fluxos de Trabalho:** Automatize seus processos de negócios e integre com ferramentas externas. [Crie automações](/l/pt/user-guide/workflows/overview).
+* **IA:** Aprimore seu CRM com recursos e agentes com tecnologia de IA. [Explorar IA](/l/pt/user-guide/ai/overview).
+* **Painéis:** Acompanhe o desempenho com relatórios personalizados e visualizações personalizadas. [Ver painéis](/l/pt/user-guide/dashboards/overview).
+* **Permissões e Acesso:** Controle quem pode visualizar, editar e gerenciar seus dados com permissões baseadas em funções. [Configurar acesso](/l/pt/user-guide/permissions-access/overview).
+* **Notas e Tarefas:** Crie notas e tarefas vinculadas aos seus registros para uma melhor colaboração.
+* **API e Webhooks:** Conecte-se a outros aplicativos e crie integrações personalizadas. [Comece a integrar](/l/pt/developers/extend/api).
+
+## Participe agora
+
+[Registre-se aqui](https://app.twenty.com) ou [torne-se um colaborador no GitHub](https://github.com/twentyhq/twenty).

packages/twenty-docs/l/pt/user-guide/getting-started/how-tos/configure-your-workspace.mdx

@@ -0,0 +1,77 @@
+---
+title: Configure o seu Espaço de Trabalho
+description: Cada empresa trabalha de maneira diferente. Comece com estas 3 etapas para adaptar o Twenty às suas necessidades.
+---
+
+<Note>**Ganho Rápido**: Comece conectando sua caixa de correio. Isso lhe dá um valor imediato e ajuda sua equipe a ver o Twenty em ação com dados reais. Você pode fazer isso em Configurações → Contas.</Note>
+
+## 1. Personalize seu modelo de dados
+
+O Twenty oferece a flexibilidade que você precisa para moldar o modelo de dados que melhor dará suporte ao seu dia a dia.
+Crie objetos e campos de qualquer tipo, incluindo relações entre seus diferentes objetos. Você pode fazer isso em Configurações → Modelo de Dados.
+Aqui estão algumas dicas:
+
+* **Você não é limitado no número de campos personalizados ou objetos personalizados**. Adicionar objetos e campos personalizados não resultará em uma atualização do seu plano.
+* **Pessoas, Empresas e Oportunidades são os três objetos a partir dos quais você pode acessar os e-mails e as reuniões sincronizados da sua caixa de correio e do seu calendário**. Recomendamos usar esses o máximo possível, adicionando campos para categorizar seus registros, se necessário. Aqui está um exemplo:
+  * É melhor usar o objeto Pessoas para suas perspectivas e parceiros, criando um campo no objeto Pessoas chamado `Pessoa Type`, ao invés de criar um objeto personalizado para Parceiros, por que você não seria capaz de acessar os e-mails trocados com esta pessoa dos registros de Parceiros.
+  * Crie diferentes visualizações em Pessoas, uma para exibir parceiros e outra para exibir prospectos.
+* Duas Pessoas não podem ter o mesmo endereço de e-mail. Duas Empresas não podem ter o mesmo domínio.
+* Você pode desativar campos e objetos padrão que não deseja usar.
+* Você pode ocultar campos das visualizações: não tenha medo de criar campos, você não terá que exibir todos.
+
+Leia [este artigo](/l/pt/user-guide/data-model/overview) para aprender como projetar seu modelo de dados.
+
+## 2. Traga seus dados
+
+Trazer seus dados existentes para o Twenty dá à sua equipe contexto desde o início.
+
+### Conecte sua caixa de correio
+
+Se você não fez isso ao criar seu espaço de trabalho, conecte sua **conta do Google ou Microsoft** em Configurações → Contas. Isso permite que o Twenty:
+
+* Importe suas mensagens e reuniões
+* Crie automaticamente contatos com base em interações (opcional)
+* Mantenha o histórico de comunicação visível para sua equipe
+
+**Usando outro provedor?**
+Você pode adicionar outra caixa de correio via SMTP ou outro calendário via CalDAV. Vá para **Configurações → Contas** para configurar.
+
+### Importar dados via CSV
+
+Use o menu de Comando (`Cmd + K` ou `Ctrl + K`) para importar Pessoas, Empresas, Oportunidades ou qualquer objeto personalizado via CSV.
+
+**Diretrizes principais**:
+
+* Baixe o arquivo de exemplo para entender o formato esperado
+* Limite cada arquivo a 10k registros
+* Remova e-mails duplicados para Pessoas ou domínios duplicados para Empresas
+* Revise e corrija erros (destacados em amarelo) antes de importar
+
+Leia [este artigo](/l/pt/user-guide/data-migration/overview) para saber mais sobre importação de dados.
+
+## 3. Crie sua primeira visualização
+
+Criar visualizações diferentes é a chave para tornar os dados disponíveis para sua equipe.
+Aqui está como proceder:
+
+* **Adicionar ou ocultar colunas**
+  Gerenciar os campos visíveis na determinada visualização clicando em Opções → Campos (da parte superior direita). Você pode mostrar/ocultar campos a partir daí.
+
+* **Reordenar campos**
+  Reordenar os campos a partir de uma determinada visualização clicando em Opções → Campos (da parte superior direita). Arraste e solte os campos para reordená-los.
+
+* **Filtre sua visualização**
+  Restrinja os registros exibidos usando os Filtros no canto superior direito.
+
+* **Ordene registros**
+  Reorganize os registros exibidos usando a função Ordenar no canto superior direito, ou clicando diretamente no nome da coluna.
+
+* **Escolha o layout**
+  Você pode alternar para um layout **Kanban** ou um layout de lista **Agrupar Por**, desde que o objeto tenha um campo tipo select `Estágio` ou similar.
+
+* **Salve sua visualização como Favoritos**
+  Isso pode ser feito usando o menu suspenso que mostra as diferentes visualizações.
+
+## O que vem depois?
+
+Comece a criar automações usando [workflows](/l/pt/user-guide/workflows/overview).

packages/twenty-docs/l/pt/user-guide/getting-started/how-tos/create-workspace.mdx

@@ -0,0 +1,48 @@
+---
+title: Criar Espaço de Trabalho
+description: Siga um guia passo a passo sobre como se registrar na Twenty, escolher um plano de assinatura e configurar sua conta.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Passo 1: Registro
+
+1. Navegue até [Cadastro Twenty](https://app.twenty.com).
+2. Selecione o método de inscrição de sua preferência:
+   * **Continuar com Google** para registro com conta do Google.
+   * **Continuar com Microsoft** para registro com conta da Microsoft.
+   * Ou, **Continue com o e-mail** para o registro de e-mail.
+
+<VimeoEmbed videoId="927066829" title="Demonstração em vídeo" />
+
+## Passo 2: Escolhendo um Período de Avaliação
+
+Escolha entre dois períodos de avaliação:
+
+### 30 dias
+
+Com cartão de crédito
+
+### 7 dias
+
+Sem cartão de crédito
+
+Ambos os testes incluem:
+
+* Acesso total
+* Contactos ilimitados
+* Integração de e-mail
+* Objetos personalizados
+* API e Webhooks
+
+Você pode clicar em "Mudar plano" para escolher um plano ou intervalo de faturamento diferente.
+
+<img src="/images/user-guide/create-workspace/choose-plan.png" style={{width:'100%'}} />
+
+## Passo 3: Confirmação de Pagamento e Configuração de Conta
+
+Após a aprovação do pagamento via Stripe, você será direcionado para criar o seu projeto e perfil de usuário. Lembre-se de que você pode cancelar sua assinatura a qualquer momento.
+
+## Suporte
+
+Para dúvidas ou ajuda, conecte-se com a equipe de suporte dedicada em [contact@twenty.com](mailto:contact@twenty.com) ou envie uma mensagem no [Discord](https://discord.gg/cx5n4Jzs57).

packages/twenty-docs/l/pt/user-guide/getting-started/how-tos/navigate-around-twenty.mdx

@@ -0,0 +1,84 @@
+---
+title: Navegue pelo Twenty
+description: Obtenha uma visão geral rápida de como navegar pela plataforma e onde realizar diferentes tipos de ações.
+---
+
+## O Layout Principal
+
+O centro da tela é **onde seus registros estão**: pessoas, empresas, oportunidades, tarefas, notas, painéis, fluxos de trabalho e qualquer outro objeto que você criou. É aqui que o trabalho diário acontece.
+Você pode **visualizar, editar ou excluir registros** a partir daqui, bem como **criar novas visualizações**.
+
+<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
+
+## Barra de Navegação
+
+Do lado esquerdo, de cima para baixo, você poderá:
+
+* Alternar entre seus **diversos espaços de trabalho** usando o menu suspenso ou criar um novo espaço de trabalho
+* Usar a **barra de pesquisa** (pressionar `/` para focar nela instantaneamente)
+* Abrir a seção de **Configurações**
+* Tenha acesso direto às suas **visualizações favoritas**. Os favoritos são exclusivos para cada usuário.
+* Alternar entre diferentes objetos
+* **Criar automações** usando fluxos de trabalho
+
+<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
+
+## Menu de Comandos
+
+O menu de comandos oferece **acesso rápido a ações** no Twenty. Você pode acessá-lo de duas maneiras:
+
+* **Atalho de teclado**: Pressione `Cmd + K` (Mac) ou `Ctrl + K` (Windows)
+* **Mouse**: Clique nos três pontos no canto superior direito
+  A partir daí, você pode:
+* Criar novos registros
+* **Importar e exportar dados via CSV**
+* Criar novas visualizações
+* Acessar registros excluídos (Twenty dá suporte a exclusões lógicas e permanentes)
+* Ver os atalhos de teclado para acessar rapidamente objetos no seu espaço de trabalho
+
+<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
+
+## Barra de Pesquisa
+
+A barra de pesquisa é acessível pelo Menu de Comandos, no topo da sua barra de navegação, ou pressionando `/` para focar nela instantaneamente. A pesquisa funciona em todos os objetos.
+
+<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
+
+## Painel Lateral
+
+Quando você clica em um registro, o painel lateral aparece à direita. Isso oferece uma visão geral rápida das informações principais do registro, sem levá-lo a outra página. A partir daí, você pode decidir fechar essa visão geral ou obter informações adicionais sobre esse registro, clicando no botão Abrir.
+
+<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
+
+## Visualizações
+
+Todos os objetos (como Oportunidades ou Pessoas) suportam várias visualizações. Você não está limitado no número de visualizações por objeto.
+
+Use o menu suspenso no canto superior esquerdo do layout principal para alternar entre as diferentes visualizações. Por exemplo:
+
+* Usar uma visualização Kanban para rastrear oportunidades por estágio
+* Usar a visualização Agrupar Por para criar seções e melhorar a eficiência
+* Use filtros para focar em registros específicos (por exemplo, leads criados na semana passada)
+* Salvar visualizações filtradas para reutilizá-las mais tarde
+* Visualizações favoritas para acesso rápido
+
+<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
+
+Se você é novo em Visualizações, leia nosso [Guia de Visualizações e Pipelines](/l/pt/user-guide/views-pipelines/overview) para aprender a criá-las e personalizá-las.
+
+## Configurações
+
+Abra suas Configurações no canto superior esquerdo para:
+
+* **Conectar suas contas de e-mail e calendário** para sincronização fluida de e-mails e calendários
+* Personalizar seu **modelo de dados**: criar objetos personalizados, campos e relações
+* **Acessar o playground da API e configurar webhooks**
+* **Gerenciar permissões de usuário** e controles de acesso ao espaço de trabalho
+* Convidar membros da equipe e gerenciar funções dos usuários
+* Editar seu perfil e preferências do espaço de trabalho
+* Configurar faturamento e monitorar o uso de créditos de fluxo de trabalho
+* Descubra e ative recursos futuros (em Atualizações → Acesso Antecipado)
+* **Acesse o Suporte** para entrar em contato via chat ao vivo
+* **Abra a Documentação** para navegar pelo Guia do Usuário e pela documentação para desenvolvedores
+
+<Note>Se você não ver todas essas seções nas Configurações, entre em contato com o administrador do seu espaço de trabalho — algumas seções têm acesso restrito.</Note>

packages/twenty-docs/l/pt/user-guide/introduction.mdx

@@ -0,0 +1,58 @@
+---
+title: Guia do Usuário
+description: Bem-vindo ao Guia do Usuário do Twenty, sua fonte para configurações avançadas e melhores práticas.
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+<CardGroup cols={3}>
+  <Card href="/l/pt/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
+    <CardTitle>Modelo de Dados</CardTitle>
+    Personalize seu modelo de dados para se adequar aos processos da sua empresa.
+  </Card>
+
+  <Card href="/l/pt/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
+    <CardTitle>Migração de Dados</CardTitle>
+    Importe e exporte seus dados via CSV ou API.
+  </Card>
+
+  <Card href="/l/pt/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
+    <CardTitle>Calendário & E-mails</CardTitle>
+    Centralize as reuniões e os e-mails da sua equipe.
+  </Card>
+
+  <Card href="/l/pt/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
+    <CardTitle>Fluxos de trabalho</CardTitle>
+    Automatize processos e integre com ferramentas externas.
+  </Card>
+
+  <Card href="/l/pt/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
+    <CardTitle>IA</CardTitle>
+    Aprimore sua equipe com agentes de IA.
+  </Card>
+
+  <Card href="/l/pt/user-guide/layout/overview" img="/images/user-guide/halftone/layout.png">
+    <CardTitle>Layout</CardTitle>
+    Navegação, visualizações e personalização da página de registro.
+  </Card>
+
+  <Card href="/l/pt/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
+    <CardTitle>Painéis</CardTitle>
+    Insights em tempo real para acompanhar o desempenho.
+  </Card>
+
+  <Card href="/l/pt/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
+    Gerencie papéis e o acesso ao Twenty.
+  </Card>
+
+  <Card href="/l/pt/user-guide/billing/overview" img="/images/user-guide/halftone/billing.png">
+    <CardTitle>Faturamento</CardTitle>
+    Entenda como funcionam os preços e o faturamento do Twenty.
+  </Card>
+
+  <Card href="/l/pt/user-guide/settings/overview" img="/images/user-guide/halftone/settings.png">
+    <CardTitle>Configurações</CardTitle>
+    Configure as preferências do seu espaço de trabalho.
+  </Card>
+
+</CardGroup>

packages/twenty-docs/l/pt/user-guide/layout/capabilities/navigation.mdx

@@ -0,0 +1,38 @@
+---
+title: Navegação
+description: Personalize a barra lateral esquerda para corresponder à forma como sua equipe trabalha.
+---
+
+A barra lateral esquerda é sua principal forma de navegar pelo Twenty. Ela é totalmente personalizável — você pode reorganizá-la para corresponder ao seu fluxo de trabalho sem acessar nenhuma página de configurações.
+
+## Reordenar itens
+
+Arraste e solte qualquer item na barra lateral para alterar sua posição. A ordem é salva por usuário, para que cada membro da equipe possa organizar sua própria barra lateral.
+
+## Pastas
+
+Agrupe itens relacionados em pastas. Por exemplo, você pode criar uma pasta "Vendas" contendo suas visualizações de pipeline, uma pasta "Suporte" para tickets ou uma pasta "Operações" para objetos internos.
+
+Para criar uma pasta, clique com o botão direito na barra lateral ou use o botão `+`.
+
+## Ocultar objetos
+
+Objetos que você não usa podem ser ocultos da barra lateral. Eles não são excluídos — apenas ficam fora de vista. Você pode exibi-la novamente a qualquer momento em Configurações → Modelo de dados.
+
+## Favoritos
+
+Fixe visualizações, registros ou pesquisas na seção Favoritos no topo da barra lateral para acesso com um clique. Os Favoritos são pessoais — cada usuário gerencia os seus.
+
+## Links personalizados
+
+Adicione links para ferramentas externas diretamente na barra lateral. Útil para vincular ao seu wiki, a painéis em outras ferramentas ou a qualquer URL que sua equipe use regularmente.
+
+## Menu de Comandos
+
+Pressione `Cmd+K` (ou `Ctrl+K`) para abrir o menu de comandos — uma barra de pesquisa de acesso rápido para ir a qualquer registro, visualização ou ação sem navegar pela barra lateral.
+
+## Personalizando a barra lateral
+
+Para personalizar a barra lateral, passe o cursor sobre a seção "Workspace" na barra lateral e clique no ícone de chave inglesa.
+
+<img src="/images/user-guide/layout/navigation-edit-icon.png" alt="Ícone de edição da navegação" />

packages/twenty-docs/l/pt/user-guide/layout/capabilities/record-pages.mdx

@@ -0,0 +1,61 @@
+---
+title: Páginas de Registos
+description: Personalize o layout das páginas de detalhe de registos individuais com abas e widgets.
+---
+
+## Visão Geral
+
+Ao abrir um registo no Twenty, a página de detalhe é composta por **abas** e **widgets**. Ambos são totalmente personalizáveis por tipo de objeto.
+
+## Abas
+
+Cada página de registro pode ter várias abas — como as abas de um navegador. Use-as para organizar diferentes aspectos de um registro. Por exemplo, um registro de Empresa pode ter abas para Visão geral, Comunicação, Tarefas e Arquivos.
+
+Pode:
+
+* Adicionar e remover abas
+* Renomear abas
+* Reordenar abas arrastando
+* Definir qual aba é exibida por padrão
+
+## Widgets
+
+Os widgets são os componentes básicos dentro de cada aba. Tipos de widget disponíveis:
+
+| Widget                     | O que mostra                                           |
+| -------------------------- | ------------------------------------------------------ |
+| **Campos**                 | Campos do registro, agrupados ou individualmente       |
+| **Registros relacionados** | Tabela de registros vinculados por meio de uma relação |
+| **Emails**                 | Histórico de e-mails das contas conectadas             |
+| **Calendário**             | Eventos de calendário associados ao registro           |
+| **Linha do tempo**         | Histórico de atividades e eventos                      |
+| **Tarefas**                | Tarefas associadas                                     |
+| **Notas**                  | Notas em texto enriquecido                             |
+| **Arquivos**               | Anexos de ficheiro                                     |
+| **Gráficos**               | Dados visuais de registros relacionados                |
+| **iFrame**                 | Conteúdo externo incorporado                           |
+| **Texto enriquecido**      | Conteúdo estático ou descrições                        |
+
+## Personalizar uma página de registro
+
+1. Abra qualquer registro
+2. Pressione `Cmd+K` e pesquise por "Edit record page layout"
+
+ou
+
+1. Vá para Configurações → Modelo de dados → objeto de sua escolha → Layout
+
+2. Clique no botão "Personalizar página de registro" para esse objeto
+
+3. Agora você está no modo de personalização:
+   * **Adicionar widgets** no seletor de widgets
+   * **Arraste widgets** para reposicioná-los na grade
+   * **Redimensione os widgets** arrastando suas bordas
+   * **Configure campos** exibidos em cada widget
+   * **Gerencie abas** — adicione, remova, renomeie, reordene
+
+4. Salve suas alterações — elas se aplicam a todos os registros desse tipo de objeto
+
+## Visibilidade de campos
+
+Em um widget de Campos, você pode controlar quais campos ficam visíveis e em que ordem. Isso permite criar layouts focados — por exemplo, mostrar apenas os campos mais importantes na aba Visão geral e colocar os campos detalhados em uma aba separada.

packages/twenty-docs/l/pt/user-guide/layout/overview.mdx

@@ -0,0 +1,45 @@
+---
+title: Layout
+description: Personalize a forma como navega, explora e visualiza registos na Twenty.
+---
+
+O layout da Twenty é personalizável em três níveis: a forma como navega na aplicação, como consulta listas de registos, e o que vê ao abrir um registo individual.
+
+## Navegação
+
+A barra lateral esquerda é totalmente personalizável. Pode:
+
+* **Reordenar itens** arrastando e largando
+* **Criar pastas** para agrupar objetos e vistas
+* **Ocultar objetos** que não utiliza
+* **Adicionar ligações personalizadas** a ferramentas externas
+* **Fixar favoritos** para acesso rápido a vistas, registos ou pesquisas
+
+[Referência de navegação →](/l/pt/user-guide/layout/capabilities/navigation)
+
+## Visualizações
+
+As vistas controlam como as listas de registos são apresentadas. A Twenty suporta três tipos de vista:
+
+| Vista          | Melhor para                                                                                  |
+| -------------- | -------------------------------------------------------------------------------------------- |
+| **Tabela**     | Trabalhar com muitos registos de uma só vez — linhas e colunas ao estilo de folha de cálculo |
+| **Kanban**     | Acompanhamento do pipeline — cartões organizados por etapa, com arrastar e largar            |
+| **Calendário** | Planeamento baseado no tempo — registos apresentados segundo um campo de data                |
+
+Cada vista guarda os seus próprios filtros, ordenação, visibilidade de campos e configuração de agrupamento. As vistas podem ser partilhadas com o espaço de trabalho ou mantidas privadas.
+
+[Vistas de tabela →](/l/pt/user-guide/views-pipelines/capabilities/table-views) · [Vistas Kanban →](/l/pt/user-guide/views-pipelines/capabilities/kanban-views) · [Vista de calendário →](/l/pt/user-guide/views-pipelines/capabilities/calendar-view)
+
+## Páginas de Registos
+
+Ao abrir um registo, a página de detalhes é construída a partir de separadores e widgets configuráveis. Pode:
+
+* **Adicionar, remover e reordenar separadores** em qualquer tipo de registo
+* **Configurar widgets** — campos, registros relacionados, e-mails, linha do tempo, calendário, tarefas, notas, gráficos, gráficos, iFrames e muito mais
+* **Arrastar e redimensionar widgets** num layout em grelha
+* **Controlar a visibilidade dos campos** por widget
+
+Introduza o modo de personalização do layout a partir do menu de comandos (`Cmd+K` → "Editar o layout da página de registo").
+
+[Referência das páginas de registos →](/l/pt/user-guide/layout/capabilities/record-pages)

packages/twenty-docs/l/pt/user-guide/legal/how-tos/legal-faq.mdx

@@ -0,0 +1,125 @@
+---
+title: FAQ Legal
+description: Perguntas legais frequentes.
+---
+
+## Localização de dados e transferências internacionais
+
+<AccordionGroup>
+<Accordion title="Em que país e região nossos dados do espaço de trabalho, anexos, logs e backups seriam armazenados?">
+Vinte nuvem roda em servidores AWS localizados em Frankfurt, Alemanha.
+</Accordion>
+<Accordion title="Será possível fixar a região de hospedagem para a nossa área de trabalho?">
+A seleção da região de hospedagem estará disponível a partir de 2027, inicialmente para novos workspaces. Os usuários poderão solicitar uma alteração de região para um workspace existente em uma data posterior. Como alternativa, você pode entrar em contato com [nossos parceiros](https://twenty.com/partners/list?categories=HOSTING) para ajudá-lo a configurar sua instância.
+</Accordion>
+<Accordion title="Quais subprocessadores podem processar ou acessar nossos dados de CRM, e em que países eles estão localizados?">
+Uma lista de todos os subprocessadores está disponível em [nosso Trust Center](https://trust.twenty.com/?tab=subprocessors).
+</Accordion>
+<Accordion title="Que salvaguardas se aplicam às transferências internacionais de dados?">
+As Cláusulas Contratuais Padrão da UE, juntamente com o adendo do Reino Unido e as emendas suíças, aplicam-se a transferências internacionais de dados para fora da UE, incluindo transferências para todos os subprocessadores.
+</Accordion>
+</AccordionGroup>
+
+## Contrato de processamento de dados e funções legais
+
+<AccordionGroup>
+<Accordion title="Onde podemos encontrar o atual Acordo de Processamento de Dados (DPA)?">
+Você pode gerar seu DPA assinado em https://{your-domain}/settings/legal/dpa (por exemplo, https://getting-started.twenty.com/settings/legal/dpa).
+</Accordion>
+<Accordion title="Vinte atua como processador de dados para informações comerciantes e de contato armazenadas no CRM, enquanto nossa empresa permanece o controlador de dados?">
+De acordo com nossa [Política de Privacidade](https://twenty.com/privacy-policy), 20 atua como o processador de dados para o comerciante e informações de contato armazenadas no CRM, enquanto sua empresa permanece o controlador de dados.
+</Accordion>
+<Accordion title="Conteúdo do CRM já é usado para treinar modelos de IA de vinte ou terceiros?">
+O conteúdo do CRM pode ser usado para treinar modelos de IA, dependendo dos Termos e Condições dos subprocessadores. A Twenty não possui seu próprio modelo de IA — todos os modelos de IA disponíveis no Twenty Cloud são fornecidos por nossos subprocessadores.
+</Accordion>
+<Accordion title="Se o processamento de IA for opcional, pode ser totalmente desativado para a nossa área de trabalho?">
+A IA pode ser totalmente desativada desligando todos os modelos de IA em Settings → AI → Models. Além disso, nenhum dado é enviado para a IA, a menos que você interaja ativamente com o chat de IA ou com um nó de IA em um fluxo de trabalho.
+</Accordion>
+</AccordionGroup>
+
+## Controles de segurança e acesso
+
+<AccordionGroup>
+<Accordion title="A criptografia é usada em trânsito e em repouso? Quais são suas práticas de gerenciamento de chaves e como os dados dos locatários são isolados?">
+Todos os dados são criptografados em trânsito e em repouso. Os dados dos locatários são isolados por meio de uma configuração de esquema por locatário, e as chaves de criptografia são periodicamente rotacionadas.
+</Accordion>
+<Accordion title="Que vinte funcionários ou subprocessadores podem acessar os espaços de trabalho do cliente, para que fins, e como o acesso é aprovado e registrado?">
+As equipas de engenharia e de apoio da Twenty podem aceder aos espaços de trabalho dos clientes para investigar e resolver problemas. Os proprietários dos espaços de trabalho controlam isto: o acesso da equipa de apoio pode ser desativado a qualquer momento em Definições → Geral → Segurança e permanece desativado até que volte a ativá-lo.
+</Accordion>
+<Accordion title="Qual é o seu processo de notificação de incidente e período de notificação alvo após um incidente de segurança confirmado que afeta nossos dados?">
+No caso de uma violação de dados pessoais confirmada afetando seus dados, notificaremos você sem um atraso indevido e em qualquer evento dentro de 48 horas após tomar conhecimento dele. Nossa notificação incluirá, na medida conhecida no momento: a natureza da violação, as categorias e o volume aproximado de dados e indivíduos afectados, consequências prováveis, e as medidas de reparação e mitigação tomadas ou planeadas. Iremos apresentar atualizações à medida que a investigação for avançando.
+</Accordion>
+</AccordionGroup>
+
+## retenção e exclusão de dados
+
+<AccordionGroup>
+<Accordion title="Quando um registro de CRM individual é excluído, quando é removido de sistemas ativos?">
+Quando um registro é excluído, ele é primeiro excluído de forma lógica (soft delete) e ainda pode ser restaurado. Ele é excluído permanentemente e removido dos sistemas ativos assim que o período de retenção expira ou um usuário o destrói manualmente.
+</Accordion>
+<Accordion title="Por quanto tempo os registros excluídos logicamente (soft delete) são mantidos no sistema?">
+Por padrão, os registros excluídos logicamente são mantidos por 14 dias, após os quais são removidos permanentemente do sistema. O período de retenção para registros excluídos logicamente pode ser alterado em Settings → General → Security.
+</Accordion>
+<Accordion title="Por quanto tempo esse registro pode permanecer em backups ou logs técnicos?">
+Um registro removido permanece nos backups por 30 dias, após os quais é excluído permanentemente.
+</Accordion>
+<Accordion title="Quando um espaço de trabalho é fechado ou a exclusão completa é solicitada, qual linha do tempo exata se aplica aos dados de produção, anexos, logs e backups?">
+Quando um espaço de trabalho é eliminado, os respetivos dados são removidos dos sistemas em produção no prazo de aproximadamente 90 dias após a cessação do serviço, e geralmente muito antes. As cópias de segurança e de arquivo são então substituídas ou eliminadas num prazo adicional de 90 dias, após o qual todos os dados são permanentemente apagados. Durante ambos os períodos, os dados ficam isolados de qualquer utilização operacional. Mediante pedido, podemos fornecer uma certificação por escrito assim que a purga estiver concluída. Consulte a cláusula 4.9 do seu Acordo de Tratamento de Dados para conhecer todos os termos.
+</Accordion>
+<Accordion title="Durante qualquer período de retenção de back-retention, são excluídos dados isolados do acesso operacional e usados?">
+Sim, durante qualquer período de retenção de back-retention, dados excluídos são isolados de uso operacional.
+</Accordion>
+<Accordion title="São mantidas categorias de dados mais longas para fins jurídicos, facturações, prevenção de fraudes, segurança ou auditoria? Em caso afirmativo, que categorias e por quanto tempo?">
+Para mais informações sobre a retenção de dados, você pode solicitar nossa Política de Gerenciamento de Dados e Retenção disponível em [nosso Centro de Confiança](https://trust.twenty.com/?tab=documents).
+</Accordion>
+<Accordion title="Será possível confirmar por escrito quando um pedido de exclusão completo foi atendido?">
+Reconhecemos as solicitações de exclusão e fornecemos confirmação por escrito assim que a exclusão for concluída.
+</Accordion>
+</AccordionGroup>
+
+## Backups e resiliência
+
+<AccordionGroup>
+<Accordion title="Quais são a frequência e o período de retenção de backup?">
+Os backups são criados continuamente com snapshots diários, e o período de retenção é de 30 dias.
+</Accordion>
+<Accordion title="Qual é o objetivo de recuperação e o objetivo de recuperação de tempo para vinte nuvens?">
+RTO e RPO são ambos 6 horas (como por nosso DPA).
+</Accordion>
+<Accordion title="Qual é o processo para solicitar ou realizar uma recuperação?">
+Para solicitar uma restauração, entre em contato com nossa equipe via chat de suporte ou pelo endereço [contact@twenty.com](mailto:contact@twenty.com).
+</Accordion>
+<Accordion title="Os backups são criptografados e armazenados na mesma região dos dados primários do espaço de trabalho?">
+Todos os backups são criptografados e armazenados em locais geograficamente separados dentro da mesma jurisdição (por exemplo, dentro da UE para dados da UE).
+</Accordion>
+</AccordionGroup>
+
+## Conformidade
+
+<AccordionGroup>
+<Accordion title="Vinte é compatível com o RGPD?">
+Sim, Vinte é [compatível com o RGPD](https://trust.twenty.com/?tab=securityControls\&frameworks=gdpr_v1).
+</Accordion>
+<Accordion title="Vinte SOC 2 está em conformidade?">
+Sim, vinte é [compatível com o SOC 2](https://trust.twenty.com/?tab=securityControls\&frameworks=soc2_v1).
+</Accordion>
+<Accordion title="Vinte HIPAA é conforme?">
+Não, estão em vias de se tornar conformes com a iniciativa HIPAA.
+</Accordion>
+</AccordionGroup>
+
+## Licenciamento
+
+<AccordionGroup>
+<Accordion title="Se eu alterar o código para adicionar funcionalidades apenas para uso interno da minha equipa, tenho de publicar essas alterações?">
+Não. Executar uma versão modificada para a sua própria equipa não é distribuição, portanto não surge qualquer obrigação de publicação. A cláusula de rede da AGPL aplica-se quando pessoas fora da sua organização interagem com a sua instância modificada através da rede.
+</Accordion>
+<Accordion title="Se eu criar um front end separado e usar Twenty como backend tal como está, tenho de publicar essas alterações?">
+Não. O seu front end é um trabalho próprio e separado, e comunicar com o Twenty através das suas APIs não altera isso. Como o próprio Twenty não é modificado, não há nada a publicar.
+</Accordion>
+<Accordion title="Se eu alterar o código para adicionar funcionalidades para o revender, tenho de publicar essas alterações?">
+Sim, como está a modificar código para o distribuir a terceiros, é obrigado a publicar essas alterações. Se não quiser publicar as suas alterações, pode obter uma licença Organization.
+</Accordion>
+</AccordionGroup>
+
+Se você tiver mais dúvidas, consulte nossos [Termos e Condições](https://twenty.com/terms), nossa [Política de Privacidade](https://twenty.com/privacy-policy) e nosso [Trust Center](https://trust.twenty.com/). Se suas dúvidas ainda não tiverem sido respondidas, envie-as para [contact@twenty.com](mailto:contact@twenty.com) ou via chat de suporte.

packages/twenty-docs/l/pt/user-guide/legal/overview.mdx

@@ -0,0 +1,12 @@
+---
+title: Jurídico
+description: Assuntos relacionados ao jurídico
+---
+
+Consulte nossas [perguntas frequentes](/l/pt/user-guide/legal/how-tos/legal-faq).
+
+## Links úteis
+
+* [Termos e Condições](https://twenty.com/terms)
+* [Política de Privacidade](https://twenty.com/privacy-policy)
+* [Centro de Confiança](https://trust.twenty.com/)

packages/twenty-docs/l/pt/user-guide/permissions-access/capabilities/permissions.mdx

@@ -0,0 +1,213 @@
+---
+title: Permissões
+description: Controle o acesso a objetos, campos e configurações com permissões baseadas em função.
+---
+
+O sistema de permissões do Twenty permite que você controle o acesso a três áreas principais:
+
+* **Objetos e Campos**: Controle quem pode visualizar, editar ou excluir registros e campos individuais
+* **Configurações**: Gerencie o acesso à configuração do espaço de trabalho e funções administrativas
+* **Ações**: Controle ações gerais do espaço de trabalho, como importar dados ou enviar e-mails
+
+## Criar uma Função
+
+Para criar uma nova função:
+
+1. Vá para **Configurações → Membros → Funções**
+2. Em **Todas as Funções**, clique em **+ Criar Função**
+3. Digite um nome para a função
+4. Na aba padrão **Permissões**, [configure as permissões](#customize-permissions)
+5. Clique em **Salvar** para finalizar
+
+## Excluir uma Função
+
+Para excluir uma função:
+
+1. Vá para **Configurações → Membros → Funções**
+2. Clique na função que deseja remover
+3. Abra a aba de **Configurações** e clique em **Excluir Função**
+4. Clique em **Confirmar** no modal
+
+<Note>
+Se uma função for excluída, qualquer membro do espaço de trabalho atribuído a ela será automaticamente reatribuído à função padrão. Todos os cargos, exceto o cargo **Admin**, podem ser excluídos. Deve sempre haver pelo menos um membro atribuído à função **Admin**.
+</Note>
+
+## Atribuir Funções a Membros
+
+### Visualizar Atribuições Atuais
+
+* Vá para **Configurações → Membros → Funções**
+* Veja todas as funções e quantos membros estão atribuídos a cada uma
+* Veja quais membros têm quais funções
+
+### Atribuir uma Função a um Membro
+
+1. Vá para **Configurações → Membros → Funções**
+2. Clique na função que deseja atribuir
+3. Abra a aba de **Atribuição**
+4. Clique em **+ Atribuir a membro**
+5. Selecione o membro do espaço de trabalho da lista
+6. Confirme a atribuição
+
+### Definir Função Padrão
+
+1. Vá para **Configurações → Membros → Funções**
+2. Na seção **Opções**, encontre **Função Padrão**
+3. Selecione qual função novos membros devem receber automaticamente
+4. Novos membros do espaço de trabalho serão atribuídos a essa função ao ingressar
+
+<Note>
+Você só pode atribuir funções a membros existentes do espaço de trabalho. Para convidar novos membros, use [Gestão de Membros](/l/pt/user-guide/settings/capabilities/member-management).
+</Note>
+
+## Personalizar Permissões
+
+As permissões determinam o que cada função pode acessar ou modificar dentro do seu espaço de trabalho, incluindo objetos da área de trabalho, registros, configurações e ações.
+
+### Permissões de Objetos
+
+A seção **Objetos** controla o que esta função pode fazer com registros em todo o seu espaço de trabalho.
+
+#### Definir permissões padrão (Todos os objetos)
+
+Primeiro, configure as permissões básicas que se aplicam a **todos os objetos** por padrão:
+
+| Permissão                                  | Descrição                                                 |
+| ------------------------------------------ | --------------------------------------------------------- |
+| **Ver registros em todos os objetos**      | Visualizar registros em listas e páginas de detalhes      |
+| **Editar registros em todos os objetos**   | Modificar registros existentes                            |
+| **Excluir registros em todos os objetos**  | Excluir registros de forma lógica (podem ser restaurados) |
+| **Destruir registros em todos os objetos** | Excluir registros permanentemente                         |
+
+Selecione ou desmarque com base no que deve ser o comportamento padrão desta função.
+
+<Note>
+**Exemplo — função de Estagiário**: Um estagiário deve poder ver todos os objetos, mas não editá-los por padrão. Ative "Ver registros em todos os objetos", mas deixe "Editar registros em todos os objetos" desmarcado.
+</Note>
+
+#### Adicionar exceções em nível de objeto
+
+Após definir os padrões, use a subseção **Em nível de objeto** para adicionar regras que substituem os padrões para objetos específicos.
+
+Clique em **+ Adicionar regra** e selecione um objeto para criar uma exceção.
+
+**Regras de exemplo para uma função de Estagiário:**
+
+| Regra                                     | Efeito                                                                    |
+| ----------------------------------------- | ------------------------------------------------------------------------- |
+| Oportunidades → desativar "Ver registros" | O estagiário não consegue ver o objeto Oportunidades.                     |
+| Pessoas → ativar "Editar registros"       | O estagiário pode editar registros de Pessoas (mas não de outros objetos) |
+
+### Permissões em Nível de Linha
+
+<Note>
+As permissões em nível de linha são um **recurso Premium** disponível no plano **Organization** (Cloud e Self-Hosted).
+</Note>
+
+As permissões em nível de linha permitem restringir quais registros individuais uma função pode ver ou editar, com base em critérios dinâmicos. Diferente das permissões de objeto (que se aplicam a todo um tipo de objeto), as permissões em nível de linha avaliam cada registro de forma independente.
+
+**Casos de uso de exemplo:**
+
+* Representantes de vendas só podem ver suas próprias oportunidades
+* Gerentes podem ver todos os registros em sua região
+* Agentes de suporte só podem visualizar tickets atribuídos a eles
+
+Para configurar permissões em nível de linha, abra uma função, navegue até a guia **Objects** e use a seção **Row-Level** para definir condições de filtro para um objeto específico.
+
+### Permissões de Campos
+
+Em cada regra em nível de objeto, você pode ir além e configurar **permissões em nível de campo** para controlar o acesso a campos específicos.
+
+| Permissão        | Descrição                      |
+| ---------------- | ------------------------------ |
+| **Ver campo**    | Visualizar o valor do campo    |
+| **Editar campo** | Modificar o valor do campo     |
+| **Sem acesso**   | O campo fica totalmente oculto |
+
+**Exemplo — Restringir campos sensíveis:**
+
+Para a função de Estagiário com acesso de edição em Pessoas, talvez você queira restringir certos campos:
+
+* Pessoas → E-mail → apenas **Ver campo** (não pode editar)
+* Pessoas → Endereço → **Sem acesso** (totalmente oculto)
+
+Isso permite que o estagiário edite a maioria dos campos de Pessoas enquanto protege informações sensíveis.
+
+### Como funciona a herança de permissões
+
+As permissões se propagam do geral para o específico:
+
+1. **Todos os objetos** → define a base para todos os objetos
+2. **Regras em nível de objeto** → substituem a base para objetos específicos
+3. **Regras em nível de campo** → substituem a configuração do objeto para campos específicos
+
+Configurações mais específicas sempre têm precedência.
+
+### Gerenciando Substituições de Permissões
+
+Para substituir permissões herdadas:
+
+1. Clique em **X** para remover a regra herdada
+2. Selecione as permissões específicas que você deseja
+3. Clique no ícone laranja de **Desfazer** (seta circular) para reverter alterações
+
+Quando terminar, clique em **Finalizar**, em seguida, **Salvar** ao redirecionar para a página de função.
+
+### Permissões de Configurações do Espaço de Trabalho
+
+Controle o acesso às configurações do espaço de trabalho de duas maneiras:
+
+* Ative **Acesso Total a Configurações** para conceder acesso total
+* Ou ative permissões específicas (por exemplo, geração de chave API, preferências do espaço de trabalho, atribuição de funções, configuração do modelo de dados, configurações de segurança e gestão de fluxos de trabalho)
+
+<Note>
+**Limitação atual**: O acesso ao gerenciamento de fluxos de trabalho é atualmente necessário para acionar fluxos de trabalho manualmente. Esse comportamento pode mudar em versões futuras.
+</Note>
+
+### Permissões de Ação do Espaço de Trabalho
+
+Controle o acesso a ações gerais do espaço de trabalho:
+
+* Ative **Acesso Total à Aplicação** para conceder permissões totais
+* Ou habilite ações individuais como **Enviar Email**, **Importar CSV** e **Exportar CSV**
+
+## Atribuir Papéis a Chaves de API e Agentes de IA
+
+Além dos membros do espaço de trabalho, funções também podem ser atribuídas a **Chaves de API** e **Agentes de IA**. Isso é particularmente útil para equipes que desejam controlar exatamente "quem" pode fazer o quê em seu espaço de trabalho — incluindo processos automatizados e integrações.
+
+### Por que atribuir funções a chaves de API e agentes de IA?
+
+* **Segurança**: Limite o que os processos automatizados podem acessar ou modificar
+* **Conformidade**: Garanta que as integrações acessem apenas os dados de que precisam
+* **Controle**: Evite alterações acidentais de dados causadas por automações mal configuradas
+* **Auditabilidade**: Acompanhe quais ações foram realizadas por qual integração ou agente
+
+### Atribuir uma função a uma chave de API
+
+1. Vá para **Configurações → Membros → Funções**
+2. Clique na função que deseja atribuir
+3. Abra a aba de **Atribuição**
+4. Em **Chaves de API**, clique em **+ Atribuir à chave de API**
+5. Selecione a chave de API na lista
+6. Confirme a atribuição
+
+A chave de API agora herdará todas as permissões definidas por essa função. Qualquer chamada de API feita com essa chave será restringida de acordo.
+
+<Note>
+Chaves de API sem uma função atribuída usam permissões padrão. Para maior segurança, sempre atribua uma função específica às chaves de API de produção.
+</Note>
+
+### Atribuir uma função a um agente de IA
+
+1. Vá para **Configurações → Membros → Funções**
+2. Clique na função que deseja atribuir
+3. Abra a aba de **Atribuição**
+4. Em **Agentes de IA**, clique em **+ Atribuir ao agente de IA**
+5. Selecione o agente de IA na lista
+6. Confirme a atribuição
+
+O agente de IA só poderá acessar dados e executar ações permitidas pela função que lhe foi atribuída.
+
+<Note>
+Para agentes de IA executados em fluxos de trabalho, isso garante que o agente não possa acessar ou modificar dados fora do seu escopo pretendido — mesmo que o fluxo de trabalho tenha permissões mais amplas.
+</Note>

packages/twenty-docs/l/pt/user-guide/permissions-access/capabilities/sso-configuration.mdx

@@ -0,0 +1,125 @@
+---
+title: Configuração de SSO
+description: Configure o Single Sign-On para autenticação corporativa segura.
+---
+
+## Sobre o SSO
+
+O Single Sign-On (SSO) permite que os membros da sua equipe façam login no Twenty usando o provedor de identidade da sua organização. Isso oferece:
+
+* **Controle de acesso centralizado**: Gerencie o acesso em um único lugar
+* **Segurança aprimorada**: Aproveite suas políticas de segurança existentes
+* **Melhor experiência do usuário**: Um conjunto de credenciais para todas as ferramentas
+
+## Provedores suportados
+
+O Twenty oferece suporte a SSO com:
+
+* **SAML 2.0**: Funciona com a maioria dos provedores de identidade corporativos
+* **Google Workspace**: Para organizações que usam o Google
+* **Microsoft Entra ID** (anteriormente Azure AD): para ambientes Microsoft
+
+## Configurando o SSO
+
+### Pré-requisitos
+
+* Plano da organização (workspaces em nuvem e auto-hospedados)
+* Acesso de administrador ao seu provedor de identidade
+* Acesso de administrador ao seu espaço de trabalho de Vinte
+
+### Etapas de configuração
+
+#### 1. Acesse as configurações de SSO
+
+1. Vá para **Configurações → Segurança**
+2. Encontre a seção **Configuração de SSO**
+3. Clique em **Configurar SSO**
+
+#### 2) Escolha seu provedor
+
+Selecione seu provedor de identidade na lista ou escolha "Custom SAML" para outros provedores.
+
+#### 3. Configure seu provedor de identidade
+
+Você precisará configurar seu provedor de identidade com:
+
+* **ID da Entidade**: Fornecido pelo Twenty
+* **URL ACS**: A URL de retorno para autenticação
+* **Certificado**: Para comunicação segura
+
+#### 4. Insira os detalhes do provedor no Twenty
+
+* **URL de SSO**: URL de login do seu provedor
+* **ID da Entidade**: Identificador do seu provedor
+* **Certificado**: Certificado X.509 do seu provedor
+
+#### 5. Testar e habilitar
+
+1. Clique em **Testar configuração** para verificar a configuração
+2. Ative o SSO quando o teste for bem-sucedido
+3. Configure as preferências de provisionamento de usuários
+
+## Provisionamento de usuários
+
+### Provisionamento Just-in-Time (JIT)
+
+* Os usuários são criados automaticamente no primeiro login
+* Os usuários recebem um papel padrão automaticamente
+* Não é necessário criar usuários manualmente
+
+### Provisionamento manual
+
+* Convide os usuários antes que possam fazer login
+* Pré-atribua funções específicas
+* Mais controle sobre quem pode acessar a área de trabalho
+
+## Gerenciamento de usuários de SSO
+
+### Atribuição de função
+
+Os usuários de SSO podem receber funções como os usuários comuns:
+
+1. Vá para **Configurações → Membros**
+2. Localize o usuário
+3. Altere a função conforme necessário
+
+### Revogação de acesso
+
+Para remover o acesso de usuários de SSO:
+
+* Remova-os do seu provedor de identidade ou
+* Remova-os do workspace do Twenty
+
+## Melhores Práticas
+
+### Segurança
+
+* **Exigir SSO**: Desative o login por senha para usuários de SSO
+* **Auditorias regulares**: Revise o acesso periodicamente
+* **Políticas rígidas do IdP**: Exija MFA no provedor de identidade
+
+### Gerenciamento de usuários
+
+* **Nomenclatura clara**: Use uma nomenclatura consistente do seu diretório
+* **Mapeamento de grupos**: Mapeie os grupos do IdP para as funções do Twenty (se disponível)
+* **Processo de desligamento**: Inclua o Twenty no seu fluxo de trabalho de desprovisionamento
+
+## Resolução de Problemas
+
+### Problemas comuns
+
+* **Erros do certificado**: Certifique-se de que o certificado não expirou
+* **Incompatibilidade de URL**: Verifique se a URL da ACS corresponde exatamente
+* **Usuário não encontrado**: Verifique as configurações de provisionamento JIT
+
+### Obtendo Ajuda
+
+Se você encontrar problemas, contate o suporte com:
+
+* Mensagens de erro recebidas
+* Provedor de identidade utilizado
+* Detalhes da configuração (sem dados sensíveis)
+
+<Tip>
+Precisa de SSO configurado para a sua organização? [Encontre um parceiro Twenty certificado](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-sso) que seja especialista em SSO e configuração de identidade. *(Prefere envolver a Twenty diretamente? [contact@twenty.com](mailto:contact@twenty.com))*
+</Tip>

packages/twenty-docs/l/pt/user-guide/permissions-access/how-tos/permissions-faq.mdx

@@ -0,0 +1,120 @@
+---
+title: Perguntas frequentes sobre permissões
+description: Perguntas frequentes sobre funções e permissões.
+---
+
+## Funções
+
+<AccordionGroup>
+<Accordion title="Quais funções o Twenty traz por padrão?">
+Vinte vem com cargos de **Administrador** e **Membro** por padrão. Você pode criar funções personalizadas adicionais com base nas necessidades da sua equipe (por exemplo, Representante de vendas, Gerente, Usuário somente leitura).
+</Accordion>
+
+<Accordion title="Posso excluir a função Admin?">
+Não, a função Admin não pode ser excluída. Deve sempre haver pelo menos um membro atribuído à função Admin.
+</Accordion>
+
+<Accordion title="O que acontece quando eu excluo uma função?">
+Qualquer membro do espaço de trabalho atribuído a essa função será automaticamente reatribuído à função padrão.
+</Accordion>
+
+<Accordion title="Como defino uma função padrão para novos membros?">
+Vá para **Configurações → Membros → Funções**, encontre a opção **Função Padrão** e selecione qual função os novos membros devem receber automaticamente ao entrar.
+</Accordion>
+
+<Accordion title="Posso atribuir várias funções a um único usuário?">
+Não, cada usuário pode ter apenas uma função por vez. Crie uma função personalizada se precisar de uma combinação de permissões.
+</Accordion>
+</AccordionGroup>
+
+## Permissões
+
+<AccordionGroup>
+<Accordion title="Qual é a diferença entre permissões de objeto e de campo?">
+* **Permissões de objeto**: Controlam o acesso a registros inteiros (por exemplo, ver/editar/excluir registros de Pessoas)
+* **Permissões de campo**: Controlam o acesso a campos específicos dentro de um objeto (por exemplo, ver, mas não editar, o campo Salário)
+
+As permissões de campo permitem um controle mais granular sobre dados confidenciais.
+</Accordion>
+
+<Accordion title="Como funcionam as substituições de permissões?">
+As permissões se propagam do geral para o específico:
+1. **Todos os objetos** define a base para todos os objetos
+2. **Permissões em nível de objeto** podem substituir a configuração global para objetos específicos
+3. **Permissões em nível de campo** podem substituir a configuração do objeto para campos específicos
+
+Configurações mais específicas sempre têm precedência.
+</Accordion>
+
+<Accordion title="O que significam os diferentes níveis de permissão?">
+Para objetos:
+* **Ver registros**: Visualizar registros em listas e páginas de detalhes
+* **Editar registros**: Modificar registros existentes
+* **Excluir registros**: Exclusão lógica de registros (podem ser restaurados)
+* **Destruir registros**: Excluir permanentemente registros
+
+Para campos:
+* **Ver campo**: Visualizar o valor do campo
+* **Editar campo**: Modificar o valor do campo
+* **Sem acesso**: O campo fica totalmente oculto
+</Accordion>
+
+<Accordion title="Posso restringir o acesso a registros específicos (permissões em nível de linha)?">
+As permissões em nível de linha estão disponíveis no plano **Organization**. Isso permite restringir o acesso a registros específicos com base em critérios (por exemplo, ver apenas suas próprias oportunidades).
+</Accordion>
+
+<Accordion title="Como deixar um campo somente leitura para determinados usuários?">
+1. Vá para **Configurações → Membros → Funções**
+2. Selecione a função
+3. Navegue até o objeto que contém o campo
+4. Defina a permissão do campo como **Ver campo** (sem Editar campo)
+</Accordion>
+</AccordionGroup>
+
+## Configurações e Ações
+
+<AccordionGroup>
+<Accordion title="Quais permissões de configuração estão disponíveis?">
+Você pode controlar o acesso a:
+* Geração de chave de API
+* Preferências do espaço de trabalho
+* Atribuição de função
+* Configuração do modelo de dados
+* Configurações de segurança
+* Gerenciamento de fluxos de trabalho
+
+Use **Settings All Access** para conceder acesso total ou habilite permissões específicas.
+</Accordion>
+
+<Accordion title="Quais permissões de ação estão disponíveis?">
+Você pode controlar:
+* **Enviar e-mail**: Capacidade de enviar e-mails a partir do Twenty
+* **Importar CSV**: Capacidade de importar dados via CSV
+* **Exportar CSV**: Capacidade de exportar dados para CSV
+
+Use **Application All Access** para conceder todas as ações ou habilitar ações específicas.
+</Accordion>
+</AccordionGroup>
+
+## SSO
+
+<AccordionGroup>
+<Accordion title="O SSO está disponível em todos os planos?">
+Não, o SSO é um recurso Premium disponível apenas no plano **Organization**.
+</Accordion>
+
+<Accordion title="Quais provedores de identidade são compatíveis?">
+O Twenty é compatível com:
+* **SAML 2.0** (funciona com a maioria dos provedores de identidade corporativos)
+* **Google Workspace**
+* **Microsoft Entra ID** (anteriormente Azure AD)
+</Accordion>
+
+<Accordion title="O que é o provisionamento Just-in-Time (JIT)?">
+Com o provisionamento JIT, as contas de usuário são criadas automaticamente no Twenty quando alguém faz login via SSO pela primeira vez. A função padrão é atribuída automaticamente.
+</Accordion>
+
+<Accordion title="Posso exigir SSO para todos os usuários?">
+Sim, depois que o SSO for configurado, você pode desativar o login por senha para usuários de SSO para impor a autenticação por meio do seu provedor de identidade.
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/pt/user-guide/permissions-access/overview.mdx

@@ -0,0 +1,34 @@
+---
+title: Permissões e Acesso
+description: Gerencie funções, permissões e o controle de acesso no seu espaço de trabalho.
+---
+
+O sistema de permissões do Twenty permite controlar quem pode acessar e modificar dados no seu espaço de trabalho. Crie funções, atribua permissões e configure SSO para um acesso seguro.
+
+## O que há nesta seção
+
+<CardGroup cols={2}>
+  <Card title="Permissões" icon="lock" href="/l/pt/user-guide/permissions-access/capabilities/permissions">
+    Crie funções e configure permissões de objetos, campos e configurações.
+  </Card>
+  <Card title="Configuração do SSO" icon="key" href="/l/pt/user-guide/permissions-access/capabilities/sso-configuration">
+    Configure o Single Sign-On com o seu provedor de identidade.
+  </Card>
+  <Card title="FAQ" icon="circle-question" href="/l/pt/user-guide/permissions-access/how-tos/permissions-faq">
+    Perguntas comuns sobre funções, permissões e SSO.
+  </Card>
+</CardGroup>
+
+## Principais funcionalidades
+
+* **Acesso baseado em funções**: Crie funções personalizadas com permissões específicas
+* **Permissões de objeto**: Controle quem pode visualizar, editar ou excluir registros
+* **Permissões de campo**: Restrinja o acesso a campos sensíveis
+* **Permissões de configuração**: Controle o acesso às configurações do espaço de trabalho
+* **Integração com SSO**: Configure o Single Sign-On para segurança corporativa (plano Organization)
+
+## Links rápidos
+
+* [Crie uma função](/l/pt/user-guide/permissions-access/capabilities/permissions#create-a-role)
+* [Configure o SSO](/l/pt/user-guide/permissions-access/capabilities/sso-configuration)
+* [Gerencie os membros da equipe](/l/pt/user-guide/settings/capabilities/member-management)

packages/twenty-docs/l/pt/user-guide/settings/capabilities/community-settings.mdx

@@ -0,0 +1,36 @@
+---
+title: Configurações da Comunidade
+description: Ative recursos de Acesso antecipado no Twenty.
+---
+
+## Sobre as Configurações da Comunidade
+
+A seção Comunidade permite ativar recursos de Acesso antecipado antes de estarem disponíveis para todos, bem como buscar parceiros da Twenty.
+
+## Recursos de Acesso antecipado
+
+Os recursos de Acesso antecipado são funcionalidades que ainda estão sendo testadas antes da disponibilidade geral.
+
+**Atualmente em Acesso antecipado:**
+
+* **Relações de junção** — Relações muitos-para-muitos
+
+### Como ativar os recursos de Acesso antecipado
+
+1. Vá para **Configurações → Comunidade**
+2. Navegue até a seção **Recursos**
+3. Encontre o recurso que você deseja ativar
+4. Ative a opção
+5. O recurso fica disponível imediatamente
+
+<Note>
+Os recursos de Acesso antecipado podem mudar com base no feedback dos usuários. Seu feedback ajuda a melhorar o Twenty!
+</Note>
+
+## Comentários sobre os recursos
+
+Seu feedback ajuda a melhorar o Twenty:
+
+* Relate problemas com recursos de Acesso antecipado
+* Compartilhe como você está usando os novos recursos
+* Sugira melhorias por meio do [Discord da comunidade](https://discord.gg/cx5n4Jzs57)

packages/twenty-docs/l/pt/user-guide/settings/capabilities/domains-settings.mdx

@@ -0,0 +1,52 @@
+---
+title: Configurações de Domínio
+description: Configure o domínio do espaço de trabalho, os domínios de acesso aprovados e os domínios personalizados do aplicativo.
+---
+
+As configurações de domínio ficam em três lugares, dependendo do que você está configurando.
+
+## Domínio do espaço de trabalho
+
+Configure em **Configurações → Geral**.
+
+Edite o nome do seu subdomínio ou defina um domínio personalizado para o seu espaço de trabalho.
+
+### Personalizar domínio
+
+1. Clique em **Subdomínio** para editar seu subdomínio (ex: `yourcompany.twenty.com`)
+2. Ou clique em **domínio personalizado** para configurar um domínio personalizado (ex.: `crm.yourcompany.com`)
+
+Para domínios personalizados, você precisará configurar as configurações de DNS com o seu provedor de domínio.
+
+## Domínios Aprovados
+
+Configure em **Configurações → Membros → Convite**.
+
+Adicione o domínio da sua empresa para que os membros da equipe se inscrevam neste espaço de trabalho automaticamente.
+
+### Adicionar Domínio de Acesso Aprovado
+
+1. Clique em **Adicionar Domínio de Acesso Aprovado**
+2. Insira o domínio da sua empresa (por exemplo, `yourcompany.com`)
+3. Salvar
+
+Depois de configurado, qualquer pessoa com um endereço de e-mail nesse domínio pode entrar no seu espaço de trabalho sem precisar de um convite direto.
+
+<Note>
+Isso é útil para permitir que toda a sua equipe se registre por conta própria, mantendo o espaço de trabalho restrito à sua organização.
+</Note>
+
+## Domínios Personalizados do Aplicativo
+
+Configure em **Configurações → Aplicativos → seu aplicativo → Configurações → URL do Aplicativo**.
+
+Aplicativos que expõem rotas na web são servidos a partir de uma URL dedicada, exibida na seção **URL do Aplicativo**. Você pode, em vez disso, disponibilizar um aplicativo a partir de um domínio que você possui.
+
+### Adicionar Domínio Personalizado
+
+1. Clique **Domínio personalizado**
+2. Insira o domínio que você deseja usar (por exemplo, `app.yourcompany.com`)
+3. Configure as configurações de DNS conforme as instruções
+4. Verifique o domínio
+
+Somente as rotas desse aplicativo ficam acessíveis nesse domínio. Os certificados SSL são provisionados automaticamente.

packages/twenty-docs/l/pt/user-guide/settings/capabilities/experience-settings.mdx

@@ -0,0 +1,38 @@
+---
+title: Configurações da Experiência
+description: Personalize o tema da sua interface e as preferências regionais.
+---
+
+Personalize a sua experiência no Twenty em **Configurações → Experiência**.
+
+## Aparência
+
+Escolha o seu tema visual:
+
+* **Claro**: Interface limpa e clara
+* **Escuro**: Mais fácil para os olhos em condições de pouca luz
+* **Configurações do sistema**: Combina automaticamente com o tema do seu dispositivo
+
+## Idioma
+
+Selecione o idioma de sua preferência para a interface do Twenty no menu suspenso.
+
+## Formatos
+
+Configure a data, hora, número, fuso horário e dia de início do calendário.
+
+| Configuração                    | Descrição                                                                   |
+| ------------------------------- | --------------------------------------------------------------------------- |
+| **Fuso horário**                | Seu fuso horário local para carimbos de data e hora e agendamentos precisos |
+| **Formato de data**             | Como as datas aparecem (por exemplo, 12 de dez. de 2025)                    |
+| **Formato de hora**             | Formato de 12 horas (7:22 PM) ou de 24 horas                                |
+| **Formato de número**           | Separadores decimais e de milhares (por exemplo, 1.234,56)                  |
+| **Dia de início do calendário** | Primeiro dia da semana (domingo ou segunda-feira)                           |
+
+Cada configuração pode ser definida como **Configurações do sistema** para corresponder automaticamente às preferências do seu dispositivo, ou você pode escolher um formato específico.
+
+## Como atualizar
+
+1. Vá para **Configurações → Experiência**
+2. Ajuste suas preferências em cada seção
+3. As alterações são salvas automaticamente

packages/twenty-docs/l/pt/user-guide/settings/capabilities/member-management.mdx

@@ -0,0 +1,86 @@
+---
+title: Gestão de Membros
+description: Convide membros da equipe e gerencie o acesso ao espaço de trabalho.
+---
+
+Gerencie quem tem acesso ao seu espaço de trabalho em **Configurações → Membros**.
+
+## Convidar Novos Membros
+
+### Usando convite por e-mail
+
+1. Vá para **Configurações → Membros → Convites**
+2. Clique em **+ Convidar**
+3. Insira o endereço de e-mail da pessoa
+4. Selecione uma função para o novo membro
+5. Clique em **Enviar convite**
+
+A pessoa convidada receberá um e-mail com um link para ingressar no seu espaço de trabalho.
+
+### Usando o Link de Convite
+
+1. Vá para **Configurações → Membros → Convites**
+2. Copie o link de convite do espaço de trabalho
+3. Compartilhe o link com novos membros da equipe
+4. Eles terão acesso assim que se inscreverem
+
+## Ver e gerenciar membros
+
+### Ver todos os membros
+
+Vá para **Configurações → Membros → Equipe** para ver todos os membros ativos
+
+Vá para **Configurações → Membros → Convite** para ver convites pendentes
+
+### Editar o perfil de um membro
+
+Clique em um membro para abrir a página de perfil. Como administrador, você pode:
+
+* Editar o **nome**
+* Atualizar a **foto do perfil**
+* **Assumir** a conta do membro (útil para solução de problemas)
+* **Excluir** a conta do membro
+
+### Alterar a função de um membro
+
+Na página de perfil do membro:
+
+1. Abra a aba **Permissões**
+2. Veja a função atualmente atribuída
+3. Selecione uma função diferente no menu suspenso
+4. A alteração entra em vigor imediatamente
+
+→ [Saiba mais sobre funções e permissões](/l/pt/user-guide/permissions-access/capabilities/permissions)
+
+### Remover um membro
+
+1. Clique no membro para abrir o perfil
+2. Clique em **Excluir conta** para removê-los da área de trabalho
+
+<Warning>
+Membros removidos perdem o acesso imediatamente. Os dados deles (registros, notas, tarefas) permanecem no espaço de trabalho.
+</Warning>
+
+<Note>
+E-mails e eventos da agenda do membro excluído estão arquivados e disponíveis para outros membros.
+</Note>
+
+## Convites pendentes
+
+Gerencie convites que ainda não foram aceitos:
+
+* **Reenviar**: Enviar o e-mail de convite novamente
+* **Cancelar**: Revogar o convite antes de ele ser aceito
+
+## Domínios de Acesso Aprovado
+
+Permita que membros da equipe ingressem automaticamente com base no domínio de e-mail:
+
+1. Vá para **Configurações → Membros → Convites**
+2. Adicione o domínio da sua empresa (por exemplo, `yourcompany.com`)
+3. Qualquer pessoa com esse domínio de e-mail pode ingressar sem convite
+
+## Relacionados
+
+* [Permissões](/l/pt/user-guide/permissions-access/capabilities/permissions) — configure o que cada função pode fazer
+* [Configurações do Domínio](/l/pt/user-guide/settings/capabilities/domains-settings) - configurar domínios aprovados

packages/twenty-docs/l/pt/user-guide/settings/capabilities/profile-settings.mdx

@@ -0,0 +1,43 @@
+---
+title: Configurações de Perfil
+description: Gerencie seu perfil pessoal e as configurações de segurança.
+---
+
+## Informações Pessoais
+
+### Nome e E-mail
+
+* **Nome de Exibição**: Atualize como seu nome aparece para outros membros do workspace
+* **Endereço de E-mail**: Altere seu e-mail de login (requer verificação)
+* **Foto do Perfil**: Carregue um avatar personalizado ou use suas iniciais
+
+## Configurações de Segurança
+
+### Autenticação de Dois Fatores (2FA)
+
+Ative o 2FA para adicionar uma camada extra de segurança à sua conta:
+
+1. Vá para **Configurações → Perfil**
+2. Clique em **Aplicativo de Autenticação**
+3. Escaneie o código QR com seu aplicativo autenticador
+4. Digite o código de verificação para confirmar
+
+### Gerenciamento de Senhas
+
+* **Alterar Senha**: Atualize sua senha atual
+* **Requisitos de Senha**: Deve ter pelo menos 8 caracteres
+
+## Gerenciamento de Perfil
+
+### Excluir Conta
+
+<Warning>
+Excluir sua conta removerá permanentemente seu acesso a todos os workspaces. Esta ação não pode ser desfeita. Você perderá o acesso a todos os espaços de trabalho dos quais é membro. Se você deseja apenas sair de equipes específicas, considere sair de espaços de trabalho individuais em vez disso.
+</Warning>
+
+Para excluir sua conta:
+
+1. Vá para **Configurações → Perfil**
+2. Role até **Zona de Perigo**
+3. Clique em **Excluir Conta**
+4. Confirme digitando seu endereço de e-mail

packages/twenty-docs/l/pt/user-guide/settings/capabilities/workspace-settings.mdx

@@ -0,0 +1,30 @@
+---
+title: Configurações do Espaço de Trabalho
+description: Personalize o nome e a marca do seu espaço de trabalho.
+---
+
+Sua imagem do espaço de trabalho, nome e opções de exclusão são acessíveis em **Configurações → Geral**.
+
+## Foto do Espaço de Trabalho
+
+* **Carregar Logotipo**: Adicione um logotipo personalizado para o espaço de trabalho
+* **Formatos suportados**: Arquivos PNG, JPEG e GIF com menos de 10MB
+* **Remover**: Delete o logotipo atual do espaço de trabalho
+
+## Nome do Espaço de Trabalho
+
+* **Nome**: Altere o nome de exibição do seu espaço de trabalho
+* Este nome aparece para todos os membros do espaço de trabalho
+
+## Zona de Perigo
+
+<Warning>
+Excluir seu espaço de trabalho remove permanentemente todos os dados e revoga imediatamente o acesso de todos os membros — esta ação não pode ser desfeita.
+</Warning>
+
+Para excluir seu espaço de trabalho:
+
+1. Clique no botão **Apagar Área de Trabalho**
+2. Confirme a exclusão quando solicitado
+
+**Nota**: Apenas administradores de espaço de trabalho podem excluir espaços de trabalho.

packages/twenty-docs/l/pt/user-guide/settings/how-tos/settings-faq.mdx

@@ -0,0 +1,171 @@
+---
+title: Configurações FAQ
+description: Perguntas frequentes sobre as configurações do Twenty.
+---
+
+## Configurações do Espaço de Trabalho
+
+<AccordionGroup>
+<Accordion title="Como altero o nome do meu espaço de trabalho?">
+1. Vá para **Configurações → Geral**
+2. Encontre o campo Nome do espaço de trabalho
+3. Digite o novo nome do espaço de trabalho
+4. As alterações são salvas automaticamente
+</Accordion>
+
+<Accordion title="Como atualizo o logotipo do meu espaço de trabalho?">
+1. Vá para **Configurações → Geral**
+2. Clique no logotipo atual ou na área de upload
+3. Selecione um arquivo de imagem (PNG, JPEG ou GIF com menos de 10 MB)
+4. O logotipo é atualizado imediatamente
+</Accordion>
+
+<Accordion title="Posso ter vários espaços de trabalho?">
+Sim, você pode criar e ser membro de vários espaços de trabalho. Cada espaço de trabalho tem seus próprios dados, configurações e assinatura.
+</Accordion>
+
+<Accordion title="Como excluo meu espaço de trabalho?">
+1. Vá para **Configurações → Geral**
+2. Role até a Zona de Perigo
+3. Clique em **Excluir espaço de trabalho**
+4. Confirme a exclusão
+
+Observação: isso exclui permanentemente todos os dados e não pode ser desfeito.
+</Accordion>
+
+<Accordion title="Criei vários espaços de trabalho por engano. O que devo fazer?">
+Exclua os espaços de trabalho de que você não precisa em **Configurações → Geral → Excluir espaço de trabalho**.
+
+<Warning>
+Não exclua sua **conta** (acessível em Configurações → Perfil): sua conta é compartilhada entre todos os seus espaços de trabalho. Excluir sua conta remove o acesso a TODOS os espaços de trabalho.
+</Warning>
+</Accordion>
+
+<Accordion title="Como desativo meu espaço de trabalho sem excluí-lo?">
+Se você quiser desativar temporariamente seu espaço de trabalho (e não excluí-lo permanentemente), vá para **Configurações → Cobrança** e clique em **Cancelar plano**. Seus dados serão preservados por um período de carência.
+</Accordion>
+</AccordionGroup>
+
+## Configurações de Perfil
+
+<AccordionGroup>
+<Accordion title="Como altero minha senha?">
+1. Vá para **Configurações → Perfil**
+2. Encontre a seção Senha
+3. Digite sua senha atual
+4. Digite sua nova senha
+5. Salve as alterações
+</Accordion>
+
+<Accordion title="Como ativo a autenticação de dois fatores?">
+1. Vá para **Configurações → Perfil**
+2. Encontre a seção 2FA
+3. Clique em **Ativar 2FA**
+4. Escaneie o código QR com seu aplicativo autenticador
+5. Digite o código de verificação
+</Accordion>
+
+<Accordion title="Posso alterar meu endereço de e-mail?">
+Para alterar seu endereço de e-mail, entre em contato pelo [contact@twenty.com](mailto:contact@twenty.com).
+</Accordion>
+
+<Accordion title="Como excluo minha conta?">
+1. Vá para **Configurações → Perfil**
+2. Role até a Zona de Perigo
+3. Clique em **Excluir Conta**
+4. Confirme digitando seu endereço de e-mail
+
+Observação: isso remove seu acesso a todos os espaços de trabalho e exclui todos os e-mails sincronizados das suas contas conectadas.
+</Accordion>
+</AccordionGroup>
+
+## Configurações da Experiência
+
+<AccordionGroup>
+<Accordion title="Como alterno entre os modos claro e escuro?">
+1. Vá para **Configurações → Experiência**
+2. Encontre a seção Tema
+3. Selecione Claro, Escuro ou Sistema
+</Accordion>
+
+<Accordion title="Como altero o formato de data?">
+1. Vá para **Configurações → Experiência**
+2. Encontre Formato de data
+3. Selecione o formato de sua preferência
+4. As alterações são aplicadas imediatamente
+</Accordion>
+
+<Accordion title="Como altero meu fuso horário?">
+1. Vá para **Configurações → Experiência**
+2. Encontre o fuso horário
+3. Selecione seu fuso horário local
+4. Todos os carimbos de data e hora serão ajustados
+</Accordion>
+
+<Accordion title="Posso alterar o idioma?">
+1. Vá para **Configurações → Experiência**
+2. Encontre o idioma
+3. Selecione entre os idiomas disponíveis
+4. A interface é atualizada de acordo com sua seleção
+</Accordion>
+</AccordionGroup>
+
+## Configurações da conta
+
+<AccordionGroup>
+<Accordion title="Como conecto minha conta de e-mail?">
+1. Vá para **Configurações → Contas**
+2. Clique em **Adicionar conta**
+3. Escolha Google ou Microsoft
+4. Autorize o acesso
+5. Configure as configurações de sincronização
+</Accordion>
+
+<Accordion title="Posso conectar várias contas de e-mail?">
+Sim, você pode conectar várias contas de e-mail. Vá para **Configurações → Contas** e adicione contas adicionais conforme necessário.
+</Accordion>
+
+<Accordion title="Como desconecto uma conta de e-mail?">
+1. Vá para **Configurações → Contas**
+2. Encontre a conta que você deseja remover
+3. Clique em **Desconectar**
+4. Confirme a ação
+</Accordion>
+</AccordionGroup>
+
+## Domínios
+
+<AccordionGroup>
+<Accordion title="Posso personalizar o domínio do meu espaço de trabalho?">
+Sim! Vá para **Configurações → Geral → Domínio do espaço de trabalho** e clique em **Personalizar domínio**. Você tem duas opções:
+
+* **Subdomínio**: Use um subdomínio do Twenty como `yourcompany.twenty.com`
+* **Domínio personalizado**: Use seu próprio domínio, como `crm.yourcompany.com` (requer configuração de DNS)
+
+Um subdomínio é rápido de configurar, enquanto um domínio personalizado oferece uma experiência totalmente personalizada com a sua marca para a sua equipe.
+</Accordion>
+
+<Accordion title="Como funcionam os domínios de acesso aprovados?">
+Você pode configurar domínios de acesso aprovados para que membros da equipe com endereços de e-mail da empresa possam ingressar automaticamente no seu espaço de trabalho. Vá para **Configurações → Membros → Convidar** e adicione o domínio da sua empresa (por exemplo, `yourcompany.com`).
+</Accordion>
+</AccordionGroup>
+
+## Recursos de Acesso antecipado
+
+<AccordionGroup>
+<Accordion title="Quais são os recursos de Acesso antecipado?">
+Os recursos de Acesso antecipado são funcionalidades em teste antes do lançamento geral.
+</Accordion>
+
+<Accordion title="É seguro usar os recursos de Acesso antecipado?">
+Recursos de Acesso Antecipado são funcionais e seguros de usar, mas podem mudar com base no feedback dos usuários antes de disponibilidade geral.
+</Accordion>
+
+<Accordion title="Como eu ativo os recursos de Acesso antecipado?">
+1. Vá em **Configurações → Comunidade**
+2. Role para baixo até a seção **Recursos**
+3. Encontre o recurso que você deseja
+4. Ative a opção
+5. O recurso fica disponível imediatamente
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/pt/user-guide/settings/overview.mdx

@@ -0,0 +1,62 @@
+---
+title: Configurações
+description: Configure seu espaço de trabalho Twenty com configurações essenciais.
+---
+
+## Configuração Inicial
+
+Ao criar seu espaço de trabalho pela primeira vez, há várias configurações importantes para definir.
+
+### Nome e Logotipo do Espaço de Trabalho
+
+1. Vá para **Configurações → Geral**
+2. Atualize o nome do seu espaço de trabalho
+3. Envie o logotipo da sua empresa
+4. Salve as alterações
+
+### Fuso Horário e Formato de Data
+
+1. Vá para **Configurações → Experiência**
+2. Selecione seu fuso horário
+3. Escolha seu formato de data preferido
+4. Salve as alterações
+
+## Configurações Essenciais
+
+### Conecte E-mail e Calendário
+
+Configure a sincronização de e-mail e calendário:
+
+1. Vá para **Configurações → Contas**
+2. Clique em **Adicionar conta**
+3. Conecte sua conta do Google ou da Microsoft
+4. Configure as configurações de sincronização
+
+→ [Guia completo de configuração de e-mail e calendário](/l/pt/user-guide/calendar-emails/overview)
+
+### Convide a sua equipa
+
+Adicione membros da equipa ao seu espaço de trabalho:
+
+1. Vá para **Configurações → Membros**
+2. Clique em **+ Convidar**
+3. Insira endereços de e-mail
+4. Atribua funções apropriadas
+
+<Note>
+Antes de convidar a sua equipa, verifique a função padrão em **Configurações → Membros → Funções**. Novos membros recebem automaticamente essa função ao entrar.
+</Note>
+
+## Lista de Verificação das Configurações do Espaço de Trabalho
+
+* Nome e logotipo do espaço de trabalho configurados
+* Fuso horário e formato de data definidos
+* Email e calendário conectados
+* Membros da equipe convidados
+* Funções e permissões configuradas
+
+## Próximos Passos
+
+* [Configurações do espaço de trabalho](/l/pt/user-guide/settings/capabilities/workspace-settings)
+* [Configurações do perfil](/l/pt/user-guide/settings/capabilities/profile-settings)
+* [Configurações de experiência](/l/pt/user-guide/settings/capabilities/experience-settings)

packages/twenty-docs/l/pt/user-guide/views-pipelines/capabilities/calendar-view.mdx

@@ -0,0 +1,46 @@
+---
+title: Visualização de calendário
+description: Exiba registros com campos de data em um calendário.
+---
+
+## Sobre a Visualização de calendário
+
+A visualização de calendário exibe seus registros em um calendário com base em um campo de data. Cada registro aparece como um evento na data correspondente.
+
+<img src="/images/user-guide/views/calendar-view-zoom.png" style={{width:'100%'}} />
+
+## Criando uma Visualização de calendário
+
+1. Navegue até um objeto com campos de data
+2. Clique no menu suspenso de visualizações → **+ Adicionar visualização**
+3. Nomeie sua visualização e clique em **Criar**
+4. Abra as **Opções** à direita
+5. Selecione **Calendário** como o layout
+6. Escolha o **campo de data** a ser usado para posicionar os registros
+7. Clique em **Atualizar visualização**
+
+## Configurando o calendário
+
+### Escolha o campo de data
+
+Em **Opções**, selecione qual campo de data determina onde os registros aparecem no calendário.
+
+### Exibir campos
+
+Configure quais campos aparecem em cada evento do calendário:
+
+1. Clique em **Opções → Campos**
+2. Ativar/desativar campos
+3. Arraste para reordenar
+
+## Casos de uso
+
+* **Reuniões e chamadas**: Visualize os próximos compromissos
+* **Prazos**: Acompanhe datas de vencimento e datas de fechamento
+* **Eventos**: Planeje e visualize atividades agendadas
+* **Acompanhamentos**: Veja quando as tarefas vencem
+
+## Relacionados
+
+* [Visão geral de visualizações](/l/pt/user-guide/views-pipelines/overview) — criação e gerenciamento de visualizações
+* [Filtros e ordenação](/l/pt/user-guide/views-pipelines/capabilities/filters-and-sorting) — filtrando dados do calendário

packages/twenty-docs/l/pt/user-guide/views-pipelines/capabilities/fields-and-columns.mdx

@@ -0,0 +1,52 @@
+---
+title: Campos e Colunas
+description: Escolha quais campos exibir e como organizá-los.
+---
+
+## Selecionar Campos para Exibição
+
+Cada visualização pode mostrar um conjunto diferente de campos. Personalize o que é visível para focar nas informações que importam.
+
+### Mostrar ou Ocultar Campos
+
+1. Clique em **Opções** no canto superior direito
+2. Clique em **Campos**
+3. Clique no **ícone de olho** ao lado de cada campo para mostrar/ocultar
+
+### Reordenar Campos
+
+Altere a ordem em que os campos aparecem na sua visualização:
+
+1. Clique em **Opções → Campos**
+2. Arraste os campos para cima ou para baixo
+3. As alterações são salvas automaticamente
+
+## Exibição de Campos por Tipo de Visualização
+
+### Visualizações de Tabela
+
+* Os campos aparecem como colunas
+* Redimensione as colunas arrastando as bordas
+
+### Visualizações Kanban
+
+* Os campos aparecem nos cartões
+* Reordene em Opções → Campos
+* Use a visualização compacta para ocultar todos os campos
+
+### Visualizações de Calendário
+
+* Os campos selecionados aparecem nos eventos do calendário
+* Configure em Opções → Campos
+
+## Melhores Práticas
+
+* **Mostre apenas o que é necessário** — muitos campos bagunçam a visualização
+* **Coloque os campos importantes primeiro** — colunas mais usadas à esquerda
+* **Crie várias visualizações** — conjuntos de campos diferentes para finalidades diferentes
+* **Use a visibilidade de campos por visualização** — mesmo objeto, foco diferente
+
+## Relacionados
+
+* [Visualizações de Tabela](/l/pt/user-guide/views-pipelines/capabilities/table-views) — recursos da visualização de lista
+* [Visualizações Kanban](/l/pt/user-guide/views-pipelines/capabilities/kanban-views) — visualizações baseadas em cartões

packages/twenty-docs/l/pt/user-guide/views-pipelines/capabilities/filters-and-sorting.mdx

@@ -0,0 +1,78 @@
+---
+title: Filtros e ordenação
+description: Filtre e ordene registros para encontrar exatamente o que você precisa.
+---
+
+## Filtrando dados
+
+Os filtros ajudam você a focar em registros específicos, mostrando apenas aqueles que correspondem aos seus critérios.
+
+### Adicionando um filtro
+
+1. Clique no botão **Filtrar** na barra de ferramentas
+2. Selecione o campo pelo qual filtrar
+3. Escolha o operador (igual a, contém, etc.)
+4. Insira o valor do filtro
+5. Clique em **Aplicar**
+
+### Operadores de filtro
+
+| Tipo de campo    | Operadores disponíveis                               |
+| ---------------- | ---------------------------------------------------- |
+| Texto            | Igual a, Contém, Começa com, Termina com, Está vazio |
+| Número           | Igual a, Maior que, Menor que, Está vazio            |
+| Data             | Igual a, Antes de, Depois de, Está vazio             |
+| Selecionar       | Igual a, É um dos, Está vazio                        |
+| Caixa de Seleção | É verdadeiro, É falso                                |
+| Relação          | Igual a, Está vazio                                  |
+
+### Vários filtros
+
+Combine vários filtros para restringir os resultados:
+
+* Todos os filtros são aplicados com a lógica AND
+* Cada filtro adicional restringe ainda mais os resultados
+
+### Removendo filtros
+
+* Clique no **X** em cada chip de filtro
+* Clique em **Limpar tudo** para remover todos os filtros
+
+## Ordenando dados
+
+A ordenação determina a ordem em que os registros aparecem.
+
+### Adicionando uma ordenação
+
+1. Clique no botão **Ordenar** na barra de ferramentas
+2. Selecione o campo pelo qual ordenar
+3. Escolha crescente (A-Z, 0-9) ou decrescente (Z-A, 9-0)
+4. Clique em **Aplicar**
+
+### Várias ordenações
+
+Adicione vários níveis de ordenação:
+
+* A primeira ordenação é a primária
+* As ordenações subsequentes se aplicam dentro de grupos de valores iguais
+
+### Ordenação rápida por coluna
+
+Clique no cabeçalho de uma coluna para ordenar:
+
+* Primeiro clique: Crescente
+* Segundo clique: Decrescente
+* Terceiro clique: Remover ordenação
+
+## Salvando as configurações de filtro e ordenação
+
+Filtros e ordenações são salvos com a visualização:
+
+1. Configure seus filtros e ordenações
+2. Clique em **Salvar** para atualizar a visualização atual
+3. Ou clique em **Salvar como nova visualização** para criar uma variante
+
+## Relacionados
+
+* [Visualizações de Tabela](/l/pt/user-guide/views-pipelines/capabilities/table-views) — recurso Agrupar por
+* [Visão geral de visualizações](/l/pt/user-guide/views-pipelines/overview) — criação e gerenciamento de visualizações

packages/twenty-docs/l/pt/user-guide/views-pipelines/capabilities/kanban-views.mdx

@@ -0,0 +1,98 @@
+---
+title: Visualizações do quadro Kanban
+description: Aprenda a usar as visualizações Kanban para visualizar e gerenciar seus fluxos de trabalho.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Sobre Visualizações Kanban
+
+As visualizações Kanban mapeiam visualmente os fluxos de processos, onde cada coluna representa um estágio distinto e cada cartão representa um registro.
+
+## Mover Cartões entre Estágios
+
+Você pode mover cada cartão entre as etapas à medida que avança no seu fluxo de trabalho, clicando e segurando um cartão e, em seguida, arrastando-o para a próxima etapa.
+
+<VimeoEmbed videoId="927888627" title="Demonstração em vídeo" />
+
+## Adicionar e excluir etapas
+
+Você pode personalizar seu fluxo de trabalho para atender às suas necessidades usando etapas, cada uma das quais representa um valor em um campo de Seleção:
+
+### Adicionar etapas
+
+Para adicionar uma etapa, acesse as configurações do campo de Seleção navegando para Configurações > Modelo de Dados, selecionando seu objeto e, em seguida, selecionando o campo do qual seu quadro Kanban depende.
+
+<VimeoEmbed videoId="927890428" title="Demonstração em vídeo" />
+
+### Remover Estágios
+
+Para remover uma etapa, passe o mouse sobre o nome da etapa ou o ícone `⋮`, clique em `Editar das configurações` nas configurações do campo de Seleção e, em seguida, clique em **Excluir** ao lado da etapa relevante.
+
+## Exibir campos
+
+Você pode configurar seu quadro Kanban para exibir alguns campos e ocultar outros. Para mostrar ou ocultar um campo, clique em **Opções** no canto superior direito, depois em **Campos** para abrir a lista de opções e clique no ícone de olho ao lado do campo para mostrá-lo ou ocultá-lo.
+
+Você também pode reorganizar a ordem dos campos mantendo pressionado o nome do campo e arrastando-o para onde quiser.
+
+<img src="/images/user-guide/kanban-views/filter.png" style={{width:'100%'}} />
+
+## Visualização compacta
+
+Você pode ocultar todos os campos e obter uma visão geral de todos os registros em um relance. Para ativar:
+
+1. Clique em **Opções** no canto superior direito
+2. Ative a opção **Visualização compacta**
+
+<img src="/images/user-guide/kanban-views/compact-view.png" style={{width:'100%'}} />
+
+## Agregações por coluna
+
+Cada coluna em uma visualização Kanban pode exibir valores agregados na parte superior, ajudando você a entender seus dados em um relance.
+
+### Agregações disponíveis
+
+| Agregação    | Descrição                                                     |
+| ------------ | ------------------------------------------------------------- |
+| **Contagem** | Número de registros na coluna                                 |
+| **Soma**     | Total de um campo numérico (por exemplo, valores de negócios) |
+| **Média**    | Valor médio de um campo numérico                              |
+| **Mínimo**   | Menor valor                                                   |
+| **Máximo**   | Maior valor                                                   |
+
+### Configurando agregações
+
+1. Clique no número exibido ao lado do valor da etapa, na parte superior de uma coluna
+2. Selecione o tipo de agregação
+3. Escolha o campo a agregar
+
+**Exemplo:** Mostre o valor total dos negócios por etapa agregando o campo Valor com Soma.
+
+## Quando usar visualizações Kanban
+
+As visualizações Kanban são ideais para:
+
+* **Funis de vendas**: Acompanhe os negócios pelas etapas, do lead ao fechamento
+* **Gestão de projetos**: Monitore tarefas por meio dos estados do fluxo de trabalho
+* **Recrutamento**: Acompanhe candidatos pelas etapas de contratação
+* **Qualquer processo em etapas**: Visualize qualquer fluxo de trabalho com etapas definidas
+
+## Melhores Práticas
+
+### Organize suas etapas
+
+* **Limite as etapas**: 5–7 etapas são ideais para visibilidade
+* **Nomenclatura clara**: Use nomes descritivos para as etapas
+* **Ordem lógica**: Organize as etapas na ordem do processo
+
+### Otimize a exibição dos cartões
+
+* **Mostre campos-chave**: Exiba apenas as informações mais importantes
+* **Use a visualização compacta**: Para visões gerais de alto nível
+* **Codificação por cores**: Use cores de etapa para identificar rapidamente o status
+
+### Mantenha a qualidade dos dados
+
+* **Atualize regularmente**: Mantenha os cartões avançando pelas etapas
+* **Arquive os concluídos**: Mova os itens fechados para fora da visualização ativa
+* **Revise cartões parados**: Faça acompanhamento de cartões presos nas etapas

packages/twenty-docs/l/pt/user-guide/views-pipelines/capabilities/table-views.mdx

@@ -0,0 +1,64 @@
+---
+title: Visualizações de Tabela
+description: Exiba seus dados em um formato de lista semelhante a uma planilha.
+---
+
+## Sobre as Visualizações de Tabela
+
+As visualizações de tabela exibem registros em linhas com colunas personalizáveis—como uma planilha. Este é o tipo de visualização padrão para a maioria dos objetos.
+
+<img src="/images/user-guide/table-views/table-view.png" style={{width:'100%'}} />
+
+## Recursos
+
+### Configuração de colunas
+
+* Mostrar ou ocultar colunas (campos)
+* Redimensionar a largura das colunas
+* Reordenar colunas arrastando
+
+### Agrupar por um campo de seleção
+
+Organize os registros em grupos recolhíveis com base em um campo de seleção.
+
+<img src="/images/user-guide/table-views/table-group-by.png" style={{width:'100%'}} />
+
+1. Clique em **Opções**
+2. Selecione **Agrupar**
+3. Escolha um campo de seleção
+4. Configure a ordem dos grupos em **Opções → Agrupar → Ordenar**:
+   * **Alfabética** ou **Alfabética inversa**
+   * **Ordem manual**: arraste os grupos em "Grupos visíveis" para reordenar
+   * Clique no **ícone de olho** ao lado de um grupo para ocultá-lo
+
+**Casos de uso:**
+
+* Agrupar empresas por tipo
+* Agrupar oportunidades por etapa
+* Agrupar tarefas por estado
+
+<Note>
+**Para melhor desempenho, limite a 10-15 grupos visíveis por visualização.** Se precisar de mais grupos, considere usar um Painel.
+</Note>
+
+### Largura das colunas
+
+Redimensione as colunas para mostrar mais ou menos conteúdo:
+
+1. Passe o cursor entre dois cabeçalhos de coluna
+2. Clique e arraste a borda da coluna
+3. Solte para definir a nova largura
+
+## Quando usar visualizações de tabela
+
+As visualizações de tabela funcionam melhor para:
+
+* **Navegar por grandes conjuntos de dados** — examinar muitos registros rapidamente
+* **Inserção de dados** — editar vários registros com eficiência
+* **Análise detalhada** — ver muitos campos de uma vez
+* **Classificação e filtragem** — encontrar registros específicos
+
+## Relacionados
+
+* [Campos e colunas](/l/pt/user-guide/views-pipelines/capabilities/fields-and-columns) — configurando quais campos exibir
+* [Filtros e ordenação](/l/pt/user-guide/views-pipelines/capabilities/filters-and-sorting) — restringindo os registros

packages/twenty-docs/l/pt/user-guide/views-pipelines/capabilities/view-settings.mdx

@@ -0,0 +1,74 @@
+---
+title: Configurações de Vista
+description: Gerencie a visibilidade, os nomes, os ícones e a organização das visualizações.
+---
+
+## Visibilidade da visualização
+
+Controle quem pode ver suas visualizações personalizadas.
+
+### Opções de visibilidade
+
+| Configuração           | Quem pode ver                          |
+| ---------------------- | -------------------------------------- |
+| **Espaço de trabalho** | Todos os membros do espaço de trabalho |
+| **Não listado**        | Apenas você                            |
+
+### Alterar a visibilidade
+
+1. Abra a visualização
+2. Clique em **Opções → Visibilidade**
+3. Selecione **Espaço de trabalho** ou **Não listado**
+
+<Note>
+As visualizações padrão "Todos(as) [Nome do objeto]" não podem ter sua visibilidade alterada.
+</Note>
+
+## Renomear uma visualização
+
+1. Abra o menu suspenso de visualizações
+2. Clique no menu **⋮** ao lado da visualização
+3. Selecione **Editar**
+4. Insira o novo nome
+
+## Alterar o ícone da visualização
+
+1. Abra o menu suspenso de visualizações
+2. Clique no menu **⋮** ao lado da visualização
+3. Selecione **Editar**
+4. Clique no ícone para alterá-lo
+
+## Reordenar visualizações
+
+Altere a ordem em que as visualizações aparecem no menu suspenso:
+
+1. Abra o menu suspenso de visualizações
+2. Arraste as visualizações pela alça
+3. Solte na posição desejada
+4. A ordem é salva automaticamente
+
+## Favoritar uma Visualização
+
+Fixe visualizações usadas com frequência para acesso rápido:
+
+1. Abra o menu suspenso de visualizações
+2. Clique no menu **⋮** ao lado de uma visualização
+3. Selecione **Adicionar aos favoritos**
+
+As visualizações favoritas aparecem em uma seção dedicada para facilitar o acesso.
+
+## Excluir uma visualização
+
+1. Abra o menu suspenso de visualizações
+2. Clique no menu **⋮** ao lado da visualização
+3. Selecione **Excluir**
+4. Confirme a exclusão
+
+<Warning>
+Visualizações excluídas não podem ser recuperadas.
+</Warning>
+
+## Relacionados
+
+* [Visão geral de visualizações](/l/pt/user-guide/views-pipelines/overview) — criação de visualizações
+* [Como restringir o acesso](/l/pt/user-guide/views-pipelines/how-tos/restrict-access-to-your-view) — guia passo a passo

packages/twenty-docs/l/pt/user-guide/views-pipelines/how-tos/create-a-calendar-view-for-tasks-due.mdx

@@ -0,0 +1,61 @@
+---
+title: Crie uma visualização de calendário para tarefas com vencimento
+description: Visualize suas tarefas e prazos em um calendário.
+---
+
+<img src="/images/user-guide/views/calendar-view-zoom.png" style={{width:'100%'}} />
+
+## Pré-requisitos
+
+Seu objeto Tasks precisa de um campo **Data de vencimento** (tipo Data ou Data e hora).
+
+## Etapas
+
+1. Navegue até **Tasks**
+2. Clique no menu suspenso de visualizações → **+ Adicionar visualização**
+3. Nomeie sua visualização (por exemplo, "Calendário de tarefas")
+4. Clique em **Criar**
+5. Clique em **Opções** e selecione **Calendário** como o layout
+6. Escolha **Data de vencimento** como o campo de data
+7. Clique em **Salvar**
+
+## Configure seu calendário
+
+### Exiba campos nos eventos
+
+1. Clique em **Opções → Campos**
+2. Clique no **ícone de olho** para mostrar/ocultar campos
+3. Arraste para reordenar
+
+Campos recomendados para exibir:
+
+* **Título** — nome da tarefa
+* **Responsável** — quem é o responsável
+* **Status** — progresso atual
+
+### Filtre seu calendário
+
+Crie visualizações focadas:
+
+* **Minhas Tarefas**: Filtrar por Responsável = Eu
+* **Esta semana**: Filtrar por Data de Vencimento = Esta semana
+* **Em atraso**: Filtrar por Data de Vencimento < Hoje, Estado ≠ Concluído
+
+## Outros casos de uso do calendário
+
+| Objeto                 | Campo de Data  | Finalidade                           |
+| ---------------------- | -------------- | ------------------------------------ |
+| Oportunidades          | Data de Fecho  | Acompanhar fechos esperados          |
+| Eventos personalizados | Data do Evento | Planear atividades                   |
+| Projetos               | Prazo          | Monitorizar cronogramas dos projetos |
+
+## Dicas
+
+* **Reveja semanalmente**: Comece cada semana por verificar a sua visualização de calendário
+* **Combine com a visualização de tabela**: Utilize o calendário para a visão geral e a tabela para os detalhes
+* **Defina a visibilidade**: Mantenha os calendários de tarefas pessoais como Não listados
+
+## Relacionados
+
+* [Visualização de Calendário](/l/pt/user-guide/views-pipelines/capabilities/calendar-view) — todos os recursos do calendário
+* [Filtros e ordenação](/l/pt/user-guide/views-pipelines/capabilities/filters-and-sorting) — filtre o seu calendário

packages/twenty-docs/l/pt/user-guide/views-pipelines/how-tos/create-a-kanban-view-for-projects.mdx

@@ -0,0 +1,80 @@
+---
+title: Crie uma visualização Kanban para projetos
+description: Acompanhe projetos por etapas usando um quadro visual.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Use uma visualização Kanban para visualizar os seus projetos (ou qualquer objeto com etapas) como cartões que se movem pelas colunas.
+
+<VimeoEmbed videoId="927888627" title="Demonstração em vídeo" />
+
+## Pré-requisitos
+
+O seu objeto precisa de um **campo Select** para usar como colunas (por exemplo, Estado, Etapa, Fase).
+
+Se não tiver um:
+
+1. Vá a **Definições → Modelo de Dados**
+2. Selecione o seu objeto
+3. Adicione um campo Select com as suas opções de etapas
+
+## Etapas
+
+1. Aceda ao seu objeto (por exemplo, Projetos, Tarefas)
+2. Clique no menu suspenso de visualizações → **+ Adicionar visualização**
+3. Nomeie a sua visualização (por exemplo, "Quadro de projetos")
+4. Clique em **Criar**
+5. Clique em **Opções** e selecione **Kanban** como o layout
+6. A visualização usa automaticamente o seu campo Select para as colunas
+7. Clique em **Salvar**
+
+## Configure o seu quadro
+
+### Mostrar campos principais nos cartões
+
+1. Clique em **Opções → Campos**
+2. Procure campos na secção "Campos Ocultos"
+3. Clique no **ícone de olho** para os mostrar nos cartões
+4. Arraste para reordenar
+
+<img src="/images/user-guide/kanban-views/filter.png" style={{width:'100%'}} />
+
+### Ativar visualização compacta
+
+Para uma visão geral de alto nível:
+
+1. Clique em **Opções**
+2. Ative a opção **Visualização compacta**
+
+Os cartões mostram apenas o nome do registo.
+
+<img src="/images/user-guide/kanban-views/compact-view.png" style={{width:'100%'}} />
+
+### Adicionar agregações
+
+Mostre contagens ou totais no topo de cada coluna:
+
+1. Clique no número ao lado do nome de uma coluna
+2. Selecione uma agregação (Contagem, Soma, etc.)
+3. Escolha um campo, se necessário
+
+## Mover cartões
+
+Arraste e solte os cartões entre colunas para atualizar o seu estado.
+
+<VimeoEmbed videoId="927888627" title="Demonstração em vídeo" />
+
+## Exemplo: Quadro de tarefas
+
+| Coluna (Estado)  | Cartões              |
+| ---------------- | -------------------- |
+| **A Fazer**      | Novas tarefas        |
+| **Em andamento** | Trabalho ativo       |
+| **Revisão**      | A aguardar aprovação |
+| **Concluído**    | Concluído            |
+
+## Relacionados
+
+* [Visualizações Kanban](/l/pt/user-guide/views-pipelines/capabilities/kanban-views) — agregações, visualização compacta, etapas
+* [Como configurar um pipeline de vendas](/l/pt/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline) — Kanban para oportunidades

packages/twenty-docs/l/pt/user-guide/views-pipelines/how-tos/create-a-table-view-with-grouping.mdx

@@ -0,0 +1,51 @@
+---
+title: Criar uma visualização de tabela com agrupamento
+description: Organize seus registros em grupos recolhíveis com base no valor do campo.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Agrupe sua visualização de tabela por um campo de seleção para organizar registros em seções recolhíveis.
+
+<img src="/images/user-guide/table-views/table-group-by.png" style={{width:'100%'}} />
+
+## Etapas
+
+1. Navegue até o objeto (Pessoas, Empresas, etc.)
+2. Clique no menu suspenso de visualizações → **+ Adicionar visualização**
+3. Nomeie sua visualização (por exemplo, "Empresas por tipo")
+4. Clique em **Criar**
+5. Clique em **Opções → Agrupar**
+6. Escolha um campo de seleção para agrupar
+7. Clique em **Salvar**
+
+## Configurar ordem dos grupos
+
+Em **Opções → Agrupar → Ordenação**, escolha como os grupos são ordenados:
+
+| Opção                  | Descrição                                             |
+| ---------------------- | ----------------------------------------------------- |
+| **Alfabética**         | De A a Z                                              |
+| **Alfabética inversa** | De Z a A                                              |
+| **Ordem manual**       | Arraste os grupos para reordenar em "Grupos visíveis" |
+
+Clique no **ícone de olho** ao lado de um grupo para ocultá-lo da visualização.
+
+<Note>
+**Para melhor desempenho, limite a 10-15 grupos visíveis.** Se precisar de mais, considere usar um Painel.
+</Note>
+
+## Exemplo: Empresas por indústria
+
+1. Vá para **Empresas**
+2. Crie uma nova visualização chamada "Por indústria"
+3. Clique em **Opções → Agrupar**
+4. Selecione o campo **Indústria**
+5. Salvar
+
+Agora suas empresas estão organizadas por indústria, facilitando focar em um segmento por vez.
+
+## Relacionados
+
+* [Visualizações de Tabela](/l/pt/user-guide/views-pipelines/capabilities/table-views) — todos os recursos da visualização de tabela
+* [Filtros e ordenação](/l/pt/user-guide/views-pipelines/capabilities/filters-and-sorting) — combine o agrupamento com filtros

packages/twenty-docs/l/pt/user-guide/views-pipelines/how-tos/restrict-access-to-your-view.mdx

@@ -0,0 +1,32 @@
+---
+title: Restrinja o acesso à sua visualização
+description: Controle quem pode ver suas visualizações personalizadas.
+---
+
+Cada visualização (exceto as visualizações padrão "Todos(as) [Nome do objeto]") tem sua própria configuração de visibilidade.
+
+## Etapas
+
+1. Abra a visualização que deseja restringir
+2. Clique em **Opções** no canto superior direito
+3. Clique em **Visibilidade**
+4. Selecione **Não listado**
+
+Sua visualização agora está visível apenas para você.
+
+## Opções de visibilidade
+
+| Configuração           | Quem pode ver                          |
+| ---------------------- | -------------------------------------- |
+| **Espaço de trabalho** | Todos os membros do espaço de trabalho |
+| **Não listado**        | Apenas você                            |
+
+## Notas
+
+* As visualizações padrão "Todos(as) [Nome do objeto]" não podem ser definidas como não listadas
+* Visualizações não listadas não aparecem nos menus suspensos de visualização de outros usuários
+* Você pode alterar a visibilidade de volta para Espaço de trabalho a qualquer momento
+
+## Relacionados
+
+* [Configurações de visualização](/l/pt/user-guide/views-pipelines/capabilities/view-settings) — todas as opções de configuração de visualização

packages/twenty-docs/l/pt/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline.mdx

@@ -0,0 +1,120 @@
+---
+title: Configurar um Pipeline de Vendas
+description: Configure seu pipeline de vendas para acompanhar as oportunidades ao longo das etapas.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Um pipeline de vendas no Twenty é uma visualização Kanban do seu objeto Oportunidades, em que cada coluna representa uma etapa do seu processo de vendas.
+
+## Etapa 1: Configure Suas Etapas
+
+As etapas são definidas no campo **Stage** do objeto Oportunidades.
+
+1. Vá para **Configurações → Modelo de Dados**
+2. Selecione **Oportunidades**
+3. Encontre e clique no campo **Stage**
+4. Adicione, remova ou renomeie etapas para corresponder ao seu processo
+
+<VimeoEmbed videoId="927890428" title="Demonstração em vídeo" />
+
+### Etapas Recomendadas
+
+| Etapa                 | Finalidade                        |
+| --------------------- | --------------------------------- |
+| **Novo**              | Oportunidades recém-identificadas |
+| **Qualificado**       | Confirmado como boa adequação     |
+| **Reunião**           | Em discussões                     |
+| **Proposta**          | Proposta enviada                  |
+| **Negociação**        | Trabalhando nos termos            |
+| **Fechado - Ganho**   | Negócio bem-sucedido              |
+| **Fechado - Perdido** | Negócio mal-sucedido              |
+
+<Note>
+**5-7 etapas são ideais.** Muitas etapas tornam o gasoduto difícil de escanear; muito pouca visibilidade é perdida no progresso do negócio.
+</Note>
+
+## Etapa 2: Crie uma Visualização de Pipeline
+
+1. Vá para **Oportunidades**
+2. Clique no menu suspenso de visualizações → **+ Adicionar visualização**
+3. Dê o nome de "Pipeline de Vendas"
+4. Clique em **Criar**
+5. Abra **Opções** e selecione **Kanban** como o layout
+
+A visualização usa automaticamente o campo Stage para as colunas.
+
+## Etapa 3: Configure Sua Visualização
+
+### Mostrar Campos Principais
+
+1. Clique em **Opções → Campos**
+2. Procure campos na seção "Campos Ocultos"
+3. Clique no **ícone de olho** para exibir: Empresa, Valor, Data de Fechamento, Responsável
+
+### Ativar Agregações
+
+Mostrar totais no topo de cada coluna:
+
+1. Clique no número exibido ao lado do nome da etapa no topo de uma coluna
+2. Selecione o tipo de agregação (Contagem, Soma, Média, etc.)
+3. Escolha o campo a agregar (por exemplo, Valor)
+
+**Exemplo:** Mostre o valor total dos negócios por etapa agregando o campo Valor com Soma.
+
+### Use a visão compacta (opcional)
+
+Para uma visão geral de alto nível com conteúdo mínimo nos cartões:
+
+1. Clique em **Opções**
+2. Ative a opção **Visualização compacta**
+
+## Etapa 4: Crie Visualizações Pessoais e de Equipe
+
+### "Meu Pipeline"
+
+* **Filtro**: Responsável = Eu
+* **Visibilidade**: Não listada (visualização pessoal)
+
+### "Pipeline da Equipe"
+
+* **Filtro**: Nenhum (mostrar tudo)
+* **Visibilidade**: Espaço de trabalho (visualização compartilhada)
+
+### "Fechando Este Mês"
+
+* **Tipo**: Tabela
+* **Filtro**: Data de Fechamento = Este mês, Etapa ≠ Fechado - Ganho, Etapa ≠ Fechado - Perdido
+* **Ordenação**: Data de Fechamento ascendente
+
+## Trabalhando com Oportunidades
+
+### Criando Oportunidades
+
+* Clique em **+ Novo** na visualização de Oportunidades
+* Ou clique em **+** na coluna de uma etapa específica
+
+### Avançando pelas Etapas
+
+Arraste e solte os cartões de oportunidade entre colunas para atualizar sua etapa.
+
+<VimeoEmbed videoId="927888627" title="Demonstração em vídeo" />
+
+## Melhores Práticas
+
+### Higiene do Pipeline
+
+* Atualize os negócios diariamente conforme eles avançam
+* Mova ou feche rapidamente os negócios estagnados
+* Mantenha as datas de fechamento realistas
+
+### Disciplina de Etapas
+
+* Defina critérios claros para cada etapa
+* Mova os negócios prontamente quando os critérios forem atendidos
+* Não deixe os negócios permanecerem tempo demais nas etapas
+
+## Relacionados
+
+* [Visualizações Kanban](/l/pt/user-guide/views-pipelines/capabilities/kanban-views) — agregações e visualização compacta
+* [Filtros e Ordenação](/l/pt/user-guide/views-pipelines/capabilities/filters-and-sorting) — criando visualizações filtradas

packages/twenty-docs/l/pt/user-guide/views-pipelines/how-tos/show-expected-amount-in-pipeline.mdx

@@ -0,0 +1,149 @@
+---
+title: Mostrar o Valor Esperado no seu pipeline
+description: Calcule e exiba valores ponderados de negócios com base na probabilidade da etapa.
+---
+
+O Valor Esperado é um valor calculado: **Amount × Probability**. Isso ajuda você a prever a receita, ponderando os negócios com base na probabilidade de fechamento.
+
+<Tip>
+Este é um exemplo de criação de [Campos de fórmula](/l/pt/user-guide/workflows/how-tos/crm-automations/formula-fields) usando fluxos de trabalho.
+</Tip>
+
+Este guia orienta você na configuração dos campos personalizados e fluxos de trabalho necessários para calcular e exibir valores esperados no seu pipeline.
+
+## Etapa 1: Criar campos personalizados
+
+Você precisa de dois campos personalizados no objeto Oportunidades.
+
+### Crie o campo Probability
+
+1. Acesse **Configurações → Modelo de Dados → Oportunidades**
+2. Clique em **+ Adicionar campo**
+3. Configurar:
+   * **Nome**: Probability
+   * **Tipo**: Número
+   * **Descrição**: Probabilidade baseada na etapa (0-100%)
+4. Clique em **Salvar**
+
+### Crie o campo Expected Amount
+
+1. Clique em **+ Adicionar campo**
+2. Configurar:
+   * **Nome**: Expected Amount
+   * **Tipo**: Moeda
+   * **Descrição**: Calculado: Amount × Probability
+3. Clique em **Salvar**
+
+### Opcional: tornar os campos somente leitura para os usuários
+
+Se você não quiser que os usuários editem manualmente esses campos calculados:
+
+1. Vá para **Configurações → Membros → Funções**
+2. Selecione a função a configurar
+3. Encontre o objeto Oportunidades
+4. Defina os campos **Probability** e **Expected Amount** como somente leitura
+
+Isso garante que apenas os fluxos de trabalho possam atualizar esses valores.
+
+## Etapa 2: Criar o fluxo de trabalho nº 1 — Atualizar Probability na alteração de etapa
+
+Este fluxo de trabalho define automaticamente o campo Probability quando uma oportunidade é movida para uma nova etapa.
+
+### Criar o fluxo de trabalho
+
+1. Acesse **Fluxos de trabalho**
+2. Clique em **+ Novo fluxo de trabalho**
+3. Nomeie como "Update Probability on Stage Change"
+
+### Configurar o gatilho
+
+1. Adicione um gatilho **Registro criado ou atualizado**
+2. Selecione **Oportunidades** como o objeto
+3. Filtre por: o campo **Stage** é atualizado
+
+### Adicione ramificações para cada etapa
+
+Crie uma ramificação para cada etapa com sua probabilidade:
+
+| Etapa       | Probabilidade |
+| ----------- | ------------- |
+| Novo        | 10%           |
+| Qualificado | 25%           |
+| Meeting     | 40%           |
+| Proposal    | 60%           |
+| Negotiation | 80%           |
+| Closed Won  | 100%          |
+| Closed Lost | 0%            |
+
+<Note>
+Para criar uma nova ramificação, clique com o botão direito na tela do fluxo de trabalho e clique em **Nova ação**. Em seguida, vincule essa ação ao nó anterior arrastando a seta do nó anterior para esta nova ação.
+</Note>
+
+Para cada etapa:
+
+1. Adicione um nó **Filtro**: Stage = [nome da etapa]
+2. Adicione uma ação **Atualizar registro**:
+   * Registro: a Oportunidade que acionou
+   * Campo: Probability
+   * Valor: [probabilidade para essa etapa]
+
+### Calcular o Valor Esperado
+
+Depois que as ramificações se unirem:
+
+1. Adicione um nó **Filtro**: Amount não está vazio
+2. Adicione uma ação **Atualizar registro**:
+   * Registro: a Oportunidade que acionou
+   * Campo: Expected Amount
+   * Valor: Amount × Probability
+
+## Etapa 3: Criar o fluxo de trabalho nº 2 — Recalcular na alteração de Amount
+
+Este fluxo de trabalho atualiza o campo Expected Amount quando o Amount do negócio é alterado.
+
+### Criar o fluxo de trabalho
+
+1. Acesse **Fluxos de trabalho**
+2. Clique em **+ Novo fluxo de trabalho**
+3. Nomeie como "Recalculate Expected Amount on Amount Change"
+
+### Configurar o gatilho
+
+1. Adicione um gatilho **Registro criado ou atualizado**
+2. Selecione **Oportunidades** como o objeto
+3. Filtre por: o campo **Amount** é atualizado
+
+### Adicione a lógica
+
+1. Adicione um nó **Filtro**: Amount não está vazio
+2. Adicione uma ação **Atualizar registro**:
+   * Registro: a Oportunidade que acionou
+   * Campo: Expected Amount
+   * Valor: Amount × Probability
+
+## Etapa 4: Exibir no seu pipeline
+
+Agora mostre os totais de Expected Amount na sua visualização Kanban:
+
+1. Abra a visualização Kanban do seu **Pipeline de Vendas**
+2. Clique no **número** ao lado de qualquer nome de Stage no topo de uma coluna
+3. Selecione **Soma**
+4. Escolha **Expected Amount**
+
+Cada coluna agora mostra o valor total ponderado do pipeline para essa etapa.
+
+## Resumo
+
+| Componente                 | Finalidade                                                                        |
+| -------------------------- | --------------------------------------------------------------------------------- |
+| **Campo Probability**      | Armazena a probabilidade de ganho baseada na etapa                                |
+| **Campo Expected Amount**  | Armazena Amount × Probability                                                     |
+| **Fluxo de trabalho nº 1** | Atualiza Probability quando a Stage muda e, em seguida, recalcula Expected Amount |
+| **Fluxo de trabalho nº 2** | Recalcula Expected Amount quando Amount muda                                      |
+| **Agregação**              | Exibe a soma de Expected Amount por etapa                                         |
+
+## Relacionados
+
+* [Campos de fórmula](/l/pt/user-guide/workflows/how-tos/crm-automations/formula-fields) — crie campos calculados usando fluxos de trabalho
+* [Visualizações de Kanban](/l/pt/user-guide/views-pipelines/capabilities/kanban-views) — agregações por coluna
+* [Como criar campos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-fields) — configuração de campos

packages/twenty-docs/l/pt/user-guide/views-pipelines/how-tos/track-time-in-stage.mdx

@@ -0,0 +1,231 @@
+---
+title: Acompanhe por quanto tempo as oportunidades permanecem em cada etapa.
+description: Monitore a velocidade do negócio acompanhando quando as oportunidades entram em cada etapa.
+---
+
+<Tip>
+Este é um exemplo de criação de [Campos de fórmula](/l/pt/user-guide/workflows/how-tos/crm-automations/formula-fields) usando fluxos de trabalho — especificamente cálculos de datas.
+</Tip>
+
+Acompanhar quando as oportunidades entram em cada etapa ajuda a identificar gargalos e medir a velocidade do negócio.
+
+Este guia orienta você na configuração de campos personalizados e de um fluxo de trabalho para registrar automaticamente quando uma oportunidade passa para cada etapa e calcular quantos dias ela passou na etapa anterior.
+
+## Etapa 1: Criar campos personalizados
+
+Você precisa de dois tipos de campos para cada etapa:
+
+* **Campos de Data e hora**: registrar quando a oportunidade entrou em cada etapa
+* **Campos de Número**: armazenar quantos dias a oportunidade passou em cada etapa
+
+### Criar os campos "Última entrada"
+
+1. Acesse **Configurações → Modelo de Dados → Oportunidades**
+2. Para cada etapa, clique em **+ Adicionar campo** e configure:
+   * **Nome**: Última entrada em [Nome da etapa] (por exemplo, "Última entrada em Novo", "Última entrada em Qualificado")
+   * **Tipo**: Data e hora
+   * **Descrição**: Carimbo de data/hora de quando a oportunidade entrou nesta etapa
+3. Clique em **Salvar**
+
+Crie estes campos:
+
+* Última entrada em Novo
+* Última entrada em Qualificado
+* Última entrada em Reunião
+* Última entrada em Proposta
+* Última entrada em Negociação
+* Última entrada em Fechado Ganho
+* Última entrada em Fechado Perdido
+
+### Criar os campos "Dias na etapa"
+
+1. Para cada etapa, clique em **+ Adicionar campo** e configure:
+   * **Nome**: Dias em [Nome da etapa] (por exemplo, "Dias em Novo", "Dias em Qualificado")
+   * **Tipo**: Número
+   * **Descrição**: Número de dias passados nesta etapa
+2. Clique em **Salvar**
+
+Crie estes campos:
+
+* Dias em Novo
+* Dias em Qualificado
+* Dias em Reunião
+* Dias em Proposta
+* Dias em Negociação
+
+<Note>
+Você não precisa de campos "Dias em" para Fechado Ganho e Fechado Perdido, pois são etapas finais.
+</Note>
+
+### Opcional: tornar os campos somente leitura
+
+Se você não quiser que os usuários editem manualmente esses campos calculados:
+
+1. Vá para **Configurações → Membros → Funções**
+2. Selecione a função a configurar
+3. Encontre o objeto Oportunidades
+4. Defina os campos "Última entrada" e "Dias em" como somente leitura
+
+## Etapa 2: Criar o fluxo de trabalho
+
+Este único fluxo de trabalho trata das duas tarefas:
+
+* Registra o carimbo de data/hora ao entrar em uma nova etapa
+* Calcula os dias passados na etapa anterior
+
+### Criar o fluxo de trabalho
+
+1. Acesse **Fluxos de trabalho**
+2. Clique em **+ Novo fluxo de trabalho**
+3. Dê o nome "Acompanhar tempo por etapa"
+
+### Configurar o gatilho
+
+1. Adicione um gatilho **Registro atualizado**
+2. Selecione **Oportunidades** como o objeto
+3. Filtrar em: o campo **Fase** é atualizado
+
+### Adicionar ramificações para cada fase
+
+<Note>
+Para criar uma nova ramificação, clique com o botão direito no canvas do workflow e clique em **Nova ação**. Em seguida, vincule esta ação ao nó anterior arrastando a seta do nó anterior para esta nova ação.
+</Note>
+
+---
+
+**Ramificação 1: Fase = Novo (primeira fase)**
+
+Como esta é a primeira etapa, apenas o carimbo de data e hora de entrada é registrado — não há etapa anterior a partir da qual calcular.
+
+1. Adicione um nó de **Filtro**: Fase = Novo
+2. Adicione uma ação de **Código**:
+
+```javascript
+export const main = async (): Promise<object> => {
+  return { now: new Date().toISOString() };
+};
+```
+
+3. Adicione uma ação de **Atualizar registro**:
+   * Registro: A Oportunidade disparadora
+   * Campo: Última entrada em Novo
+   * Valor: `now` do nó de Código
+
+---
+
+**Ramificação 2: Fase = Qualificado**
+
+Ao mover para Qualificado, registre o momento de entrada E calcule os dias passados em Novo.
+
+1. Adicione um nó de **Filtro**: Fase = Qualificado
+2. Adicione uma ação de **Código**:
+
+```javascript
+export const main = async (params: {
+  lastEnteredPreviousStage: Date;
+}): Promise<object> => {
+  const { lastEnteredPreviousStage } = params;
+
+  const now = new Date();
+  const entryDate = new Date(lastEnteredPreviousStage);
+  const diffTime = Math.abs(now.getTime() - entryDate.getTime());
+  const daysInPreviousStage = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
+
+  return {
+    now: now.toISOString(),
+    daysInPreviousStage: daysInPreviousStage
+  };
+};
+```
+
+3. Configure a entrada do nó de Código: mapeie `lastEnteredPreviousStage` para o campo **Última entrada em Novo**
+4. Adicione uma ação de **Atualizar registro**:
+   * Registro: A Oportunidade disparadora
+   * Campos a atualizar:
+     * Última entrada em Qualificado = `now`
+     * Dias em Novo = `daysInPreviousStage`
+
+---
+
+**Ramificação 3: Fase = Reunião**
+
+Ao mover para Reunião, registre o momento de entrada E calcule os dias passados em Qualificado.
+
+1. Adicione um nó de **Filtro**: Fase = Reunião
+2. Adicione uma ação de **Código**:
+
+```javascript
+export const main = async (params: {
+  lastEnteredPreviousStage: Date;
+}): Promise<object> => {
+  const { lastEnteredPreviousStage } = params;
+
+  const now = new Date();
+  const entryDate = new Date(lastEnteredPreviousStage);
+  const diffTime = Math.abs(now.getTime() - entryDate.getTime());
+  const daysInPreviousStage = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
+
+  return {
+    now: now.toISOString(),
+    daysInPreviousStage: daysInPreviousStage
+  };
+};
+```
+
+3. Configure a entrada do nó de Código: mapeie `lastEnteredPreviousStage` para o campo **Última entrada em Qualificado**
+4. Adicione uma ação de **Atualizar registro**:
+   * Registro: A Oportunidade disparadora
+   * Campos a atualizar:
+     * Última entrada em Reunião = `now`
+     * Dias em Qualificado = `daysInPreviousStage`
+
+---
+
+**Continue para as fases restantes:**
+
+| Etapa             | Registra                          | Calcula            |
+| ----------------- | --------------------------------- | ------------------ |
+| Proposta          | Última entrada em Proposta        | Dias em Reunião    |
+| Negociação        | Última entrada em Negociação      | Dias em Proposta   |
+| Fechado - Ganho   | Última entrada em Fechado Ganho   | Dias em Negociação |
+| Fechado - Perdido | Última entrada em Fechado Perdido | Dias em Negociação |
+
+As ramificações não precisam se reunir — cada uma é executada independentemente quando a condição da sua fase é atendida.
+
+## Etapa 3: Analisar o tempo na fase
+
+Com carimbos de data e hora e contagens de dias registrados, você pode agora analisar a velocidade dos negócios.
+
+### Criar uma visualização "Negócios lentos"
+
+1. Crie uma visualização de Tabela de Oportunidades
+2. Adicione colunas: Nome, Fase, Dias em [fase anterior], Valor
+3. Classifique pelo campo "Dias em" (descendente)
+4. Filtre por Fase para focar em uma fase por vez
+
+Os negócios no topo passaram mais tempo na fase anterior.
+
+### Use agregações
+
+Na sua visualização Kanban do pipeline:
+
+1. Clique no número ao lado do nome de uma Fase
+2. Selecione **Média**
+3. Escolha um campo "Dias em"
+
+Isso mostra o tempo médio que os negócios passam em cada fase.
+
+## Resumo
+
+| Componente                     | Finalidade                                                        |
+| ------------------------------ | ----------------------------------------------------------------- |
+| **Campos "Última entrada em"** | Armazena quando a oportunidade entrou em cada fase                |
+| **Campos "Dias em"**           | Armazena quantos dias foram passados em cada fase                 |
+| **Workflow**                   | Registra o carimbo de data e hora E calcula os dias de uma só vez |
+| **Visualizações e agregações** | Analise a velocidade dos negócios e identifique gargalos          |
+
+## Relacionados
+
+* [Workflows](/l/pt/user-guide/workflows/overview) — noções básicas de automação
+* [Como criar campos personalizados](/l/pt/user-guide/data-model/how-tos/create-custom-fields) — configuração de campos
+* [Visualizações de Kanban](/l/pt/user-guide/views-pipelines/capabilities/kanban-views) — agregações

packages/twenty-docs/l/pt/user-guide/views-pipelines/overview.mdx

@@ -0,0 +1,132 @@
+---
+title: Visualizações e pipelines
+description: Aprenda a criar e gerenciar visualizações no Twenty.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Compreendendo as visualizações
+
+As visualizações são configurações salvas que determinam como seus dados são exibidos. Cada visualização pode ter:
+
+* **Layout**: Tabela, Kanban ou Calendário
+* **Filtros**: quais registros mostrar
+* **Ordenação**: como os registros são ordenados
+* **Campos**: quais colunas ficam visíveis
+
+## Tipos de visualização
+
+### Visualização de tabela
+
+A visualização padrão, semelhante a uma planilha, que mostra registros em linhas com colunas personalizáveis.
+
+### Visualização de Kanban
+
+Uma visualização em quadro onde os registros aparecem como cartões organizados por etapas. Ideal para:
+
+* Pipelines de vendas
+* Acompanhamento de projetos
+* Qualquer fluxo de trabalho com etapas definidas
+
+### Visualização de calendário
+
+Uma visualização de calendário que exibe registros com campos de data. Perfeito para:
+
+* Reuniões e eventos
+* Prazos e datas de vencimento
+* Planejamento baseado em tempo
+
+## Criando uma Visualização
+
+Existem duas maneiras de criar uma nova visualização.
+
+### Use o menu suspenso de visualizações
+
+1. Navegue até qualquer objeto (Pessoas, Empresas, etc.)
+2. Clique no nome da visualização no canto superior esquerdo (mostra a visualização atual com uma seta de menu suspenso)
+3. Clique em **+ Adicionar visualização**
+4. Nomeie sua visualização e clique em **Criar**
+5. Escolha um layout (Tabela, Kanban ou Calendário) em **Opções**
+6. Adicione filtros e ordenação conforme necessário
+7. Selecione quais campos exibir e reordene-os
+8. Clique em **Salvar**
+
+<VimeoEmbed videoId="1145648745" title="Demonstração em vídeo" />
+
+### Comece editando uma visualização existente
+
+1. Navegue até qualquer objeto (Pessoas, Empresas, etc.)
+2. Escolha um layout (Tabela, Kanban ou Calendário) em **Opções** e adicione filtros e ordenação conforme necessário
+3. Clique em **Salvar como nova visualização**
+4. Nomeie sua visualização e clique em **Criar**
+5. Continue editando sua nova visualização
+6. Clique em **Atualizar visualização** para salvar suas configurações adicionais
+
+<VimeoEmbed videoId="1145654005" title="Demonstração em vídeo" />
+
+## Gerenciar visualizações
+
+### Editar uma visualização
+
+1. Selecione a visualização no menu suspenso
+2. Faça suas alterações (filtros, ordenação, colunas)
+3. Clique em **Salvar** para atualizar a visualização
+
+### Renomear uma visualização ou alterar seu ícone
+
+1. Abra o menu suspenso de visualizações
+2. Clique no menu **⋮** ao lado do nome da visualização
+3. Selecione **Editar**
+4. Altere o nome ou o ícone
+5. Clique em **Salvar**
+
+### Reordenar visualizações
+
+1. Abra o menu suspenso de visualizações
+2. Clique e arraste uma visualização pela sua alça
+3. Solte na posição desejada
+4. A nova ordem é salva automaticamente
+
+### Adicionar aos favoritos
+
+Fixe visualizações usadas com frequência para acesso rápido:
+
+1. Abra o menu suspenso de visualizações
+2. Clique no menu **⋮** ao lado de uma visualização
+3. Selecione **Adicionar aos favoritos**
+4. A visualização aparece na sua seção de favoritos
+
+### Excluir uma visualização
+
+1. Selecione a visualização a ser excluída
+2. Clique no menu suspenso de visualizações
+3. Clique no menu **⋮** ao lado da visualização
+4. Selecione **Excluir**
+5. Confirme a exclusão
+
+<Warning>
+Visualizações excluídas não podem ser recuperadas. Certifique-se de que deseja removê-la antes de confirmar.
+</Warning>
+
+## Visibilidade da visualização
+
+Cada visualização (exceto as visualizações padrão "Todos(as) [Nome do objeto]") tem sua própria configuração de visibilidade.
+
+Para alterar a visibilidade:
+
+1. Abra a visualização
+2. Clique em **Opções → Visibilidade**
+3. Escolha:
+   * **Espaço de trabalho**: visível para todos os membros do espaço de trabalho
+   * **Não listada**: visível apenas para você
+
+<Note>
+As visualizações padrão "Todos(as) [Nome do objeto]" não podem ter sua visibilidade alterada.
+</Note>
+
+## Próximos Passos
+
+* [Visualizações de Tabela](/l/pt/user-guide/views-pipelines/capabilities/table-views)
+* [Visualizações de Kanban](/l/pt/user-guide/views-pipelines/capabilities/kanban-views)
+* [Filtros e ordenação](/l/pt/user-guide/views-pipelines/capabilities/filters-and-sorting)
+* [Configurações de visualização](/l/pt/user-guide/views-pipelines/capabilities/view-settings)

packages/twenty-docs/l/pt/user-guide/workflows/capabilities/send-emails-from-workflows.mdx

@@ -0,0 +1,167 @@
+---
+title: Enviar e-mails a partir de Fluxos de Trabalho
+description: Envie e-mails personalizados automaticamente usando ações de Fluxos de Trabalho.
+---
+
+Envie e-mails automaticamente quando eventos específicos ocorrerem no seu CRM — dê boas-vindas a novos contatos, faça acompanhamento de oportunidades ou notifique membros da equipe.
+
+## Pré-requisitos
+
+Antes de enviar e-mails a partir de fluxos de trabalho:
+
+1. Conecte uma conta de e-mail em **Configurações → Contas**
+2. Garanta que a conta tenha as permissões de envio ativadas
+
+## Fluxo de Trabalho de E-mail Básico
+
+### Exemplo: E-mail de boas-vindas para novos contatos
+
+**Objetivo**: Enviar um e-mail de boas-vindas quando uma nova pessoa for adicionada ao CRM.
+
+**Configuração**:
+
+1. **Criar fluxo de trabalho**: Vá até **Configurações → Fluxos de Trabalho** e clique em **+ Novo Fluxo de Trabalho**
+
+2. **Adicionar gatilho**: Selecione **Registro é Criado** → **Pessoas**
+
+3. **Adicionar ação Enviar E-mail**:
+   * Clique em **+** para adicionar uma ação
+   * Selecione **Enviar E-mail**
+   * Configure o e-mail:
+
+| Campo       | Valor                                  |
+| ----------- | -------------------------------------- |
+| **Para**    | `{{trigger.object.email}}`             |
+| **Assunto** | `Bem-vindo ao {{Your Company Name}}`   |
+| **Corpo**   | `Hi {{trigger.object.firstName}}, ...` |
+
+4. **Testar e ativar**: Teste com um registro de exemplo e, em seguida, ative
+
+## Usando variáveis em e-mails
+
+Referencie dados de etapas anteriores usando a sintaxe `{{variable}}`:
+
+```text
+Hi {{trigger.object.firstName}},
+
+Thank you for connecting with us!
+
+Your company, {{trigger.object.company.name}}, is now in our system.
+
+Best regards,
+The Team
+```
+
+### Variáveis disponíveis dos gatilhos
+
+| Tipo de Trigger                | Variáveis comuns                       |
+| ------------------------------ | -------------------------------------- |
+| **Registro Criado/Atualizado** | `{{trigger.object.fieldName}}`         |
+| **Manual**                     | `{{trigger.selectedRecord.fieldName}}` |
+| **Webhook**                    | `{{trigger.body.fieldName}}`           |
+
+## Avançado: E-mails condicionais
+
+### Exemplo: E-mails diferentes com base na origem do lead
+
+**Objetivo**: Enviar e-mails de boas-vindas diferentes com base na origem do lead.
+
+**Configuração**:
+
+1. **Gatilho**: Registro é Criado (Pessoas)
+
+2. **Adicionar ação de Filtro**:
+   * Condição: `{{trigger.object.source}}` é igual a `"Website"`
+   * Se verdadeiro → continue para o e-mail de boas-vindas do site
+
+3. **Ramificação para outras origens**:
+   * Crie ramificações paralelas para origens diferentes
+   * Cada ramificação tem sua própria ação Enviar E-mail
+
+## Envio de e-mails para vários destinatários
+
+### Exemplo: Notificar a equipe quando o negócio for fechado
+
+**Objetivo**: Enviar e-mail ao representante de vendas e ao seu gerente quando uma oportunidade for ganha.
+
+**Configuração**:
+
+1. **Gatilho**: Registro é Atualizado (Oportunidades, Estágio = "Closed Won")
+
+2. **Pesquisar Registros**: Encontre o gerente do proprietário da oportunidade
+
+3. **Enviar E-mail nº 1**: Para o proprietário da oportunidade
+   * Para: `{{trigger.object.owner.email}}`
+   * Assunto: `Congratulations on closing {{trigger.object.name}}!`
+
+4. **Enviar E-mail nº 2**: Para o gerente
+   * Para: `{{searchRecords.manager.email}}`
+   * Assunto: `Deal Won: {{trigger.object.name}}`
+
+## E-mails de acompanhamento agendados
+
+### Exemplo: Acompanhar 3 dias após a reunião
+
+**Objetivo**: Enviar um e-mail de acompanhamento 3 dias após o registro de uma reunião.
+
+**Configuração**:
+
+1. **Gatilho**: Registro é Criado (Atividades, Tipo = "Reunião")
+
+2. **Ação de atraso**: Aguarde 3 dias
+
+3. **Enviar E-mail**:
+   * Para: Participante da reunião
+   * Assunto: Acompanhamento da nossa conversa
+   * Corpo: Referencie detalhes da reunião a partir do gatilho
+
+## Anexos de e-mail
+
+Você pode anexar arquivos a e-mails enviados a partir de fluxos de trabalho. O anexo é um arquivo estático que você faz upload ao configurar o fluxo de trabalho.
+
+### Como adicionar um anexo
+
+1. Na ação **Enviar e-mail**, clique no botão **Anexos**
+2. Clique para fazer upload de um arquivo do seu computador
+3. O arquivo será anexado a todos os e-mails enviados por esta ação
+
+### Casos de Uso Comuns
+
+| Caso de uso                   | Arquivo de exemplo                      |
+| ----------------------------- | --------------------------------------- |
+| **E-mails de boas-vindas**    | Brochura da empresa (PDF)               |
+| **Sequências de integração**  | Guia de primeiros passos                |
+| **Acompanhamentos de Vendas** | Catálogo de produtos ou lista de preços |
+| **Confirmações de evento**    | Detalhes ou agenda do evento            |
+
+<Note>
+Os anexos são estáticos — o mesmo arquivo é enviado a todos os destinatários. Para documentos dinâmicos (como cotações personalizadas), gere e anexe arquivos usando uma [Função Lógica](/l/pt/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty).
+</Note>
+
+## Melhores Práticas
+
+### Conteúdo do e-mail
+
+* Mantenha as linhas de assunto concisas e relevantes
+* Personalize com o nome do destinatário
+* Inclua uma chamada para ação clara
+* Teste os e-mails antes de ativar
+
+### Entregabilidade
+
+* Não envie muitos e-mails muito rapidamente
+* Use assinaturas de e-mail profissionais
+* Evite palavras que acionem spam
+* Garanta opções de cancelamento de inscrição para e-mails de marketing
+
+### Resolução de Problemas
+
+* Verifique se a conta de e-mail está conectada e ativa
+* Verifique se o endereço de e-mail do destinatário é válido
+* Revise as execuções do fluxo de trabalho em busca de mensagens de erro
+* Teste primeiro com o seu próprio endereço de e-mail
+
+## Relacionados
+
+* [Gatilhos de Fluxo de Trabalho](/l/pt/user-guide/workflows/capabilities/workflow-triggers)
+* [Ações de Fluxo de Trabalho](/l/pt/user-guide/workflows/capabilities/workflow-actions)

packages/twenty-docs/l/pt/user-guide/workflows/capabilities/use-branches-in-workflows.mdx

@@ -0,0 +1,88 @@
+---
+title: Use ramificações em fluxos de trabalho
+description: Entenda como as ramificações funcionam e como controlar qual caminho é executado.
+---
+
+## Como as ramificações funcionam
+
+No editor de fluxos de trabalho, você pode criar vários caminhos (ramificações) saindo de um único nó. Isso permite criar automações complexas com resultados diferentes.
+
+**Importante**: Quando um fluxo de trabalho é executado, **todas as ramificações são executadas em paralelo por padrão**. Não há lógica "if/else" integrada para escolher uma ramificação em vez de outra — todos os caminhos serão executados simultaneamente.
+
+## Controlando qual ramificação é executada
+
+Para executar apenas uma ramificação com base em condições específicas, **adicione um nó Filter no início de cada ramificação**.
+
+### Exemplo de configuração
+
+1. Crie seu fluxo de trabalho com várias ramificações a partir de um único nó
+2. Adicione um nó **Filter** como a primeira etapa de cada ramificação
+3. Defina condições em cada Filter para determinar quando essa ramificação deve continuar
+4. Somente as ramificações cujas condições do Filter forem atendidas prosseguirão
+
+### Como funcionam os nós Filter
+
+* Se a condição do Filter for **atendida**: A ramificação continua em execução
+* Se a condição do Filter **não for atendida**: A ramificação para no nó Filter
+
+Isso efetivamente cria uma lógica condicional em que apenas a ramificação apropriada é executada com base nos seus dados.
+
+## Exemplo: Roteamento por tamanho do negócio
+
+**Cenário**: Quando um negócio é fechado, envie notificações diferentes com base no tamanho do negócio.
+
+1. **Gatilho**: Oportunidade atualizada (Estágio = Closed Won)
+2. **Ramificação 1**: Filter para Amount > $10,000 → Enviar mensagem no Slack para #big-deals
+3. **Ramificação 2**: Filter para Amount ≤ $10,000 → Enviar e-mail para o gerente de vendas
+
+Ambas as ramificações iniciam, mas somente aquela que corresponder ao valor do negócio continuará além do seu Filter.
+
+## Criando ramificações
+
+<Note>
+Para criar uma nova ramificação a partir de uma etapa existente, clique no botão **+** na etapa e adicione sua ação. Você pode adicionar várias ramificações clicando em **+** várias vezes.
+</Note>
+
+1. No editor de fluxos de trabalho, selecione a etapa a partir da qual deseja ramificar
+2. Clique no botão **+** para adicionar uma ação
+3. Isso cria uma ramificação
+4. Clique em **+** novamente na mesma etapa para criar ramificações adicionais
+5. Cada ramificação pode ter sua própria sequência de ações
+
+## Unindo ramificações novamente
+
+Depois que as ramificações paralelas concluírem seu trabalho, você pode uní-las novamente em um único caminho:
+
+1. Conclua suas ações ramificadas
+2. Adicione uma nova etapa que deve ser executada após todas as ramificações
+3. Arraste uma conexão da última etapa de cada ramificação para essa nova etapa
+4. A etapa unificada aguarda todas as ramificações conectadas concluírem antes de ser executada
+
+### Exemplo: Processar e depois notificar
+
+```
+Trigger
+   │
+   ├── Branch A: Update Customer Record
+   │
+   └── Branch B: Create Support Ticket
+
+       ↘  ↙
+
+   Merged Step: Send Confirmation Email
+```
+
+O e-mail de confirmação é enviado apenas após a atualização do cliente e a criação do bilhete ser feita.
+
+## Melhores Práticas
+
+* Sempre use **nós Filter** no início das ramificações quando quiser execução condicional
+* Mantenha as condições das ramificações **mutuamente exclusivas** para evitar ações duplicadas
+* Teste seus fluxos de trabalho com dados diferentes para garantir que as ramificações corretas sejam executadas
+* **Renomeie as etapas das ramificações** de forma descritiva para que fique claro o que cada caminho faz
+* **Una as ramificações** quando precisar de uma ação final após o processamento em paralelo
+
+## Relacionados
+
+* [Perguntas frequentes sobre fluxos de trabalho](/l/pt/user-guide/workflows/how-tos/need-more-help/workflows-faq) — respostas sobre execução paralela
+* [Ações de Fluxo de Trabalho](/l/pt/user-guide/workflows/capabilities/workflow-actions) — ações disponíveis para ramificações

packages/twenty-docs/l/pt/user-guide/workflows/capabilities/use-iterator.mdx

@@ -0,0 +1,183 @@
+---
+title: Usar Iterador
+description: Percorra arrays de registos para executar ações em cada item.
+---
+
+O Iterador permite percorrer um array de registos e executar ações em cada um. É essencial para fluxos de trabalho que precisam de processar vários registos devolvidos por Pesquisar Registos ou recebidos via Webhooks.
+
+## Quando usar o Iterador
+
+| Cenário                              | Exemplo                                          |
+| ------------------------------------ | ------------------------------------------------ |
+| **Processar resultados da pesquisa** | Enviar e-mail a cada pessoa encontrada           |
+| **Lidar com arrays de Webhooks**     | Criar registos para cada item por ordem          |
+| **Atualizações em massa**            | Atualizar vários registos com valores calculados |
+| **Notificações**                     | Alertar várias pessoas sobre um evento           |
+
+## Compreender o Iterador
+
+O Iterador espera um **array** como entrada. Em seguida:
+
+1. Obtém o primeiro item do array
+2. Executa todas as ações dentro do Iterador com esse item
+3. Passa para o item seguinte
+4. Repete até que todos os itens sejam processados
+
+### Selecionar o array para iterar
+
+A maioria das origens de arrays (Search Records, um campo de array de webhook, um gatilho manual em massa) pode ser selecionada diretamente no seletor de variáveis.
+
+Quando uma etapa de **Code** ou **Logic Function** retorna um *array de nível superior*, sua saída aparece no seletor de variáveis como entradas indexadas (`0`, `1`, `2`, …). Para iterar sobre o array como um todo, selecione a opção **Whole list** para essa etapa — o Iterator então deduz automaticamente o formato de cada item a partir da lista.
+
+## Configuração básica
+
+### Exemplo: Enviar e-mail a todos nos resultados da pesquisa
+
+**Objetivo**: Encontrar todos os contactos numa empresa específica e enviar a cada um um e-mail personalizado.
+
+### Etapa 1: Pesquisar registos
+
+1. Adicione a ação **Pesquisar Registos**
+2. Objeto: **Pessoas**
+3. Filtro: Empresa igual a "Acme Inc"
+4. Isto devolve um array de pessoas
+
+### Etapa 2: Verificar se existem resultados
+
+1. Adicione a ação **Filtro**
+2. Condição: `{{searchRecords.length}}` é maior do que 0
+3. Isto evita erros do Iterador em resultados vazios
+
+### Etapa 3: Adicionar um Iterador
+
+1. Adicione a ação **Iterador**
+2. Entrada do array: selecione `{{searchRecords}}`
+3. Isto cria um ciclo
+
+### Etapa 4: Adicionar ações dentro do Iterador
+
+As ações colocadas após o Iterador são executadas para cada item:
+
+1. Adicione a ação **Enviar e-mail** (dentro do Iterador)
+2. Para: `{{iterator.currentItem.email}}`
+3. Assunto: Olá `{{iterator.currentItem.firstName}}`!
+4. Corpo: Mensagem personalizada utilizando os campos do item atual
+
+### Resultado
+
+Se Pesquisar Registos devolver 5 pessoas, o Iterador:
+
+* Envia e-mail para a pessoa 1
+* Envia e-mail para a pessoa 2
+* ... continua para todas as 5
+
+## Aceder aos dados do item atual
+
+Dentro do Iterador, use `{{iterator.currentItem}}` para aceder ao registo atual:
+
+| Variável                                | Descrição                       |
+| --------------------------------------- | ------------------------------- |
+| `{{iterator.currentItem}}`              | Todo o objeto do registo atual  |
+| `{{iterator.currentItem.id}}`           | ID do registo                   |
+| `{{iterator.currentItem.email}}`        | Campo de e-mail                 |
+| `{{iterator.currentItem.company.name}}` | Nome da empresa relacionada     |
+| `{{iterator.index}}`                    | Posição atual no array (base 0) |
+
+No seletor de variáveis, você pode detalhar um campo específico do item atual ou escolher **Use the whole item** para fazer referência ao item atual inteiro (`{{iterator.currentItem}}`). Selecionar o item inteiro é útil quando você quer passar um registro completo diretamente para uma etapa subsequente, em vez de reconstruí-lo campo por campo.
+
+## Padrões comuns
+
+### Atualizar vários registos
+
+**Objetivo**: Marcar todas as tarefas em atraso como "Late"
+
+```
+1. Search Records (Tasks, Due Date < Today, Status ≠ Completed)
+2. Filter (length > 0)
+3. Iterator (searchRecords)
+   └── Update Record
+       - Object: Tasks
+       - Record: {{iterator.currentItem.id}}
+       - Status: Late
+```
+
+### Criar registos a partir de um array
+
+**Objetivo**: O Webhook recebe um pedido com vários itens, criar um registo para cada um
+
+```
+1. Webhook Trigger (receives items array)
+2. Filter (items.length > 0)
+3. Iterator (trigger.body.items)
+   └── Create Record
+       - Object: Order Items
+       - Name: {{iterator.currentItem.name}}
+       - Quantity: {{iterator.currentItem.qty}}
+       - Related Order: {{trigger.body.orderId}}
+```
+
+### Processamento condicional dentro do ciclo
+
+**Objetivo**: Enviar e-mail apenas para contactos com e-mails válidos
+
+```
+1. Search Records (People)
+2. Iterator (searchRecords)
+   └── Filter (currentItem.email is not empty)
+       └── Send Email
+           - To: {{iterator.currentItem.email}}
+```
+
+## Resolução de Problemas
+
+### "O Iterador espera um array"
+
+**Causa**: Passou um único registo em vez de um array.
+
+**Correção**: Certifique-se de que está a passar o resultado de Pesquisar Registos ou um campo do tipo array, e não um único registo.
+
+```
+✅ Correct: {{searchRecords}}
+❌ Wrong: {{searchRecords[0]}}
+```
+
+### O Iterador não é executado
+
+**Causa**: O array está vazio.
+
+**Correção**: Adicione um Filtro antes do Iterador para verificar o tamanho do array:
+
+```
+Filter: {{searchRecords.length}} > 0
+```
+
+### Ações executadas vezes demais
+
+**Causa**: Pesquisar Registos devolveu mais registos do que o esperado.
+
+**Correção**:
+
+* Adicione filtros mais específicos a Pesquisar Registos
+* Defina um limite em Pesquisar Registos (máx. 200)
+* Adicione um Filtro dentro do Iterador para condições adicionais
+
+## Considerações de desempenho
+
+* **Utilização de créditos**: Cada iteração consome créditos pelas suas ações
+* **Tempo**: Arrays grandes demoram mais a processar
+* **Limites**: Considere agrupar em lotes operações muito grandes
+* **Limites de taxa**: Chamadas a APIs externas podem atingir limites de taxa com muitas iterações
+
+## Melhores Práticas
+
+1. **Verifique sempre o tamanho do array** antes do Iterador para evitar erros
+2. **Adicione filtros dentro dos ciclos** quando nem todos os itens precisam de processamento
+3. **Renomeie a etapa do seu Iterador** para descrever o que está a percorrer
+4. **Teste com arrays pequenos** antes de processar conjuntos de dados grandes
+5. **Monitorize as execuções dos fluxos de trabalho** para garantir que as iterações se concluam conforme o esperado
+
+## Relacionados
+
+* [Ações de Fluxo de Trabalho](/l/pt/user-guide/workflows/capabilities/workflow-actions)
+* [Como usar ramificações](/l/pt/user-guide/workflows/capabilities/use-branches-in-workflows)
+* [FAQ de Fluxos de Trabalho](/l/pt/user-guide/workflows/how-tos/need-more-help/workflows-faq)

packages/twenty-docs/l/pt/user-guide/workflows/capabilities/workflow-actions.mdx

@@ -0,0 +1,332 @@
+---
+title: Ações de Fluxo de Trabalho
+description: Saiba mais sobre as ações disponíveis nos fluxos de trabalho do Twenty.
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Sobre as Ações
+
+As ações definem o que acontece após um gatilho ser acionado. Você pode encadear várias ações para criar automações complexas.
+
+<Tip>
+* Use o seletor de variáveis (clique no ícone `(x+)`) para explorar os dados disponíveis de etapas anteriores
+* Passe o cursor sobre qualquer campo de entrada para ver de qual etapa uma variável vem — útil quando o mesmo campo (por exemplo, ID) existe em várias etapas anteriores
+* Dê a cada ação um nome descritivo para facilitar a manutenção
+</Tip>
+
+## Ações em Registros
+
+<img src="/images/user-guide/workflows/workflow_actions.png" style={{width:'100%'}} />
+
+### Criar Registro
+
+Adiciona um novo registro a um objeto selecionado.
+
+**Configuração**:
+
+* Selecione o objeto alvo
+* Preencha os campos obrigatórios e opcionais
+* Use dados de etapas anteriores ou insira valores manualmente para preencher os campos
+
+**Saída**: Os dados do registro recém-criado estão disponíveis para uso em etapas subsequentes.
+
+### Atualizar Registro
+
+Modifica um registro existente em um objeto selecionado.
+
+<img src="/images/user-guide/workflows/update_record.png" style={{width:'100%'}} />
+
+**Configuração**:
+
+* Selecione o objeto alvo
+* Escolha o registro específico para atualizar.
+  * Você pode escolher um registro fixo, usando o menu suspenso que exibe todos os registros disponíveis.
+  * Ou você pode fazer com que o registro seja selecionado dinamicamente, designando um registro encontrado em uma etapa anterior, usando o `(x+)`. Você não pode pesquisar o registro com base em critérios diferentes nesta etapa. Se você ainda não identificou o registro, adicione uma etapa `Search Record` antes desta etapa `Update Record`.
+* Selecione campos para modificar e insira novos valores
+
+**Saída**: Os dados do registro atualizado estão disponíveis para uso em etapas subsequentes.
+
+### Excluir Registro
+
+Remove um registro de um objeto selecionado.
+
+**Configuração**:
+
+* Selecione o objeto alvo
+* Escolha o registro específico para excluir
+
+**Saída**: Os dados do registro excluído permanecem disponíveis para uso em etapas subsequentes.
+
+### Pesquisar Registros
+
+Encontra registros dentro de um objeto selecionado usando condições de filtro.
+
+**Configuração**:
+
+* Selecione o objeto para pesquisar
+* Defina critérios de filtro para restringir os resultados
+* Configurar ordenação e limites
+
+**Saída**: Retorna registros correspondentes que podem ser usados em etapas subsequentes.
+
+<Note>
+**Limite**: Search Records retorna no máximo **200 registros**. Se você precisar processar mais, adicione filtros específicos para reduzir os resultados ou use fluxos de trabalho agendados para processar em lotes.
+</Note>
+
+**Melhor prática**: Use [ramificações](/l/pt/user-guide/workflows/capabilities/workflow-branches) após Search Records para lidar com os cenários "encontrado" vs "não encontrado".
+
+### Upsert Record
+
+Cria um novo registro ou atualiza um existente com base em critérios de correspondência. Isso é útil quando você não tem certeza se um registro já existe.
+
+<img src="/images/user-guide/workflows/upsert_double_identifier.png" style={{width:'100%'}} />
+
+**Configuração**:
+
+* Selecione o objeto alvo
+* Observe quais campos podem ser usados para correspondência: e-mail para Pessoas, domínio para Empresas, ID para qualquer objeto ou qualquer campo marcado como Único. Você precisará preencher pelo menos um destes abaixo.
+* Preencha os valores dos campos. Não se esqueça de preencher pelo menos um dos identificadores únicos.
+
+<Note>
+**A correspondência geralmente funciona ainda melhor ao adicionar apenas um identificador único.** Por exemplo, a captura de tela abaixo fará a correspondência de empresas com base no domínio delas. O ID não é necessariamente obrigatório.
+</Note>
+
+<img src="/images/user-guide/workflows/upsert_simple_identifier.png" style={{width:'100%'}} />
+
+* Use dados de etapas anteriores para preencher os campos
+
+**Como Funciona**:
+
+1. Procura um registro que corresponda aos seus critérios
+2. Se encontrado → atualiza o registro existente
+3. Se não encontrado → cria um novo registro
+
+**Saída**: Os dados do registro criado ou atualizado estão disponíveis para uso em etapas subsequentes.
+
+## Ações de Fluxo
+
+### Iterador
+
+**Percorre um array de registros** retornados de uma etapa anterior, permitindo que você execute ações em cada registro individualmente.
+
+**Configuração**:
+
+* Selecione o array de registros de uma etapa anterior (por exemplo, resultados de Search Records, de um gatilho manual com disponibilidade em lote ou de um nó de código). Quando uma etapa de código ou de função lógica retorna um array de nível superior, selecione a opção **Whole list** para iterar por toda a saída.
+* Defina as ações a serem realizadas em cada registro no loop.
+
+<Note>
+- Você pode adicionar várias ações dentro de um iterador.
+- Ao usar ramificações dentro de um iterador, certifique-se de que a última etapa de cada ramificação se conecte de volta ao iterador para fechar o loop.
+</Note>
+
+* Acesse os campos de `Current Item`: para usar campos do registro que está sendo processado no momento, clique na etapa **Iterator** e, em seguida, selecione **Current item**. A lista de campos disponíveis desse registro será exibida e poderá ser selecionada para uso em ações subsequentes. Você também pode selecionar **Use the whole item** para passar o item atual inteiro para uma etapa posterior.
+
+<VimeoEmbed videoId="1146577247" title="Demonstração em vídeo" />
+
+### Filtro
+
+Filtra registros com base em condições especificadas, permitindo que apenas os registros que atendam aos critérios passem.
+
+**Configuração**:
+
+* Selecione o registro a ser filtrado
+* Defina condições e critérios de filtro
+* Configure quais registros devem passar para as etapas subsequentes
+
+<Note>
+1. **Saída**: Nós de filtro não retornam dados — eles atuam como portões. Se as condições forem atendidas, o fluxo de trabalho continua. Caso contrário, o fluxo de trabalho para nessa ramificação.
+2. O operador `IS` pode ser usado com campos numéricos. Ele funciona como um `EQUAL`.
+</Note>
+
+### Atraso
+
+Pausa a execução do fluxo de trabalho por uma duração especificada ou até uma data/hora específica.
+
+**Tipos de Atraso**:
+
+| Tipo                | Descrição                                                               |
+| ------------------- | ----------------------------------------------------------------------- |
+| **Duração**         | Aguarda um período específico de tempo (dias, horas, minutos, segundos) |
+| **Data Programada** | Aguarda até uma data e hora específicas                                 |
+
+**Configuração para Duração**:
+
+* Defina dias, horas, minutos e/ou segundos
+* Combine várias unidades (por exemplo, 2 dias e 4 horas)
+
+**Configuração para Data Programada**:
+
+* Selecione uma data e hora
+* Pode referenciar um campo de data de uma etapa anterior (por exemplo, fazer um acompanhamento 3 dias após uma reunião)
+
+**Casos de uso**:
+
+* Aguarde 24 horas antes de enviar um e-mail de acompanhamento
+* Aguarde até a data de fechamento de uma oportunidade
+* Agende ações para o horário comercial
+
+<Note>
+A data programada não pode estar no passado. Se for usado um campo de data de uma etapa anterior e a data já tiver passado, o fluxo de trabalho falhará.
+</Note>
+
+**Limites e Créditos**:
+
+* **Sem limite máximo de duração** — você pode definir atrasos de minutos, dias, semanas ou mais longos
+* **1 crédito consumido** quando o nó de Atraso é executado, independentemente da duração
+* **Nenhum crédito consumido** durante a espera — um atraso de 5 minutos custa o mesmo que um atraso de 5 dias
+
+## Ações de Comunicação
+
+### Enviar Email
+
+Envia um email a partir do seu fluxo de trabalho. Isso é ótimo para e-mails de grupo com modelos. Os e-mails terão a mesma aparência dos que você envia da sua caixa de correio.
+Não é adequado para newsletters (que exigem formatação mais rica) ou sequências automáticas de e-mails.
+
+**Pré-requisitos**: Adicione uma conta de e-mail em Configurações → Contas
+
+**Configuração**:
+
+* Selecione a conta de e-mail do remetente
+
+<Note>
+Você só pode enviar e-mails de caixas de correio sincronizadas com a sua própria conta Twenty. O envio a partir das caixas de correio de outros membros da equipe (por exemplo, o e-mail do proprietário da conta) está no roadmap.
+</Note>
+
+Para todas as etapas a seguir, você pode referenciar variáveis de etapas anteriores para personalização.
+
+* Insira o endereço de email do destinatário.
+
+<Note>
+No momento, é possível apenas um destinatário.
+</Note>
+
+* Defina o assunto.
+* Componha o corpo da mensagem. Você pode formatar links, criar listas numeradas, listas com marcadores e adicionar anexos.
+
+<Note>
+Adicionar assinaturas em HTML não é possível no momento.
+</Note>
+
+### Formulário
+
+Apresenta um formulário durante a execução do fluxo de trabalho para coletar a entrada do usuário. As respostas podem então ser usadas em etapas subsequentes para criar registros, enviar e-mails ou executar qualquer outra ação com base na entrada.
+
+<Warning>
+**Os formulários são projetados apenas para gatilhos manuais**. Para fluxos de trabalho com outros gatilhos (Registro Criado, Atualizado, etc.), os formulários só são acessíveis via a interface de execução do fluxo de trabalho, o que não é a experiência esperada do usuário. Um centro de notificações será lançado em 2026 para suportar adequadamente os formulários em fluxos de trabalho automatizados.
+</Warning>
+
+**Configuração**:
+
+* Configure os campos que os usuários deverão preencher. Para cada campo, escolha
+  * um tipo entre texto, número, data, um determinado registro, um campo de seleção. Os campos de todos os objetos estão disponíveis para seleção.
+  * um rótulo
+  * um valor padrão em `Placeholder` (opcional)
+* Edite o título do formulário
+
+**Saída**: Respostas do formulário estão disponíveis para uso em etapas subsequentes.
+
+**Exemplo**: O fluxo de trabalho "Quick Lead" está disponível por padrão em todos os espaços de trabalho, disponível em qualquer lugar no Menu de Comando `Cmd+K`.
+
+**Como preencher o formulário**:
+
+* Acione seu fluxo de trabalho manual a partir do Menu de Comando `Cmd+K`
+* Preencha o formulário exibido no painel lateral e clique em `Submit`.
+
+<Note>
+Os campos não podem ser tornados obrigatórios.
+</Note>
+
+<VimeoEmbed videoId="1147277989" title="Demonstração em vídeo" />
+
+## Ações de Integração
+
+### Código
+
+Executa JavaScript personalizado dentro do seu fluxo de trabalho.
+
+Nos bastidores, cada ação de código é respaldada por sua própria **função lógica** — uma função TypeScript do lado do servidor que é executada na plataforma Twenty. Quando você adiciona uma ação de código, o Twenty cria uma função lógica dedicada para essa etapa e exibe seu editor em linha, de modo que o código que você escreve fica junto com o fluxo de trabalho.
+
+**Configuração**:
+
+* Acesse variáveis de etapas anteriores. Você pode editar os nomes das variáveis dinamicamente.
+
+<VimeoEmbed videoId="1147281795" title="Demonstração em vídeo" />
+
+* Escreva o código JavaScript no editor
+* Retorne variáveis para uso em etapas subsequentes
+* Teste o código diretamente na etapa
+
+<Note>
+Se você precisar usar chaves de API externas em seu código, deverá inseri-las diretamente no corpo da função. Você não pode configurar chaves de API em outro lugar e referenciá-las na função de lógica.
+</Note>
+
+<Tip>
+**Trabalhando com arrays?** Arrays de sistemas externos ou de etapas anteriores podem vir como strings. Veja [Como lidar com arrays em ações de código](/l/pt/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions) para a solução.
+</Tip>
+
+<Tip>
+Clique no ícone quadrado no canto superior direito do editor de código para exibi-lo em tela cheia — útil, já que a largura padrão do editor é limitada.
+</Tip>
+
+#### Reutilizar uma função lógica em vários fluxos de trabalho
+
+A ação de código em linha é ótima para lógica pontual, mas o código que ela contém pertence apenas àquela etapa. Quando você quiser compartilhar a mesma lógica em vários fluxos de trabalho — ou mantê-la como código-fonte versionado em um aplicativo — defina uma **função lógica reutilizável** em vez de copiar e colar código em cada ação de código.
+
+Uma função lógica é definida uma vez em um aplicativo (usando o `defineLogicFunction` do SDK) e exposta ao construtor de fluxos de trabalho ao adicionar `workflowActionTriggerSettings`. Depois que seu aplicativo é instalado, essa função aparece como uma ação própria no construtor de fluxos de trabalho, ao lado das ações nativas. Ao selecioná-la, são renderizados os campos de entrada que você declarou (com seletores de variáveis, assim como outras ações) e o seu código compartilhado é executado — sem necessidade de JavaScript inline.
+
+|                        | Ação de código                                              | Função lógica reutilizável                                           |
+| ---------------------- | ----------------------------------------------------------- | -------------------------------------------------------------------- |
+| **Onde o código fica** | Editor em linha, vinculado a uma etapa do fluxo de trabalho | Definida em um app, versionada no controle de código-fonte           |
+| **Reutilização**       | Copiada e colada em cada etapa                              | Adicionada como uma ação em qualquer fluxo de trabalho               |
+| **Entradas**           | Variáveis conectadas no editor                              | Campos renderizados a partir do esquema de entrada que você declarou |
+| **Melhor para**        | Lógica rápida e específica do fluxo de trabalho             | Lógica compartilhada usada em vários fluxos de trabalho              |
+
+Ambas são executadas no mesmo tempo de execução da função lógica; portanto, uma ação de código que você prototipou em linha pode posteriormente ser promovida a uma função lógica reutilizável com mudanças mínimas.
+
+<Tip>
+Para a documentação de referência voltada para desenvolvedores sobre como definir funções lógicas e expô-las no construtor de fluxos de trabalho, consulte [Logic Functions](/l/pt/developers/extend/apps/logic/logic-functions) — em particular a seção **Exposing a function as an AI tool or workflow action** e `workflowActionTriggerSettings`.
+</Tip>
+
+### Requisição HTTP
+
+Envia uma solicitação para uma API externa como parte do seu fluxo de trabalho.
+
+<img src="/images/user-guide/workflows/http_action.png" style={{width:'100%'}} />
+
+**Configuração**:
+
+* Insira a URL do endpoint da API. É possível usar parâmetros de etapas anteriores.
+* Selecione o método HTTP (GET, POST, PUT, PATCH, DELETE)
+* Adicione cabeçalhos e valores obrigatórios
+* Forneça resposta de amostra para visualização da estrutura
+
+## Ações de IA
+
+### Agente de IA - Em breve
+
+Executa um agente de IA dentro do seu fluxo de trabalho para realizar tarefas inteligentes.
+
+**Configuração**:
+
+* **Agente**: Selecione um agente de IA existente ou use o agente padrão
+* **Prompt**: Escreva a instrução para o agente de IA
+* Referencie variáveis de etapas anteriores no prompt
+
+**O que os Agentes de IA podem fazer**:
+
+* Analisar e resumir dados
+* Classificar ou categorizar registros
+* Gerar conteúdo de texto
+* Tomar decisões com base em dados
+* Interagir com seus dados de CRM usando ferramentas
+
+**Saída**: A resposta do agente de IA está disponível para uso em etapas subsequentes. Se o agente tiver um esquema de saída estruturado, a resposta seguirá esse formato.
+
+<Note>
+As ações do Agente de IA consomem créditos de fluxo de trabalho com base no modelo de IA usado. Veja [Créditos de Fluxo de Trabalho](/l/pt/user-guide/workflows/capabilities/workflow-credits) para obter detalhes.
+</Note>
+
+<Note>
+Os agentes de IA respeitam permissões baseadas em funções. Você pode atribuir funções específicas aos agentes em **Configurações → Membros → Funções** para controlar a quais dados eles podem acessar. Veja [Permissões](/l/pt/user-guide/permissions-access/capabilities/permissions) para obter detalhes.
+</Note>

packages/twenty-docs/l/pt/user-guide/workflows/capabilities/workflow-branches.mdx

@@ -0,0 +1,66 @@
+---
+title: Ramificações de Fluxo de Trabalho
+description: Crie caminhos paralelos e lógica condicional em seus fluxos de trabalho.
+---
+
+As ramificações permitem dividir seu fluxo de trabalho em vários caminhos que podem ser executados simultaneamente ou condicionalmente com base em seus dados.
+
+<img src="/images/user-guide/workflows/branches.png" style={{width:'100%'}} />
+
+## Como as Ramificações Funcionam
+
+Quando você cria várias conexões a partir de um único nó, cada caminho se torna uma ramificação. Por padrão, **todas as ramificações são executadas em paralelo**—elas não esperam umas pelas outras.
+
+## Criando Ramificações
+
+### Adicionar uma Nova Ramificação
+
+1. **Clique com o botão direito na tela principal** do fluxo de trabalho (não em um nó existente)
+2. Clique em **Adicionar nó**
+3. Escolha o tipo de nó para sua nova ramificação
+4. Arraste uma seta da parte inferior da etapa anterior para o topo desta nova ação
+5. Repita para adicionar mais ramificações a partir do mesmo nó
+
+<Note>
+Cada ramificação é independente. Adicionar uma ramificação não afeta outros caminhos existentes desse nó.
+</Note>
+
+### Layout Visual
+
+As ramificações aparecem como caminhos paralelos no editor de fluxo de trabalho. Você pode arrastar nós para reorganizar o layout visual sem afetar a execução.
+
+## Ramificações Condicionais
+
+Como todas as ramificações são executadas por padrão, use nós **Filtro** para controlar quais caminhos realmente serão executados:
+
+| Ramificação | Condição de Filtro   | Ação                           |
+| ----------- | -------------------- | ------------------------------ |
+| A           | Etapa = "Ganha"      | Enviar e-mail de parabéns      |
+| B           | Etapa = "Perdida"    | Criar tarefa de acompanhamento |
+| C           | Etapa = "Negociação" | Notificar o gerente            |
+
+1. Crie ramificações a partir do seu gatilho ou ação
+2. Adicione um nó **Filtro** como a primeira etapa de cada ramificação
+3. Configure cada filtro com condições mutuamente exclusivas
+4. Adicione suas ações após cada filtro
+
+Apenas as ramificações em que a condição do filtro for atendida continuarão a ser executadas.
+
+## Mesclando Ramificações
+
+**As ramificações não se mesclam automaticamente.** Cada ramificação é executada de forma independente até terminar. Você tem total flexibilidade em como lidar com isso:
+
+* **Opção 1: Manter ramificações separadas**
+  Cada ramificação lida com suas próprias ações de acompanhamento de forma independente. Esta é a abordagem mais simples quando as ramificações não precisam convergir.
+
+* **Opção 2: Mesclar ramificações manualmente**
+  Ao criar seu fluxo de trabalho, você pode conectar manualmente várias ramificações à mesma ação subsequente. Basta arrastar setas do final de cada ramificação para um nó comum.
+
+<Note>
+Embora você possa usar um nó [Atraso](/l/pt/user-guide/workflows/capabilities/workflow-actions#delay) para pausar a execução, atualmente não é possível configurá-lo para esperar "até que outra ramificação termine".
+</Note>
+
+## Relacionados
+
+* [Como usar ramificações em Fluxos de Trabalho](/l/pt/user-guide/workflows/capabilities/use-branches-in-workflows) - Guia passo a passo
+* [Ações de Fluxo de Trabalho](/l/pt/user-guide/workflows/capabilities/workflow-actions) - Ações disponíveis, incluindo Filtro

packages/twenty-docs/l/pt/user-guide/workflows/capabilities/workflow-credits.mdx

@@ -0,0 +1,75 @@
+---
+title: Créditos de Fluxo de Trabalho
+description: Entenda o consumo e o gerenciamento de créditos de fluxo de trabalho.
+---
+
+Os créditos de fluxo de trabalho alimentam suas automações no Twenty. Entender como eles funcionam ajuda você a otimizar custos e gerenciar seu orçamento de automação de maneira eficaz.
+
+## Alocação de créditos
+
+Os créditos de fluxo de trabalho são alocados com base no seu ciclo de faturamento, não no seu nível de plano:
+
+| Ciclo de faturamento  | Créditos            |
+| --------------------- | ------------------- |
+| **Assinatura mensal** | 5 créditos por mês  |
+| **Assinatura anual**  | 50 créditos por ano |
+
+<Note>
+5 créditos mensais são generosos para automações padrão. A maioria das equipes não excederá esse limite com o uso típico de fluxos de trabalho. Créditos adicionais são necessários principalmente para ações de Code avançadas e fluxos de trabalho com tecnologia de IA.
+</Note>
+
+## Como Funciona o Consumo de Créditos
+
+Os créditos são consumidos quando os fluxos de trabalho são executados, não quando você os cria. Cada ação de fluxo de trabalho consome créditos com base em sua complexidade:
+
+### Consumo de Créditos por Tipo de Ação
+
+* **Operações internas básicas**: Consumo de créditos muito baixo
+  * Pesquisar Registros
+  * Criar Registro
+  * Atualizar Registro
+  * Excluir Registro
+  * Ações de formulário
+
+* **Operações complexas**: Maior consumo de créditos
+  * Ações de código (execução de JavaScript)
+  * Solicitações HTTP para serviços externos
+
+* **Recursos de IA**: Maior consumo de créditos
+  * As ações do Agente de IA consomem créditos com base no modelo de IA usado
+  * Prompts mais complexos e saídas mais longas consomem mais créditos
+
+* **Ações de Delay**: Consumo mínimo de créditos
+  * O nó Delay consome **1 crédito** quando é executado
+  * **Nenhum crédito é consumido** durante o período de espera
+  * Um atraso de 5 minutos custa o mesmo que um atraso de 5 dias
+
+### Dedução em Tempo Real
+
+Os créditos são deduzidos em tempo real à medida que os fluxos de trabalho são executados. Isso significa:
+
+* Fluxos de trabalho em rascunho não consomem créditos
+* Apenas fluxos de trabalho ativos e em execução usam sua alocação de crédito
+* Fluxos de trabalho com falha ainda consomem créditos para etapas concluídas
+
+## Gerenciamento de Créditos
+
+### Verificar Uso de Créditos
+
+1. Vá para **Configurações → Faturamento**
+2. Veja o seu consumo atual de créditos e o saldo restante
+3. Monitore padrões de uso para otimizar seus fluxos de trabalho
+
+### Compra de Créditos Adicionais
+
+Se você precisar de mais créditos além da alocação do seu plano:
+
+1. Vá para **Configurações → Faturamento**
+2. Clique na opção para comprar créditos adicionais. Pacotes de diferentes tamanhos estão disponíveis.
+3. Os créditos são adicionados ao seu saldo atual
+
+## Melhores Práticas
+
+* **Processamento em Lote**: Use operações em massa e ações de Iterador de forma eficiente para reduzir chamadas de ações individuais
+* **Otimização de Gatilhos Manuais**: Para gatilhos manuais, escolha a disponibilidade `Em Massa` para processar vários registros em uma única execução de fluxo de trabalho
+* Otimize as ações de código para eficiência

packages/twenty-docs/l/pt/user-guide/workflows/capabilities/workflow-runs.mdx

@@ -0,0 +1,93 @@
+---
+title: Execuções de Workflow
+description: Monitore e gerencie as execuções de fluxos de trabalho.
+---
+
+## Sobre Execuções
+
+Uma **Execução** é um registro de uma execução de fluxo de trabalho. Sempre que um fluxo de trabalho é acionado — seja por um evento de registro, agendamento, ação manual ou webhook — uma nova execução é criada.
+
+## Visualizando Execuções
+
+### No Editor de Fluxo de Trabalho
+
+1. Abra o fluxo de trabalho que você deseja monitorar
+2. Clique no painel **Execuções** no lado direito
+3. Veja uma lista de execuções recentes com seus status
+
+### Na Visualização de Execuções de Fluxo de Trabalho
+
+1. Vá para **Execuções de Fluxo de Trabalho** na barra lateral
+2. Veja execuções em todos os fluxos de trabalho
+3. Filtre por status, fluxo de trabalho ou data
+
+## Status das Execuções
+
+| Estado         | Descrição                                                                                                  |
+| -------------- | ---------------------------------------------------------------------------------------------------------- |
+| **Executando** | O fluxo de trabalho está em execução no momento                                                            |
+| **Concluído**  | O fluxo de trabalho foi concluído com êxito                                                                |
+| **Falhou**     | O fluxo de trabalho encontrou um erro e foi interrompido                                                   |
+| **Aguardando** | O fluxo de trabalho está em pausa (por exemplo, aguardando uma ação de Atraso ou o envio de um Formulário) |
+
+## Detalhes da Execução
+
+Clique em qualquer execução para ver:
+
+* **Status**: Estado atual da execução
+* **Iniciado em**: Quando a execução começou
+* **Duração**: Quanto tempo a execução levou
+* **Dados do gatilho**: A entrada que iniciou o fluxo de trabalho
+* **Saídas das etapas**: Dados retornados por cada etapa
+* **Mensagens de erro**: Se a execução falhou, o que deu errado
+
+## Execução passo a passo
+
+Cada execução mostra o progresso ao longo do seu fluxo de trabalho:
+
+1. Veja quais etapas foram concluídas com êxito
+2. Identifique onde ocorreram falhas
+3. Veja os dados passados entre as etapas
+4. Depure problemas examinando as entradas e saídas das etapas
+
+## Tratamento de Erros
+
+Quando uma execução falha:
+
+1. Abra a execução com falha
+2. Encontre a etapa que causou a falha
+3. Verifique a mensagem de erro para obter detalhes
+
+Problemas comuns:
+
+* Campos obrigatórios ausentes
+* Formato de dados inválido
+* Erros de API externa
+* Problemas de permissão
+
+## Reexecutando fluxos de trabalho
+
+Se uma execução falhar, você pode:
+
+* Corrija o problema subjacente e aguarde o próximo gatilho
+* Para fluxos de trabalho manuais, acione novamente com os mesmos dados ou dados atualizados
+* Revise a lógica do fluxo de trabalho para evitar falhas futuras
+
+## Dicas de desempenho
+
+### Gerenciando o histórico de execuções
+
+* As execuções são mantidas para referência histórica
+* Execuções muito antigas podem ser arquivadas automaticamente
+* Exporte os dados da execução se precisar manter registros
+
+### Melhores práticas de monitoramento
+
+* Verifique as execuções regularmente após ativar novos fluxos de trabalho
+* Revise as execuções com falha para identificar padrões
+
+## Relacionados
+
+* [Gatilhos de Fluxo de Trabalho](/l/pt/user-guide/workflows/capabilities/workflow-triggers)
+* [Ações de Fluxo de Trabalho](/l/pt/user-guide/workflows/capabilities/workflow-actions)
+* [Solução de Problemas de Fluxo de Trabalho](/l/pt/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting)

packages/twenty-docs/l/pt/user-guide/workflows/capabilities/workflow-triggers.mdx

@@ -0,0 +1,137 @@
+---
+title: Gatilhos de Fluxo de Trabalho
+description: Conheça os diferentes gatilhos que iniciam os seus fluxos de trabalho.
+---
+
+## Sobre os Gatilhos
+
+Os fluxos de trabalho sempre começam com um único gatilho que define quando a automação deve ser executada.
+
+<img src="/images/user-guide/workflows/workflow_triggers.png" style={{width:'100%'}} />
+
+<Tip>
+**Objetos avançados são suportados!** Além dos objetos padrão de CRM (Pessoas, Empresas, Oportunidades), você também pode acionar fluxos de trabalho e executar ações em:
+* Membros do Workspace
+* Eventos de Calendário
+* Mensagens (E-mails)
+* Tarefas, Notas e muitos outros objetos do sistema
+
+Isso possibilita automações poderosas, como notificar membros da equipe quando eventos de calendário são criados ou processar automaticamente e-mails recebidos.
+</Tip>
+
+## Registro é Criado
+
+Inicia o fluxo de trabalho quando um novo registro é criado em um objeto selecionado (Pessoas, Empresas, Oportunidades ou qualquer objeto personalizado).
+
+**Configuração**: Selecione o tipo de objeto para monitorar novos registros.
+
+<Note>
+* Este gatilho é ótimo para registros criados por CSV, caixa de correio e sincronização de calendário, ou API.
+* **Não é recomendado para registros criados manualmente**: com este gatilho, os fluxos de trabalho começam assim que o registro é criado. Uma vez que Vinte Interface oferece auto-salvamento em tempo real (não há modo de edição e depois uma validação para salvar registros), o fluxo de trabalho será acionado antes do usuário inserir todos os campos.
+  Para acionar este fluxo de trabalho em registros criados manualmente, recomenda-se usar o gatilho `Record is created or updated`.
+</Note>
+
+## Registro é Atualizado
+
+Inicia o fluxo de trabalho quando alterações são feitas em um registro existente.
+
+**Configuração**:
+
+* Selecione o tipo de objeto
+* Opcionalmente, especifique quais campos monitorar para alterações
+
+## Registro é Atualizado ou Criado
+
+Inicia o fluxo de trabalho quando um registro é criado ou atualizado em um objeto selecionado.
+
+**Por que isto é importante**: Este gatilho é particularmente útil porque registros criados por métodos diferentes se comportam de maneira diferente:
+
+* **Importações API/CSV**: Registros são criados com todos os campos preenchidos imediatamente
+* **Criação manual**: Registros são criados primeiro, depois os campos são adicionados em atualizações subsequentes
+
+**Configuração**:
+
+* Selecione o tipo de objeto para monitorar
+* Opcionalmente, especifique quais campos monitorar para alterações
+* O fluxo de trabalho será acionado tanto na criação inicial quanto em quaisquer atualizações subsequentes
+
+## Registro é Excluído
+
+Inicia o fluxo de trabalho quando um registro é removido de um objeto.
+
+**Configuração**: Selecione o tipo de objeto para monitorar exclusões.
+
+## Gatilho Manual
+
+Inicia o fluxo de trabalho quando acionado por uma ação do usuário. Este gatilho pode ser acessado pelo menu `Cmd+K` ou por um botão personalizado que será exibido na barra de navegação superior após selecionar um ou mais registros.
+
+<img src="/images/user-guide/workflows/add_to_newsletter_button.png" style={{width:'100%'}} />
+
+**Configuração de Disponibilidade**:
+Escolha como o fluxo de trabalho deve lidar com a seleção de registros:
+
+* **Global**: Nenhum registro é necessário para acionar este fluxo de trabalho. O fluxo de trabalho é acionado no menu de comando `Cmd+K` em qualquer lugar (de qualquer objeto) e não usa o(s) registro(s) como entrada.
+
+Para a disponibilidade de **Single** e **Bulk**, os registros selecionados serão passados para o seu fluxo de trabalho. Isto é configurado para um determinado objeto, e vários registros podem ser selecionados antes de acionar o fluxo de trabalho.
+
+* **Simples**: O fluxo de trabalho será executado do início ao fim tantas vezes quanto há registros selecionados.
+
+  <Note>
+    **Limite flexível: 100 execuções/minuto**. Além disso, os fluxos de trabalho permanecem com o status "Not Started" e são processados gradualmente — seja por uma tarefa em segundo plano ou quando outro fluxo de trabalho entra na fila. Isso significa que você pode selecionar mais de 100 registros com um gatilho único; a execução será apenas mais lenta.
+  </Note>
+
+* **Bulk**: O fluxo de trabalho será executado uma vez, fornecendo toda a lista de registros como entrada. Isso significa que o fluxo de trabalho precisa conter uma [ação de iterador](/l/pt/user-guide/workflows/capabilities/workflow-actions#iterator).
+
+<Note>
+Isto é mais avançado e é melhor para pessoas que desejam otimizar o número de execuções de fluxo de trabalho.
+</Note>
+
+<img src="/images/user-guide/workflows/manual_trigger.png" style={{width:'100%'}} />
+
+**Configuração Adicional**:
+
+* Selecione o objeto alvo (para disponibilidade Única e em Massa)
+* Escolha um ícone de comando para acionar o fluxo de trabalho
+* Configure o local da barra de navegação (Fixado ou Não Fixado)
+
+**Métodos de Acesso**:
+
+* `Cmd+K` menu para encontrar e iniciar fluxos de trabalho manuais
+* Botão personalizado na barra de navegação superior (se configurado)
+
+## Gatilho baseado em tempo: Em um cronograma
+
+Inicia o fluxo de trabalho em uma base recorrente que você define.
+
+**Configuração**:
+
+* Selecione a unidade de tempo (minutos, horas, dias)
+* Insira um valor ou utilize expressões cron personalizadas para agendamentos avançados
+
+<Note>
+**Fuso horário**: Fluxos de trabalho agendados são executados em **UTC**. Ao definir horários para agendamentos diários, converta seu horário local para UTC.
+</Note>
+
+## Gatilho Externo: Webhook
+
+Inicia o fluxo de trabalho quando uma solicitação GET ou POST é recebida de um serviço externo.
+
+<img src="/images/user-guide/workflows/webhook_trigger.png" style={{width:'100%'}} />
+
+**Configuração**:
+
+* O fluxo de trabalho fornece uma URL de webhook exclusiva — copie-a e adicione-a ao seu sistema externo como o endpoint a ser chamado.
+* Para requisições POST, defina a estrutura de corpo esperada para que o Twenty saiba quais dados esperar. Adicione aqui os campos que você receberá e que serão necessários abaixo no seu fluxo de trabalho.
+* Configure a autenticação (em breve).
+
+## Escolhendo o Gatilho Correto
+
+| Caso de uso                                   | Gatilho recomendado             |
+| --------------------------------------------- | ------------------------------- |
+| Novos leads precisam de processamento         | Registro é Criado               |
+| Alterações de dados precisam de sincronização | Registro é Atualizado           |
+| Importação/manipulação manual de dados        | Registro é Atualizado ou Criado |
+| Limpeza após exclusão                         | Registro é Excluído             |
+| Ação iniciada pelo usuário                    | Iniciar Manualmente             |
+| Relatórios recorrentes                        | Agendamento                     |
+| Integração externa                            | Webhook ou Em um cronograma     |

packages/twenty-docs/l/pt/user-guide/workflows/capabilities/workflow-versions.mdx

@@ -0,0 +1,84 @@
+---
+title: Versões de Workflow
+description: Gerenciar versões e rascunhos de workflow.
+---
+
+## Sobre versões
+
+Sempre que você ativa um workflow, uma nova versão é criada. Isso permite acompanhar as alterações ao longo do tempo e reverter para configurações anteriores, se necessário.
+
+## Status das versões
+
+| Estado         | Descrição                                         |
+| -------------- | ------------------------------------------------- |
+| **Rascunho**   | Sendo editado, ainda não publicado                |
+| **Ativo**      | Versão ao vivo respondendo a gatilhos             |
+| **Desativado** | Anteriormente ativo, mas interrompido manualmente |
+| **Arquivado**  | Versões passadas mantidas para histórico          |
+
+## Trabalhando com rascunhos
+
+Ao editar um workflow ativo, as alterações são salvas como um **rascunho**. A versão ativa continua em execução enquanto você trabalha nas atualizações.
+
+Quando terminar de editar, você pode:
+
+* **Ativar**: Publicar o rascunho como a nova versão ativa (a versão anterior é arquivada)
+* **Descartar**: Excluir o rascunho e manter a versão ativa atual
+
+## Histórico de Versões
+
+### Visualizando versões anteriores
+
+1. Abra o workflow
+2. Clique na aba **Versões**
+3. Veja todas as versões anteriores com carimbos de data e hora
+
+### Restaurando uma versão
+
+1. Encontre a versão que deseja restaurar
+2. Clique em **Usar como rascunho**
+3. A versão é copiada para um novo rascunho
+4. Faça as atualizações necessárias
+5. Ative quando estiver pronto
+
+## Melhores Práticas
+
+### Gerenciamento de versões
+
+* Ative somente quando estiver pronto para produção
+* Mantenha mudanças relevantes entre versões
+* Documente mudanças importantes em nomes ou descrições de workflows
+* Teste no modo de rascunho antes de ativar
+
+### Revertendo alterações
+
+* Se uma nova versão causar problemas, restaure a versão anterior
+* Use o histórico de versões para acompanhar o que mudou
+* Sempre teste versões restauradas antes de ativar
+
+## Workflows comuns
+
+### Edição rápida
+
+1. Faça pequenas alterações em um workflow ativo
+2. Teste no modo de rascunho
+3. Ative a nova versão
+
+### Revisão importante
+
+1. Use a versão anterior como ponto de partida
+2. Faça alterações significativas no rascunho
+3. Teste minuciosamente todos os cenários
+4. Ative quando estiver confiante
+
+### Reversão
+
+1. Identifique o problema na versão atual
+2. Encontre a última versão funcional no histórico
+3. Clique em **Usar como rascunho**
+4. Ative para restaurar o comportamento anterior
+
+## Relacionados
+
+* [Primeiros passos com Workflows](/l/pt/user-guide/workflows/overview)
+* [Execuções de Workflows](/l/pt/user-guide/workflows/capabilities/workflow-runs)

packages/twenty-docs/l/pt/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions.mdx

@@ -0,0 +1,82 @@
+---
+title: Tratar arrays em ações de Código
+description: Aprenda a tratar corretamente entradas de array em ações de Código em fluxos de trabalho.
+---
+
+Ao trabalhar com arrays em ações de Código, você pode encontrar dois desafios comuns:
+
+1. **Arrays passados como strings** — dados de sistemas externos ou de etapas anteriores chegam como uma string em vez de um array real
+2. **Não é possível selecionar itens individualmente** — você só consegue selecionar o array inteiro, não campos específicos dentro dele
+
+Ambos podem ser resolvidos com um nó de Código.
+
+## Analisar arrays a partir de strings
+
+Com frequência, arrays são passados entre etapas do fluxo de trabalho como strings ou JSON, em vez de arrays nativos. Isso acontece quando:
+
+* Recebendo dados de APIs externas via HTTP Request
+* Processando payloads de webhooks
+* Transmitindo dados entre etapas do fluxo de trabalho
+
+**Solução**: Adicione este padrão no início da sua ação de Código:
+
+```javascript
+export const main = async (params: {
+  users: any;
+}): Promise<object> => {
+  const { users } = params;
+
+  // Handle input that may come as a string or an array
+  const usersFormatted = typeof users === "string" ? JSON.parse(users) : users;
+
+  // Now you can safely work with usersFormatted as an array
+  return {
+    users: usersFormatted.map((user) => ({
+      ...user,
+      activityStatus: String(user.activityStatus).toUpperCase(),
+    })),
+  };
+};
+```
+
+A linha chave `typeof users === "string" ? JSON.parse(users) : users` verifica se a entrada é uma string, faz o parse se necessário ou a utiliza diretamente se já for um array.
+
+## Extraindo campos individuais de arrays
+
+Um webhook pode retornar um array como `answers: [...]`, mas, nas etapas seguintes do fluxo de trabalho, você só consegue selecionar o **array inteiro** — não itens individuais dentro dele.
+
+**Solução**: Adicione um nó de Código para extrair campos específicos e retorná-los como um objeto estruturado:
+
+```javascript
+export const main = async (params: {
+  answers: any;
+}): Promise<object> => {
+  const { answers } = params;
+
+  // Handle input that may come as a string or an array
+  const answersFormatted = typeof answers === "string"
+    ? JSON.parse(answers)
+    : answers;
+
+  // Extract specific fields from the array
+  const firstname = answersFormatted[0]?.text || "";
+  const name = answersFormatted[1]?.text || "";
+
+  return {
+    answer: {
+      firstname,
+      name
+    }
+  };
+};
+```
+
+O nó de Código retorna um objeto estruturado em vez de um array. Nas etapas subsequentes, agora você pode selecionar campos individuais como `answer.firstname` e `answer.name` no seletor de variáveis.
+
+<Tip>
+**Quer iterar sobre o array em vez de extrair campos?** Quando uma etapa Code ou Logic Function retorna um array de nível superior, você pode passá-lo diretamente para um [Iterator](/l/pt/user-guide/workflows/capabilities/use-iterator): selecione a opção **Whole list** da etapa como entrada do Iterator e, em seguida, faça referência a cada elemento com `{{iterator.currentItem}}` dentro do loop. Nesse caso, você não precisa reestruturar o array em um objeto.
+</Tip>
+
+<Tip>
+Clique no ícone quadrado no canto superior direito do editor de código para exibi-lo em tela cheia — útil, já que a largura padrão do editor é limitada.
+</Tip>