# Twenty Documentation: Portuguese

## Portuguese

- [Portuguese / Manual do Usuário (108 pages)](https://docs.twenty.com/_llms/pt/manual-do-usuario.md): Documentation for Portuguese / Manual do Usuário.

### Primeiros passos

#### Boas-vindas

- [Por que Twenty](https://docs.twenty.com/l/pt/getting-started/introduction.md)
- [Principais funcionalidades](https://docs.twenty.com/l/pt/getting-started/key-features.md): Um tour por tudo o que o Twenty pode fazer — desde modelos de dados personalizados até automação com IA.
- [Guia rápido](https://docs.twenty.com/l/pt/getting-started/quickstart.md): Coloque o Twenty em funcionamento em menos de 5 minutos — na nuvem ou em hospedagem própria.

#### Conceitos essenciais

- [Modelo de dados](https://docs.twenty.com/l/pt/getting-started/core-concepts/data-model.md): Entenda como o Twenty estrutura seus dados com objetos, campos e relações.
- [Layout](https://docs.twenty.com/l/pt/getting-started/core-concepts/layout.md): Como navegar, explorar e visualizar registos na Twenty.
- [Fluxos de trabalho](https://docs.twenty.com/l/pt/getting-started/core-concepts/workflows.md): Automatize os processos da sua empresa com o construtor visual de fluxos de trabalho do Twenty.
- [Calendário e email](https://docs.twenty.com/l/pt/getting-started/core-concepts/calendar-and-email.md): Sincronize o seu email e calendário com o Twenty.
- [IA](https://docs.twenty.com/l/pt/getting-started/core-concepts/ai.md): Como a Twenty utiliza IA para melhorar a sua experiência de CRM.
- [Aplicativos](https://docs.twenty.com/l/pt/getting-started/core-concepts/apps.md): 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.
- [Painéis](https://docs.twenty.com/l/pt/getting-started/core-concepts/dashboards.md): Acompanhe o desempenho e visualize seus dados de CRM com painéis personalizados.
- [Glossário](https://docs.twenty.com/l/pt/getting-started/core-concepts/glossary.md): Termos-chave usados no Twenty.

### Programadores

#### Visão Geral

- [Programadores](https://docs.twenty.com/l/pt/developers/introduction.md): Crie aplicativos, use a API, hospede por conta própria ou contribua para o código-fonte.

#### Aplicativos

##### Primeiros passos

- [Início rápido](https://docs.twenty.com/l/pt/developers/extend/apps/getting-started/quick-start.md): Crie seu primeiro app do Twenty em minutos.
- [Conceitos](https://docs.twenty.com/l/pt/developers/extend/apps/getting-started/concepts.md): Como as aplicações Twenty funcionam — modelo de entidade, sandboxing e ciclo de vida da instalação.
- [Estrutura do projeto](https://docs.twenty.com/l/pt/developers/extend/apps/getting-started/project-structure.md): O que há dentro de um app Twenty criado com scaffold — arquivos, pastas e o que cada um faz.
- [Servidor Local](https://docs.twenty.com/l/pt/developers/extend/apps/getting-started/local-server.md): Gerencie o servidor Docker local do Twenty — iniciar, parar, atualizar, executar uma instância de teste paralela e configurar manualmente o SDK.
- [Scaffolding](https://docs.twenty.com/l/pt/developers/extend/apps/getting-started/scaffolding.md): Gere arquivos de entidade de forma interativa com `yarn twenty dev:add` — objetos, campos, visualizações, funções de lógica e mais.
- [Resolução de Problemas](https://docs.twenty.com/l/pt/developers/extend/apps/getting-started/troubleshooting.md): Problemas comuns na primeira execução — Docker, versão do Node, Yarn, dependências.

##### Tutorial

- [Tutorial: Gerador de Documentos](https://docs.twenty.com/l/pt/developers/extend/apps/tutorials/document-generator/overview.md): Crie um aplicativo Twenty real que gera documentos personalizados a partir dos seus dados de CRM.
- [1. Modelo de dados](https://docs.twenty.com/l/pt/developers/extend/apps/tutorials/document-generator/data-model.md): Modela documentos e templates com objetos, campos e uma relação.
- [2. Gerando documentos](https://docs.twenty.com/l/pt/developers/extend/apps/tutorials/document-generator/generating-documents.md): Uma função lógica, exposta como uma ferramenta de IA e uma ação de fluxo de trabalho.
- [3. Rotas HTTP](https://docs.twenty.com/l/pt/developers/extend/apps/tutorials/document-generator/http-routes.md): Acionar a função sobre HTTP e renderizar documentos como páginas da web.
- [4. Construindo a interface](https://docs.twenty.com/l/pt/developers/extend/apps/tutorials/document-generator/building-the-ui.md): Views, navegação da barra lateral, um comando e componentes iniciais.
- [5. An AI agent](https://docs.twenty.com/l/pt/developers/extend/apps/tutorials/document-generator/ai-agent.md): Deixe um agente gerar documentos a partir de um chat, usando sua ferramenta.
- [6. Publicação](https://docs.twenty.com/l/pt/developers/extend/apps/tutorials/document-generator/publishing.md): Adicione metadados da loja e publique seu aplicativo.

##### Configuração

- [Visão Geral](https://docs.twenty.com/l/pt/developers/extend/apps/config/overview.md): Configure a própria aplicação — a sua identidade, permissões predefinidas e o que é executado no momento da instalação.
- [Configuração da aplicação](https://docs.twenty.com/l/pt/developers/extend/apps/config/application.md): Declare a identidade do seu app, o papel padrão, as variáveis e os metadados de marketplace com `defineApplication`.
- [Funções e Permissões](https://docs.twenty.com/l/pt/developers/extend/apps/config/roles.md): Declare quais objetos e campos as funções de lógica e os componentes de front-end do seu app podem ler e gravar.
- [Hooks de instalação](https://docs.twenty.com/l/pt/developers/extend/apps/config/install-hooks.md): Execute lógica durante o ciclo de vida de instalação, atualização ou desinstalação — popule dados iniciais, faça backup de registros, valide a atualização, limpe recursos externos.
- [Recursos públicos](https://docs.twenty.com/l/pt/developers/extend/apps/config/public-assets.md): Envie arquivos estáticos — imagens, ícones, fontes — junto com seu app por meio da pasta public/.

##### Dados

- [Visão Geral](https://docs.twenty.com/l/pt/developers/extend/apps/data/overview.md): Modele os dados que seu app adiciona a um workspace — objetos, campos e relações.
- [Objetos](https://docs.twenty.com/l/pt/developers/extend/apps/data/objects.md): Declare novos tipos de registro — tabelas personalizadas com seus próprios campos — usando defineObject.
- [Estendendo objetos](https://docs.twenty.com/l/pt/developers/extend/apps/data/extending-objects.md): Adicione campos a objetos padrão do Twenty (Person, Company, …) ou a objetos de outros apps usando defineField.
- [Referenciando metadados de sistema](https://docs.twenty.com/l/pt/developers/extend/apps/data/system-fields.md): Resolva os identificadores universais determinísticos dos metadados que o Twenty provisiona automaticamente em cada objeto, para que seu app possa referenciá-los sem hardcoding.
- [Relações](https://docs.twenty.com/l/pt/developers/extend/apps/data/relations.md): Conecte objetos entre si com relações bidirecionais MANY_TO_ONE / ONE_TO_MANY.
- [Tipos de Atividade Linha do Tempo](https://docs.twenty.com/l/pt/developers/extend/apps/data/timeline-activity-types.md): Define eventos de auditoria automáticos e eventos explícitos do aplicativo que renderizam em linhas de tempo registradas.

##### Lógica

- [Visão Geral](https://docs.twenty.com/l/pt/developers/extend/apps/logic/overview.md): TypeScript do lado do servidor que é executado dentro do Twenty — acionado por rotas HTTP, agendamentos cron, eventos de banco de dados, ferramentas de IA ou ações de fluxos de trabalho.
- [Funções lógicas](https://docs.twenty.com/l/pt/developers/extend/apps/logic/logic-functions.md): Defina funções TypeScript no lado do servidor com gatilhos HTTP, cron e de eventos de banco de dados.
- [Armazenamento de chave-valor](https://docs.twenty.com/l/pt/developers/extend/apps/logic/key-value-store.md): Persista resultados intermediários, armazene em cache dados e compartilhe estado entre execuções de funções lógicas com o armazenamento interno de chave-valor do aplicativo.
- [Tarefas em segundo plano](https://docs.twenty.com/l/pt/developers/extend/apps/logic/background-jobs.md): Entregue trabalhos longos ou com limitação de taxa aos workers do Twenty colocando na fila outra execução de função de lógica, em vez de fazer tudo inline.
- [Habilidades e agentes](https://docs.twenty.com/l/pt/developers/extend/apps/logic/skills-and-agents.md): Defina habilidades e agentes de IA para o seu aplicativo.
- [Conexões](https://docs.twenty.com/l/pt/developers/extend/apps/logic/connections.md): Permita que seu aplicativo aja em nome de um usuário em serviços de terceiros via OAuth.

##### Layout

- [Visão Geral](https://docs.twenty.com/l/pt/developers/extend/apps/layout/overview.md): Coloque seu app dentro da interface do Twenty — entradas na barra lateral, visualizações salvas, abas na página de registro e componentes React em sandbox.
- [Visualizações](https://docs.twenty.com/l/pt/developers/extend/apps/layout/views.md): Distribua visualizações salvas e pré-configuradas — ordem das colunas, filtros, grupos — para objetos no seu app.
- [Itens do menu de navegação](https://docs.twenty.com/l/pt/developers/extend/apps/layout/navigation-menu-items.md): Adicione entradas personalizadas à barra lateral do espaço de trabalho — links para visualizações salvas ou URLs externas.
- [Layouts de Página](https://docs.twenty.com/l/pt/developers/extend/apps/layout/page-layouts.md): Personalize páginas de detalhes de registros — abas, widgets e onde os front components são renderizados — usando `definePageLayout` e `definePageLayoutTab`.
- [Componentes de front-end](https://docs.twenty.com/l/pt/developers/extend/apps/layout/front-components.md): Crie componentes React que renderizam dentro da UI do Twenty com isolamento em sandbox.
- [Itens do menu de comandos](https://docs.twenty.com/l/pt/developers/extend/apps/layout/command-menu-items.md): Exponha componentes de front-end como ações rápidas e entradas do menu de comandos (Cmd+K) com `defineCommandMenuItem`.

##### Operações

- [Visão Geral](https://docs.twenty.com/l/pt/developers/extend/apps/operations/overview.md): Crie, teste e envie seu app — comandos de CLI, testes de integração, CI e publicação em um servidor ou no npm.
- [CLI](https://docs.twenty.com/l/pt/developers/extend/apps/operations/cli.md): comandos `yarn twenty` para executar funções, transmitir logs, gerenciar instalações de aplicativos e alternar remotos.
- [Sincronização e recuperação](https://docs.twenty.com/l/pt/developers/extend/apps/operations/sync-and-recovery.md): Qual comando usar em cada caso, como ler a saída da sincronização e uma escada de recuperação para quando os metadados locais se desalinham — antes de chegar a um reset completo.
- [Testes](https://docs.twenty.com/l/pt/developers/extend/apps/operations/testing.md): Configuração do Vitest, testes de integração contra um servidor Twenty real, verificação de tipos e CI com GitHub Actions.
- [Traduções](https://docs.twenty.com/l/pt/developers/extend/apps/operations/translations.md): Publique seu aplicativo em vários idiomas — traduza rótulos do manifesto e strings da interface do usuário por meio de um único catálogo de localidades.
- [Publicação](https://docs.twenty.com/l/pt/developers/extend/apps/operations/publishing.md): Distribua seu aplicativo Twenty no Marketplace ou implante-o internamente.

#### API

- [APIs](https://docs.twenty.com/l/pt/developers/extend/api.md): APIs REST e GraphQL geradas a partir do esquema do seu espaço de trabalho.
- [Webhooks](https://docs.twenty.com/l/pt/developers/extend/webhooks.md): Receba notificações quando os registros mudarem — HTTP POST para o seu endpoint a cada criação, atualização ou exclusão.
- [OAuth](https://docs.twenty.com/l/pt/developers/extend/oauth.md): Fluxo de código de autorização com PKCE e credenciais de cliente para acesso servidor a servidor.

#### Auto-Anfitrião

- [Docker Compose](https://docs.twenty.com/l/pt/developers/self-host/capabilities/docker-compose.md)
- [Configuração](https://docs.twenty.com/l/pt/developers/self-host/capabilities/setup.md)
- [Guia de atualização](https://docs.twenty.com/l/pt/developers/self-host/capabilities/upgrade-guide.md)
- [Resolução de Problemas](https://docs.twenty.com/l/pt/developers/self-host/capabilities/troubleshooting.md)

#### Contribuir

- [Configuração Local](https://docs.twenty.com/l/pt/developers/contribute/capabilities/local-setup.md): O guia para contribuidores (ou desenvolvedores curiosos) que desejam executar o Twenty localmente.
- [Comandos](https://docs.twenty.com/l/pt/developers/contribute/commands.md): Comandos úteis para desenvolver o Twenty.
- [Guia de Estilo](https://docs.twenty.com/l/pt/developers/contribute/style-guide.md): Convenções de código e práticas recomendadas para contribuir para o Twenty.