Saltar para o conteúdo principal
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 documento de proposta de vendas gerado

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

Um modelo com placeholders é transformado em um documento finalizado com um PDF, acionado a partir do menu de comandos, de um agente de IA, de um fluxo de trabalho ou de um link compartilhável
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.