Guia: instale o Twenty, o CRM open source que é seu de verdade

Você viu no Reel: existe um jeito de parar de pagar pedágio por cadeira no CRM. Esse guia é o passo a passo que eu prometi.

1. O que é o Twenty

O Twenty é um CRM open source com licença AGPL-3.0, a alternativa aberta ao Salesforce, desenhado pra IA. O projeto tem quase 50 mil estrelas no GitHub, passou pelo Y Combinator (turma S23) e tem uma comunidade ativa desenvolvendo em cima dele todo dia.

O que faz ele ser diferente: tudo dentro dele é bloco de montar. Objetos, views, workflows e agentes são customizáveis. Você não se adapta ao CRM, o CRM se adapta ao seu processo.

2. Por que isso faz sentido pro seu negócio

Três motivos práticos:

• Usuário ilimitado. Vendedor novo não vira mensalidade nova. Você contrata quem precisar sem a fatura do CRM crescer junto.
• O dado do cliente fica na SUA infraestrutura. Ótimo pra LGPD: você sabe exatamente onde o dado está, quem acessa e como.
• O custo vira só o servidor. Em vez de pagar por cadeira, você paga uma VPS. A conta muda de patamar.

3. Os dois caminhos

Você tem duas opções, e as duas são legítimas:

1. Cloud gerenciada da própria Twenty. É paga, mas você não cuida de nada: sem servidor, sem backup, sem atualização. Bom pra quem quer só usar.
2. Self-hosted grátis via Docker. Você roda na sua infraestrutura, com controle total e custo de servidor. É esse caminho que o guia resume abaixo.

4. Instalação self-hosted (resumo)

O que você precisa antes de começar:

• Um servidor ou VPS com Docker instalado
• Um domínio (ou subdomínio) pra apontar pro CRM

Confira se o Docker está pronto:

docker --version
docker compose version

O repositório oficial tem um comando de instalação de uma linha que sobe tudo pra você. Copie ele direto da fonte oficial pra garantir que está na versão atual:

• Guia oficial: https://twenty.com/developers
• Repositório: https://github.com/twentyhq/twenty

Depois de rodar o instalador, o fluxo é:

1. Rodar o one-line install do guia oficial no servidor
2. Apontar seu domínio pro IP do servidor
3. Abrir o endereço no navegador e criar seu workspace
4. Convidar o time (sem pagar por cadeira nenhuma)

Siga o guia oficial na ordem. Ele cobre variável de ambiente, porta e certificado, e é atualizado junto com o produto.

5. Primeiros passos com IA

Aqui entra a parte que eu mais gosto. Como o Twenty foi desenhado pra IA, você usa o Claude ou outro agente pra modelar o CRM do seu jeito: descreve seu funil, os campos que importam no seu negócio e as automações que quer, e deixa o agente montar objetos, views e workflows pra você. Em vez de clicar em menu por horas, você conversa com o sistema.

Comece simples:

1. Modele seu funil de vendas (etapas reais do seu processo)
2. Crie os campos que seu time usa de verdade
3. Monte um workflow básico (ex: lead novo entra, atividade é criada)
4. Só depois automatize o resto

6. Aviso honesto

Self-host não é mágica: alguém precisa cuidar de backup e atualização. Se você não tem ninguém técnico no time, nem que seja um freela de confiança, a cloud gerenciada deles resolve e ainda sai mais simples que o CRM tradicional.

O ponto do Reel continua de pé nos dois caminhos: o dado é seu e você não paga pedágio por cadeira.

7. Crédito

O Twenty é um projeto open source mantido pela equipe e pela comunidade em https://github.com/twentyhq/twenty. Se a ferramenta te ajudar, deixa uma estrela no repositório. É de graça e sustenta o projeto.