Skip to main content
Neste tutorial, você vai criar o Gerador de Documentos — um aplicativo que transforma modelos reutilizáveis em documentos personalizados usando os dados que você já tem no seu CRM. Escreva um modelo uma vez com {{placeholders}} e, em seguida, gere um documento preenchido para qualquer Pessoa ou Empresa com um clique — a partir do menu de comandos, de um agente de IA ou de um fluxo de trabalho.

Um modelo, gerado para uma pessoa específica, aberto como uma página para impressão.

O que você vai aprender

Cada capítulo adiciona uma capacidade. Ao final, você terá usado a maior parte do SDK.

Pré-requisitos

Você deve ter concluído o Quick Start: um servidor Twenty local em execução na porta 2020 e o CLI autenticado nele. Se não, gere a estrutura e inicie um agora:
Prefere ler o código finalizado? O aplicativo completo está em packages/twenty-apps/examples/document-generator. Cada trecho abaixo foi copiado de lá.

Como o aplicativo se encaixa

Você escreve um modelo uma vez em um editor de texto rico, com {{placeholders}}. Escolher um modelo e um registro de CRM preenche os placeholders e armazena um documento finalizado (com um arquivo PDF). Todo o resto — o menu de comandos, o agente de IA, a etapa do fluxo de trabalho, o link compartilhável — é apenas uma forma diferente de acionar aquele único gerador.

Mantenha este ciclo em execução

Deixe yarn twenty dev rodando em um terminal durante todo o tutorial. Toda vez que você adicionar ou editar um arquivo em src/, ele será ressíncronizado com o seu servidor em alguns segundos, para que você possa ver cada capacidade aparecer na UI conforme a constrói.

Comece a construir →

Capítulo 1: modele documentos e modelos de documento.