# CRM de WhatsApp Grátis com Agente de IA: Guia Completo de Instalação

> É possível instalar um CRM de WhatsApp completo, open-source e gratuito com agente de IA integrado utilizando uma VPS KVM na Hostinger e banco de dados Supabase, realizando o deploy autônomo através do Claude Code no terminal para gerenciar múltiplos atendentes, funil de vendas e respostas automáticas sem pagar mensalidades de software.

- URL canônica: https://blog.lenaai.com.br/crm-whatsapp-gratis-agente-ia
- Autor: Thalena Lima; publicado por Lena AI.
- Publicado em 22 de setembro de 2026; atualizado em 23 de setembro de 2026.
- Leitura estimada: 9 min.
- Categorias: IA na prática, Tecnologia, Tutorial.
- Conteúdo complementar: https://www.youtube.com/watch?v=KAjty1a7MI4

---

> O CRM de WhatsApp open-source é um sistema de atendimento multicanal e gestão de clientes auto-hospedado que elimina mensalidades de plataformas proprietárias, integrando bate-papo ao vivo, múltiplos operadores, funil de vendas tipo Kanban e agentes de inteligência artificial autônomos para qualificação e suporte em tempo real.

## O custo oculto dos CRMs de WhatsApp proprietários

Para agências de marketing, prestadores de serviço e empresas com operação ativa no WhatsApp, ferramentas de atendimento centralizado tornaram-se itens de primeira necessidade. No entanto, o modelo tradicional de SaaS impõe restrições severas: cobrança por número de operadores conectados, taxas por conversas ativas e limitações de disparos que facilmente elevam a fatura mensal para além de R$ 500 a R$ 1.500.

Além do custo financeiro contínuo, existe o problema do aprisionamento de dados (*vendor lock-in*): todo o histórico de interações, números de telefone e métricas de conversão ficam retidos em servidores de terceiros.

A alternativa definitiva é a implementação de um sistema auto-hospedado (*self-hosted*). Utilizando um projeto open-source comunitário (o repositório [Deskcomm](https://github.com/thalena-lima/deskcomm), baseado no trabalho de Rafael Melgasso e expandido pela comunidade), qualquer profissional pode hospedar sua própria central de WhatsApp, desfrutando de recursos avançados com custo fixo insignificante de infraestrutura.

| Funcionalidade | Plataforma SaaS Proprietária | CRM Open-Source Self-Hosted |
|---|---|---|
| **Custo de Licença** | R$ 300 a R$ 1.500 / mês | R$ 0 (100% Gratuito) |
| **Limite de Atendentes** | Cobrado por usuário adicional | Ilimitado (depende da VPS) |
| **Custódia dos Dados** | Servidor de terceiros | Banco próprio (Supabase / Postgres) |
| **Agente de IA Integrado** | Cobrança extra ou inacessível | Conexão nativa via API (OpenAI / Claude) |
| **White Label** | Planos Enterprise caríssimos | Totalmente customizável com sua marca |

![Interface completa do CRM de WhatsApp com painel de atendimento e agente de IA](https://raw.githubusercontent.com/vinilevy/lena-blog-assets/main/posts/crm-whatsapp-gratis-agente-ia/crm_whatsapp_ai_dashboard.jpg)

## A arquitetura da solução própria: VPS, Supabase e Domínio

Para colocar o CRM no ar com alta disponibilidade e estabilidade de produção, a infraestrutura é dividida em três pilares complementares:

1. **Servidor Virtual Privado (VPS):** A máquina onde o sistema operacional, os containers da aplicação e o gateway de conexão do WhatsApp rodam 24 horas por dia. O ambiente recomendado é a VPS KVM da Hostinger.
2. **Banco de Dados Gerenciado (Supabase):** Atua como o repositório seguro onde todas as conversas, contatos, pipelines e credenciais são armazenadas. O plano gratuito do Supabase oferece PostgreSQL robusto com folga para operações comerciais.
3. **Domínio Personalizado e DNS:** Garante que o CRM responda sob uma URL profissional (ex: `crm.suaempresa.com.br`) com certificado SSL criptografado automático.

![Arquitetura técnica do CRM de WhatsApp com VPS Hostinger e banco Supabase](https://raw.githubusercontent.com/vinilevy/lena-blog-assets/main/posts/crm-whatsapp-gratis-agente-ia/crm_whatsapp_architecture.jpg)

> [!tip] **Infraestrutura com Desconto Exclusivo**  
> Você pode contratar a [Hospedagem VPS da Hostinger com desconto por este link oficial](https://www.hostg.xyz/SHJ5B). Utilize o cupom **THALENA** no checkout para garantir **10% OFF adicional** nos planos anuais de VPS.

## Passo a passo de instalação e configuração

### 1. Criando o Banco de Dados no Supabase
O banco de dados é a gaveta central do CRM:
- Acesse o Supabase e crie um novo projeto definindo o nome da organização e uma senha forte.
- Navegue até **Project Settings** > **API Keys**.
- Localize e copie as duas variáveis fundamentais: a **Project URL** e a **chave anônima (anon key)** ou **service_role key**. Guarde esses valores com segurança para o preenchimento do ambiente.

### 2. Contratando e acessando a VPS na Hostinger
- No painel da Hostinger, selecione o plano de VPS KVM e utilize o cupom `THALENA`.
- Defina a senha de root do servidor.
- Acesse o terminal da máquina diretamente pelo navegador através da opção **Web Console** no painel da Hostinger, sem necessidade de programas externos de SSH.

### 3. Apontando o Domínio no DNS
- No gerenciador de DNS do seu domínio, crie um registro do tipo `A`.
- No campo **Nome/Host**, insira o subdomínio desejado (ex: `crm`).
- No campo **Aponta para (IP)**, cole o endereço IPv4 público da sua VPS.
- Utilize ferramentas como o *DNS Checker* para confirmar a propagação do registro antes de iniciar o deploy.

## Instalação autônoma via Claude Code no terminal

Embora seja possível executar a instalação através de scripts manuais tradicionais, o método mais eficiente demonstrado por Thalena Lima consiste em delegar a montagem do ambiente para um agente de IA CLI: o **Claude Code**.

1. **Instalação do Claude Code na VPS:** Com o terminal da Hostinger aberto, execute a instalação do pacote global e autentique com sua conta Anthropic.
2. **Execução Assistida:** Ao iniciar o Claude Code dentro da VPS, o modelo analisa a máquina limpa, clona o repositório do CRM ([github.com/thalena-lima/deskcomm](https://github.com/thalena-lima/deskcomm)), solicita as credenciais do Supabase e configura o arquivo `.env` sem erros de digitação.
3. **Build e Inicialização:** O agente executa a compilação dos módulos e inicializa os processos, devolvendo a URL pronta para primeiro login.

## Conexão do WhatsApp e ativação do Agente de IA

Com o painel no ar, o acesso é realizado pela URL configurada no navegador:
- **Leitura de QR Code:** No menu lateral em **Conexões**, clique em **Conectar Novo WhatsApp**. Aponte a câmera do seu smartphone pelo aplicativo oficial do WhatsApp para parear a sessão instantaneamente.
- **Parametrização do Agente de IA:** No módulo de automações, insira sua chave de API de LLM (como OpenAI ou Anthropic) e configure as instruções de comportamento (*system prompt*). O agente assume o atendimento de novas mensagens, executa triagem, qualifica o lead e move os contatos automaticamente entre as etapas do Kanban.

## Oportunidade de negócio e expansão da sua operação

A licença de código aberto deste projeto permite personalização completa (White Label). Você pode alterar a paleta de cores, aplicar o logotipo da sua própria agência e fornecer o CRM como serviço gerenciado para pequenas e médias empresas do seu portfólio, cobrando mensalidades recorrentes de R$ 500 a R$ 2.000 por suporte e infraestrutura.

Para quem deseja acelerar essa jornada e ter acesso a recursos prontos:

* 🎁 **Templates Gratuitos e Comunidade:** Baixe prompts, fluxos e participe da nossa rede na [Lena Academy Oficial](https://academy.lenaai.com.br/?utm_source=organico&utm_medium=blog&utm_campaign=crm-whatsapp).
* 🎓 **Formação Profissional:** Se você quer dominar a criação e venda de ecossistemas completos de IA para empresas, conheça o [Treinamento Completo IA Experts com Thalena Lima](https://iaexperts.thalena.com.br/?utm_source=organico&utm_medium=blog&utm_campaign=crm-whatsapp).
* 🏢 **Implementação Empresarial:** Para empresas que preferem uma solução corporativa sob medida entregue pela nossa equipe de engenharia, [conheça os serviços e implementações da Lena AI](https://lp.lenaai.com.br/?utm_source=organico&utm_medium=blog&utm_campaign=crm-whatsapp).

## Assista ao tutorial prático no YouTube

Você pode acompanhar a demonstração tela a tela da configuração da VPS, do banco Supabase e da ativação do agente no vídeo oficial gravado por Thalena Lima:

> **Vídeo complementar:** [CRM de WhatsApp Grátis com Agente de IA (Instalação Completa)](https://www.youtube.com/watch?v=KAjty1a7MI4)

## Respostas diretas

**Como funciona a infraestrutura de um CRM de WhatsApp próprio?**

A infraestrutura é composta por três camadas integradas: uma máquina virtual (VPS) na Hostinger para hospedar o servidor da aplicação, um banco de dados PostgreSQL gratuito no Supabase para guardar mensagens e contatos, e o domínio com apontamento DNS.

**Qual a função do Claude Code na instalação do CRM?**

O Claude Code atua como um agente autônomo dentro do terminal da VPS, clonando o repositório, configurando o arquivo .env com as chaves do Supabase e subindo a aplicação automaticamente.


## Perguntas frequentes

**Preciso saber programar para instalar este CRM de WhatsApp?**

Não. Você pode utilizar o Claude Code diretamente no console web da VPS da Hostinger, permitindo que a própria IA leia o repositório, configure as variáveis e execute os comandos de instalação.

**Posso vender esse CRM para clientes da minha agência?**

Sim. O sistema possui licença open-source permissiva que viabiliza personalização total (White Label), permitindo trocar logotipo, cores e revender como serviço gerenciado para seus clientes.

**O sistema suporta WhatsApp via QR Code e API Oficial?**

Sim. A plataforma suporta tanto conexão simples por leitura de QR Code quanto integração com a API Oficial da Meta (Cloud API).


## Fontes

- [CRM de WhatsApp Grátis com Agente de IA por Thalena Lima](https://www.youtube.com/watch?v=KAjty1a7MI4): Demonstração técnica em vídeo do deploy e configuração de CRM de WhatsApp open source com banco Supabase, instalação assistida por IA via Claude Code e conexão de agente inteligente.
