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

packages/twenty-docs/l/pt/getting-started/core-concepts/ai.mdx

@@ -0,0 +1,34 @@
+---
+title: IA
+description: Como a Twenty utiliza IA para melhorar a sua experiência de CRM.
+icon: robot
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+A Twenty integra IA diretamente no seu CRM — não como um truque, mas como uma ferramenta que funciona dentro do seu modelo de dados e sistema de permissões.
+
+## Chatbot de IA
+
+Faça perguntas sobre os seus dados em linguagem natural. O chatbot de IA pode consultar os seus registos de CRM, resumir informações e ajudá‑lo a encontrar o que procura sem criar filtros complexos.
+
+<VimeoEmbed videoId="1185511734" title="Chatbot de IA" />
+
+## Agentes de IA
+
+Os agentes de IA vão além do chat — conseguem executar tarefas com vários passos de forma autónoma:
+
+* Enriquecer registos com dados de fontes externas
+* Redigir e enviar emails de seguimento
+* Analisar a saúde do funil e sinalizar negócios em risco
+* Processar dados recebidos e encaminhá‑los para a equipa correta
+
+Os agentes trabalham dentro dos seus fluxos de trabalho existentes, para que possa combinar IA com aprovações manuais, lógica condicional e chamadas a APIs externas.
+
+## Permissões e segurança
+
+A IA na Twenty respeita o seu modelo de permissões. Os agentes só podem aceder a objetos e campos que o utilizador (ou função) tem permissão para ver. Os dados sensíveis permanecem protegidos mesmo quando a IA está envolvida.
+
+<Card title="Guia completo de IA" icon="arrow-right" href="/l/pt/user-guide/ai/overview">
+  Referência detalhada sobre o chatbot, os agentes e os controlos de permissões.
+</Card>

packages/twenty-docs/l/pt/getting-started/core-concepts/apps.mdx

@@ -0,0 +1,41 @@
+---
+title: Aplicativos
+icon: cube
+description: Estenda o Twenty com código — objetos personalizados, lógica do lado do servidor, componentes de UI e agentes de IA, todos como pacotes em TypeScript.
+---
+
+A maioria dos CRMs oferece um painel de configuração. O Twenty oferece uma plataforma. Os aplicativos são como os desenvolvedores estendem o Twenty além do que a UI oferece — definindo modelos de dados, lógica do lado do servidor, componentes de UI e recursos de IA como código e, depois, implantando-os em um ou mais espaços de trabalho.
+
+## Por que os aplicativos existem
+
+Fluxos de trabalho abrangem automação sem código. Mas algumas coisas precisam de código: um mecanismo de precificação personalizado, um pipeline de enriquecimento proprietário, uma verificação de conformidade que é executada a cada atualização de registro, um painel de interface de usuário personalizado que obtém dados de uma ferramenta interna.
+
+Os aplicativos permitem criar tudo isso como extensões de primeira classe — não scripts frágeis que conversam com uma API externa, mas código que roda na plataforma com acesso total ao sistema de tipos, ao modelo de permissões e à UI.
+
+## O que um aplicativo pode definir
+
+Um aplicativo é um pacote TypeScript que declara **entidades** usando o `twenty-sdk`:
+
+| Entidade                     | O que faz                                                                                                          |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| **Objetos e campos**         | Novas tabelas de dados e campos em objetos existentes — com o mesmo tratamento dos nativos.                        |
+| **Funções lógicas**          | Funções TypeScript do lado do servidor acionadas por rotas HTTP, agendamentos do cron ou eventos de banco de dados |
+| **Componentes de front-end** | Componentes React em sandbox que são renderizados na UI do Twenty (painel lateral, widgets, menu de comandos).     |
+| **Habilidades e agentes**    | Recursos de IA — instruções reutilizáveis e assistentes autônomos                                                  |
+| **Exibições e navegação**    | Exibições de lista pré-configuradas e itens de menu da barra lateral                                               |
+
+Tudo é detectado por meio de análise de AST em tempo de build — sem arquivos de configuração, sem código boilerplate de registro. Coloque um `export default defineObject(...)` em qualquer arquivo `.ts` e o SDK o detecta.
+
+## Como elas são executadas
+
+* **Funções lógicas** são executadas em processos Node.js isolados, em sandbox do host. Elas acessam dados por meio de um cliente de API tipado, restrito às permissões do papel do aplicativo.
+* **Componentes de front-end** executam em Web Workers usando Remote DOM — isolados da página principal, mas renderizando elementos DOM nativos (não iframes).
+* **Permissões** são aplicadas no nível da API. Um aplicativo só enxerga o que o seu papel permite.
+
+## A experiência do desenvolvedor
+
+Você escreve seu aplicativo como um projeto TypeScript na sua máquina. A CLI observa seus arquivos-fonte e os sincroniza em tempo real com um servidor Twenty em execução — edite um arquivo e veja a alteração na UI em segundos. O cliente de API tipado é regenerado automaticamente quando o esquema muda. Quando estiver pronto, `yarn twenty app:publish --private` faz o push para um servidor de produção, ou `yarn twenty app:publish` lista seu aplicativo no npm e no marketplace do Twenty.
+
+<Card title="Crie seu primeiro aplicativo" icon="arrow-right" href="/l/pt/developers/extend/apps/getting-started/quick-start">
+  Tutorial em três fases — gerar o esqueleto, executar um servidor local, sincronizar suas alterações.
+</Card>

packages/twenty-docs/l/pt/getting-started/core-concepts/calendar-and-email.mdx

@@ -0,0 +1,46 @@
+---
+title: Calendário e email
+description: Sincronize o seu email e calendário com o Twenty.
+icon: envelope
+---
+
+O Twenty se conecta às suas ferramentas existentes para que o seu CRM permaneça atualizado sem entrada manual de dados.
+
+## Sincronização de email
+
+Conecte a sua caixa de correio do **Google Workspace** ou **Microsoft 365**. Depois de conectado:
+
+* Os emails são vinculados automaticamente aos registros de Empresas e Pessoas correspondentes
+* Conversas completas de email ficam visíveis na linha do tempo de cada registro
+* Você pode enviar emails diretamente do Twenty
+* Há suporte para várias caixas de correio por usuário
+
+Você controla o que é importado — filtre por intervalo de datas ou remetente para evitar trazer emails irrelevantes.
+
+## Sincronização de calendário
+
+Os eventos do calendário são sincronizados automaticamente a partir da sua conta conectada. Os eventos aparecem nos registros relevantes do CRM, oferecendo uma visão completa das suas interações com cada contato ou empresa.
+
+## Integrações
+
+Além de email e calendário, o Twenty se conecta a ferramentas externas por meio de:
+
+| Método                              | Caso de uso                                                                                 |
+| ----------------------------------- | ------------------------------------------------------------------------------------------- |
+| **API**                             | Crie integrações personalizadas com a API GraphQL ou REST                                   |
+| **Webhooks**                        | Envie notificações em tempo real para sistemas externos quando os registros forem alterados |
+| **Zapier**                          | Conecte-se a mais de 5.000 apps sem código                                                  |
+| **Ações HTTP de fluxo de trabalho** | Chame qualquer API externa como parte de um fluxo de trabalho automatizado                  |
+
+## Apps personalizados
+
+Desenvolvedores podem criar apps completos em cima do Twenty — adicionando interface personalizada, lógica no servidor e integrações avançadas. Os apps podem ser publicados para a comunidade ou mantidos privados.
+
+<CardGroup cols={2}>
+  <Card title="Guia de calendário e email" icon="envelope" href="/l/pt/user-guide/calendar-emails/overview">
+    Configure a sincronização de email, a sincronização de calendário e solucione problemas.
+  </Card>
+  <Card title="API e extensões" icon="plug" href="/l/pt/developers/extend/api">
+    Crie integrações personalizadas com a API do Twenty.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/pt/getting-started/core-concepts/dashboards.mdx

@@ -0,0 +1,37 @@
+---
+title: Painéis
+description: Acompanhe o desempenho e visualize seus dados de CRM com painéis personalizados.
+icon: chart-bar
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Os painéis oferecem visibilidade em tempo real sobre as métricas do seu negócio — saúde do pipeline, desempenho da equipe, tendências de receita e qualquer outra coisa que você queira acompanhar.
+
+<VimeoEmbed videoId="1185511768" title="Painel" />
+
+## Widgets
+
+Cada painel é composto por widgets. Um widget é um único gráfico ou métrica vinculado aos seus dados de CRM. Você pode configurar:
+
+* **Tipo de gráfico** — barra, linha, pizza, número e mais
+* **Fonte de dados** — qualquer objeto no seu modelo de dados (padrão ou personalizado)
+* **Filtros** — restrinja a registros, intervalos de datas ou segmentos específicos
+* **Agregação** — contagem, soma, média, mínimo, máximo em qualquer campo numérico
+* **Agrupamento** — agrupe por campos selecionados, datas ou relações
+
+## O que você pode acompanhar
+
+* Valor do pipeline por etapa
+* Negócios fechados ao longo do tempo
+* Valor médio do negócio por origem
+* Taxas de conclusão de tarefas
+* Métricas personalizadas em qualquer objeto
+
+## Compartilhamento
+
+Os painéis são no nível do espaço de trabalho — todos na sua equipe podem vê-los. Organize os widgets em um layout de grade e redimensione-os para construir a visualização que funciona para sua equipe.
+
+<Card title="Guia completo de painéis" icon="arrow-right" href="/l/pt/user-guide/dashboards/overview">
+  Referência detalhada sobre criação de painéis, configuração de widgets e configurações de gráficos.
+</Card>

packages/twenty-docs/l/pt/getting-started/core-concepts/data-model.mdx

@@ -0,0 +1,47 @@
+---
+title: Modelo de dados
+description: Entenda como o Twenty estrutura seus dados com objetos, campos e relações.
+icon: database
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Tudo no Twenty é construído em torno de **objetos** e **campos** — os blocos de construção do seu modelo de dados.
+
+## Objetos
+
+Os objetos são as tabelas que armazenam seus dados. O Twenty vem com objetos padrão prontos para uso:
+
+* **Empresas** — Organizações com as quais você faz negócios
+* **Pessoas** — Contatos individuais
+* **Oportunidades** — Negócios no seu funil
+* **Tarefas** — Itens de ação para sua equipe
+* **Notas** — Texto livre vinculado a registros
+
+Você também pode criar **objetos personalizados** para tudo o que a sua empresa precisar — projetos, tíquetes de suporte, produtos, contratos ou qualquer outra coisa.
+
+## Campos
+
+Os campos são as propriedades de cada objeto. O Twenty é compatível com uma ampla variedade de tipos de campo:
+
+| Categoria    | Tipos                                                                         |
+| ------------ | ----------------------------------------------------------------------------- |
+| **Básico**   | Texto, Número, Booleano, Data, Moeda, Avaliação, Seleção                      |
+| **Composto** | Endereço (rua, cidade, estado, CEP), Nome completo, Links, Telefones, E-mails |
+| **Especial** | Relação, Anexo de arquivo, JSON, Autor (quem criou/modificou)                 |
+
+Cada objeto também recebe campos de sistema automáticos: `id`, `createdAt`, `updatedAt`, `createdBy` e `position`.
+
+## Relações
+
+Os objetos se conectam entre si por meio de relações. Uma Empresa tem muitas Pessoas, uma Oportunidade pertence a uma Empresa, e assim por diante. Você pode criar relações personalizadas entre quaisquer objetos, incluindo relacionamentos muitos-para-muitos.
+
+## O que torna isso poderoso
+
+Ao contrário dos CRMs tradicionais, em que você fica limitado a campos predefinidos em objetos predefinidos, o Twenty permite modelar seus dados exatamente da forma como o seu negócio funciona. Objetos personalizados recebem o mesmo tratamento de primeira classe que os nativos — incluindo endpoints de API, visualizações, permissões e gatilhos de fluxo de trabalho.
+
+<Card title="Análise aprofundada do modelo de dados" icon="arrow-right" href="/l/pt/user-guide/data-model/overview">
+  Referência completa sobre objetos, campos, relações e como configurá-los.
+</Card>
+
+<VimeoEmbed videoId="1185511827" title="Modelo de dados" />

packages/twenty-docs/l/pt/getting-started/core-concepts/glossary.mdx

@@ -0,0 +1,105 @@
+---
+title: Glossário
+icon: book
+description: Termos-chave usados 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
+
+Um Iterador é 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 indica 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 disparadores 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/getting-started/core-concepts/layout.mdx

@@ -0,0 +1,74 @@
+---
+title: Layout
+description: Como navegar, explorar e visualizar registos na Twenty.
+icon: table-columns
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## O layout principal
+
+O centro do ecrã é onde os seus registos vivem — pessoas, empresas, oportunidades, tarefas, notas, painéis, fluxos de trabalho e quaisquer objetos personalizados. Aqui pode visualizar, editar e eliminar registos e criar novas vistas.
+
+<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
+
+## Barra de navegação
+
+A barra lateral esquerda dá-lhe:
+
+* **Seletor de espaço de trabalho** — alternar entre espaços de trabalho ou criar um novo (menu suspenso no topo)
+* **Pesquisa** — prima `/` para focar instantaneamente, pesquisa em todos os objetos
+* **Definições** — aceda a partir do canto superior esquerdo
+* **Favoritos** — vistas fixadas, únicas por utilizador
+* **Atalhos de objetos** — acesso rápido a Pessoas, Empresas, Oportunidades, etc.
+* **Fluxos de trabalho** — criar automatizações
+
+Arraste itens para reordenar, crie pastas para agrupar objetos relacionados, oculte o que não utiliza.
+
+<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
+
+## Menu de Comandos
+
+Prima `Cmd+K` (Mac) ou `Ctrl+K` (Windows) — ou clique nos três pontos no canto superior direito. A partir daqui pode:
+
+* Criar novos registos
+* Importar e exportar dados via CSV
+* Criar novas vistas
+* Aceder a registos eliminados (a Twenty suporta eliminações lógicas e permanentes)
+* Ver os atalhos de teclado para navegar no seu espaço de trabalho
+
+<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
+
+## Pesquisar
+
+Acessível através do Menu de Comandos, no topo da barra de navegação, ou premindo `/`. A pesquisa funciona em todos os objetos.
+
+<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
+
+## Painel lateral
+
+Clique num registo para abrir o painel lateral à direita — uma visão geral rápida das informações principais do registo sem sair da página atual. Clique em **Abrir** para ir para a página completa do registo.
+
+<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
+
+## Vistas
+
+Cada objeto suporta múltiplas vistas — ilimitadas por objeto. Use o menu suspenso no canto superior esquerdo para alternar entre elas.
+
+* **Tabela** — linhas e colunas ao estilo de folha de cálculo, com agrupamento, edição inline e personalização de colunas
+* **Kanban** — cartões de arrastar e largar organizados por um campo de seleção, ideal para pipelines
+* **Calendário** — registos distribuídos por um campo de data para planeamento baseado em tempo
+
+Cada vista guarda os seus próprios filtros, ordenação e visibilidade de campos. Partilhe vistas com o seu espaço de trabalho ou mantenha-as privadas. Marcar vistas como favoritas para acesso rápido a partir da barra lateral.
+
+<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
+
+## Páginas de Registos
+
+Quando abre um registo, a página de detalhes é construída a partir de **separadores** e **widgets** configuráveis. Adicione, remova, reordene e redimensione widgets numa grelha — campos, registos relacionados, e-mails, cronologia, tarefas, notas, ficheiros, gráficos, iframes e muito mais. Cada tipo de objeto tem o seu próprio layout.
+
+<Card title="Guia completo de Layout" icon="arrow-right" href="/l/pt/user-guide/layout/overview">
+  Navegação, vistas, páginas de registos — referência detalhada e tutoriais.
+</Card>
+
+<VimeoEmbed videoId="1185511790" title="Layout" />

packages/twenty-docs/l/pt/getting-started/core-concepts/workflows.mdx

@@ -0,0 +1,55 @@
+---
+title: Fluxos de trabalho
+description: Automatize os processos da sua empresa com o construtor visual de fluxos de trabalho do Twenty.
+icon: bolt
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+Os fluxos de trabalho permitem automatizar tarefas repetitivas e conectar o Twenty a ferramentas externas — sem escrever código (embora você possa, se quiser).
+
+<VimeoEmbed videoId="1185511711" title="Workflow" />
+
+## Como os fluxos de trabalho funcionam
+
+Cada fluxo de trabalho tem três partes:
+
+1. **Disparador** — O que inicia o fluxo de trabalho
+2. **Etapas** — O que acontece em seguida (uma ou mais ações em sequência)
+3. **Variáveis** — Dados que fluem entre as etapas
+
+## Disparadores
+
+| Disparador             | Quando é acionado                                                                       |
+| ---------------------- | --------------------------------------------------------------------------------------- |
+| **Evento de registro** | Um registro é criado, atualizado, excluído ou inserido/atualizado (upsert)              |
+| **Manual**             | Um usuário clica em um botão (em um único registro, em vários registros ou globalmente) |
+| **Agendamento**        | Em um intervalo recorrente (sintaxe cron)                                               |
+| **Webhook**            | Um sistema externo envia um HTTP POST                                                   |
+
+## Ações
+
+Os fluxos de trabalho podem encadear qualquer combinação de:
+
+* **Operações de registro** — Criar, atualizar, localizar, excluir ou inserir/atualizar registros (upsert)
+* **Enviar e-mail** — Enviar ou rascunhar e-mails a partir de contas conectadas
+* **Solicitação HTTP** — Chamar qualquer API externa
+* **Código** — Executar JavaScript personalizado para lógica complexa
+* **Ramificações** — Condições if/else para dividir o caminho do fluxo de trabalho
+* **Iterador** — Percorrer arrays de dados
+* **Agente de IA** — Deixar um agente de IA processar dados de forma autônoma
+* **Atraso** — Aguardar antes de continuar
+* **Formulário** — Coletar entrada do usuário no meio do fluxo de trabalho
+
+## O que você pode criar
+
+* Enviar alertas no Slack quando um negócio atingir um determinado estágio
+* Enriquecer automaticamente novos contatos com dados de APIs externas
+* Detectar oportunidades estagnadas e notificar o responsável
+* Sincronizar dados entre o Twenty e o seu sistema de faturamento
+* Gerar PDFs ou faturas a partir de dados de registros
+* Responder automaticamente a e-mails recebidos que correspondam a certos critérios
+
+<Card title="Guia completo de fluxos de trabalho" icon="arrow-right" href="/l/pt/user-guide/workflows/overview">
+  Referência detalhada sobre disparadores, ações, variáveis e receitas de automação do mundo real.
+</Card>

packages/twenty-docs/l/pt/getting-started/introduction.mdx

@@ -0,0 +1,72 @@
+---
+title: Por que Twenty
+icon: heart
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+Você vinha escolhendo entre softwares que são fáceis de começar, mas impossíveis de mudar, e softwares que são flexíveis, mas levam meses para serem configurados. Twenty é a terceira opção: **um CRM pronto para produção que você pode remodelar conforme avança.**
+
+## O que torna o Twenty diferente
+
+Twenty é uma plataforma na qual você pode construir, não um produto que você configura.
+
+<CardGroup cols={2}>
+  <Card img="/images/user-guide/halftone/ai.png">
+    <CardTitle>Feito para Agentes</CardTitle>
+    Os agentes operam dentro do seu modelo de dados com permissões reais. Competências, Ferramentas, MCP.
+  </Card>
+  <Card img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>Extensibilidade Segura</CardTitle>
+    A flexibilidade de ferramentas "vibe-coded" sobre bases seguras.
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>Stack Moderno</CardTitle>
+    React, TypeScript. A sua equipe já sabe como estender o Twenty. Sem linguagens proprietárias, sem restrições de acesso.
+  </Card>
+  <Card img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>Sem Lock-in</CardTitle>
+    Núcleo open source, possibilidade de auto-hospedagem, exporte seus dados a qualquer momento.
+  </Card>
+</CardGroup>
+
+## Para quem é o Twenty
+
+* **Grandes empresas substituindo o Salesforce** — sua equipe
+  passa mais tempo lutando contra a ferramenta do que usando-a.
+  Você se sente preso e os custos continuam aumentando.
+* **Startups com fundadores técnicos** — vocês deixaram
+  para trás as planilhas e o Notion. Vocês têm grandes ambições e querem
+  um CRM que escale com vocês.
+* **Equipes de GTM em busca de vantagem competitiva** — vocês querem construir
+  sua própria qualificação de leads, seu próprio enriquecimento, seus próprios
+  fluxos de trabalho de outbound.
+* **Organizações preocupadas com privacidade** — vocês precisam
+  de auto-hospedagem e de possuir seus dados de ponta a ponta. Regulatório,
+  contratual ou simplesmente por princípio.
+* **Parceiros Salesforce** —
+  seus desenvolvedores estão cansados de apresentar aumentos de custos de licença aos seus clientes.
+  Você quer uma melhor DX e entregar projetos mais rápido, com um custo de licença menor para seus clientes.
+* **Agências de desenvolvimento web** — sua equipe conhece TypeScript, React,
+  e PostgreSQL. Twenty abre o mercado de CRM
+  para você sem precisar aprender APEX ou obter certificações proprietárias.
+
+## Para quem o Twenty não é indicado
+
+* **Equipes que querem um CRM sobre o qual nunca precisem pensar.** Twenty recompensa equipes que querem ficar próximas
+  das suas ferramentas e moldá-las ao longo do tempo. Se você quer
+  algo totalmente gerenciado, Pipedrive ou
+  HubSpot vão te atender bem.
+* **Empresas que precisam de centenas de integrações prontas
+  hoje.** Nosso ecossistema está crescendo rápido, mas ainda não é
+  tão amplo quanto o do Salesforce ou do HubSpot. Se você se sentir à vontade
+  para construir o que falta, vai adorar. Se não, nos dê
+  mais um ano.
+* **Organizações em que as ferramentas são escolhidas em salas de reunião,
+  não por quem as utiliza.** Nós não fazemos jantares sofisticados
+  e apresentações executivas. Ganhamos com equipes que têm a
+  autoridade para escolher suas próprias ferramentas.
+
+<Card title="Pronto para começar?" icon="rocket" href="/l/pt/getting-started/quickstart">
+  Configure o Twenty em menos de 5 minutos — na nuvem ou em hospedagem própria.
+</Card>

packages/twenty-docs/l/pt/getting-started/key-features.mdx

@@ -0,0 +1,70 @@
+---
+title: Principais funcionalidades
+description: Um tour por tudo o que o Twenty pode fazer — desde modelos de dados personalizados até automação com IA.
+icon: star
+---
+
+import { CardTitle } from "/snippets/card-title.mdx"
+
+O Twenty é uma plataforma de CRM completa. Veja o que você pode criar com ele.
+
+<CardGroup cols={2}>
+  <Card href="/l/pt/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
+    <CardTitle>Modelo de Dados Personalizado</CardTitle>
+    Defina a estrutura exata de dados de que o seu negócio precisa.
+    <br />Crie objetos personalizados, adicione campos personalizados com mais de 20 tipos de campo e crie relacionamentos entre quaisquer objetos.
+  </Card>
+
+  <Card href="/l/pt/user-guide/views-pipelines/overview" img="/images/user-guide/halftone/layout.png">
+    <CardTitle>Visualizações & Pipelines</CardTitle>
+    Alterne entre visualizações em tabela, quadros kanban e visualizações de calendário.
+    <br />Filtre com lógica AND/OR, ordene por vários campos, agrupe registros e salve visualizações personalizadas.
+  </Card>
+
+  <Card href="/l/pt/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
+    <CardTitle>Fluxos de trabalho & Automação</CardTitle>
+    Automatize qualquer processo de negócios sem escrever código.
+    <br />Dispare fluxos de trabalho em alterações de registros, agendamentos, ações manuais ou webhooks recebidos.
+  </Card>
+
+  <Card href="/l/pt/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
+    <CardTitle>Sincronização de Calendário & Email</CardTitle>
+    Conecte sua conta do Google Workspace ou Microsoft 365.
+    <br />Emails e eventos de calendário aparecem automaticamente nos registros de CRM relevantes.
+  </Card>
+
+  <Card href="/l/pt/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
+    <CardTitle>IA</CardTitle>
+    Agentes de IA que trabalham de forma autônoma dentro do seu CRM — respondendo a perguntas, enriquecendo registros e executando tarefas de múltiplas etapas dentro do seu modelo de permissões.
+  </Card>
+
+  <Card href="/l/pt/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
+    <CardTitle>Dashboards & Relatórios</CardTitle>
+    Crie dashboards personalizados com widgets em tempo real.
+    <br />Acompanhe métricas de pipeline, desempenho da equipe e KPIs de negócios com gráficos e filtros configuráveis.
+  </Card>
+
+  <Card href="/l/pt/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
+    <CardTitle>Permissões & Controle de Acesso</CardTitle>
+    Controle de acesso baseado em função em todos os níveis — objetos, campos e registros individuais.
+    <br />Configure SSO com SAML ou OIDC. Registros de auditoria rastreiam quem fez o quê.
+  </Card>
+
+  <Card href="/l/pt/developers/extend/api" img="/images/user-guide/halftone/dev-api.png">
+    <CardTitle>API & Extensibilidade</CardTitle>
+    Uma API voltada para desenvolvedores que se adapta ao seu modelo de dados personalizado.
+    <br />Tanto endpoints GraphQL quanto REST, com documentação gerada automaticamente por workspace.
+  </Card>
+
+  <Card href="/l/pt/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
+    <CardTitle>Importação & Exportação de Dados</CardTitle>
+    Importe dados de arquivos CSV ou via API.
+    <br />Mapeamento de campos, detecção de duplicidades e tratamento de erros integrados. Exporte seus dados a qualquer momento — sem dependência do fornecedor.
+  </Card>
+
+  <Card href="/l/pt/developers/self-host/self-host" img="/images/user-guide/halftone/dev-self-host.png">
+    <CardTitle>Auto-hospedagem</CardTitle>
+    Execute o Twenty na sua própria infraestrutura com um único comando Docker Compose.
+    <br />Controle total sobre seus dados, atualizações no seu próprio cronograma.
+  </Card>
+</CardGroup>

packages/twenty-docs/l/pt/getting-started/quickstart.mdx

@@ -0,0 +1,73 @@
+---
+title: Guia rápido
+description: Coloque o Twenty em funcionamento em menos de 5 minutos — na nuvem ou em hospedagem própria.
+icon: play
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## Inscreva-se
+
+<Steps>
+  <Step title="Crie sua conta">
+    Acesse [app.twenty.com](https://app.twenty.com) e inscreva-se com Google, Microsoft ou e-mail.
+  </Step>
+  <Step title="Escolha um teste">
+    Escolha **30 dias** (com cartão) ou **7 dias** (sem cartão). Ambos incluem acesso completo — contatos ilimitados, integração de e-mail, objetos personalizados, API. Você pode mudar de plano ou intervalo de cobrança a qualquer momento.
+  </Step>
+  <Step title="Crie seu espaço de trabalho">
+    Após a confirmação do pagamento via Stripe, você definirá o nome do seu espaço de trabalho e o perfil de usuário. Você pode cancelar a qualquer momento.
+  </Step>
+</Steps>
+
+<VimeoEmbed videoId="1185227242" title="Criando um espaço de trabalho" />
+
+## Configure seu espaço de trabalho
+
+Depois de entrar, siga três etapas para tornar o Twenty seu:
+
+### 1. Conecte sua caixa de correio
+
+Vá para **Configurações → Contas** e conecte sua conta Google ou Microsoft. O Twenty importará seus e-mails e eventos de calendário e criará contatos automaticamente a partir das interações. Usando outro provedor? Você pode adicionar caixas de correio via SMTP ou calendários via CalDAV na mesma página.
+
+<Note>Comece aqui — conectar uma caixa de correio dá valor imediato à sua equipe com dados reais antes de você personalizar qualquer outra coisa.</Note>
+
+<VimeoEmbed videoId="1185416821" title="Conecte sua caixa de correio" />
+
+### 2. Estruture seu modelo de dados
+
+Vá para **Configurações → Modelo de Dados** para criar objetos e campos personalizados. Algumas coisas que você precisa saber:
+
+* Objetos e campos personalizados são **ilimitados em todos os planos** — sem upsell.
+* **Pessoas, Empresas e Oportunidades** são os objetos que exibem e-mails e reuniões sincronizados. Use-os como base e adicione campos para categorizar (por exemplo, um campo `Person Type`) em vez de criar objetos separados que não terão histórico de e-mail.
+* Duas Pessoas não podem ter o mesmo e-mail. Duas Empresas não podem ter o mesmo domínio.
+* Você pode desativar campos/objetos padrão de que não precisa e ocultar campos das visualizações sem excluí-los.
+
+[Referência do modelo de dados →](/l/pt/user-guide/data-model/overview)
+
+<VimeoEmbed videoId="1185416793" title="Estruture seu modelo de dados" />
+
+### 3. Importe seus dados
+
+Use o Menu de Comandos (`Cmd+K` / `Ctrl+K`) para importar Pessoas, Empresas, Oportunidades ou qualquer objeto personalizado via CSV. Baixe primeiro o arquivo de exemplo para ver o formato esperado. Limite os arquivos a 10 mil registros e remova duplicados de e-mails/domínios antes de importar.
+
+[Guia de migração de dados →](/l/pt/user-guide/data-migration/overview)
+
+<VimeoEmbed videoId="1185416775" title="Importe seus dados" />
+
+## Próximos passos
+
+<CardGroup cols={2}>
+  <Card title="Conheça o layout" icon="table-columns" href="/l/pt/getting-started/core-concepts/layout">
+    Navegação, vistas, menu de comandos, painel lateral.
+  </Card>
+  <Card title="Criar fluxos de trabalho" icon="bolt" href="/l/pt/user-guide/workflows/overview">
+    Automatize seus processos de negócios.
+  </Card>
+  <Card title="Criar vistas" icon="table" href="/l/pt/user-guide/layout/overview">
+    Tabela, kanban, calendário — filtre e ordene os seus dados.
+  </Card>
+  <Card title="Explorar a API" icon="plug" href="/l/pt/developers/extend/api">
+    Schema-per-tenant REST e GraphQL.
+  </Card>
+</CardGroup>