snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s

This commit is contained in:
upstream-mirror
2026-09-17 23:28:13 +05:00
commit e7da97194a
32688 changed files with 4208681 additions and 0 deletions

View File

@@ -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.

View File

@@ -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>

View File

@@ -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).

View File

@@ -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).

View File

@@ -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).

View File

@@ -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>