Pular para o guia

Da VPS ao primeiro atendimento

Seu CRM no ar.
Um passo de cada vez.

Do servidor ao WhatsApp conectado, este guia acompanha você na instalação do DeskcommCRM. Não precisa saber programar.

Software gratuito · Na sua VPS · Sem cobrança por usuário

O que você vai montar

crm.suaempresa.com.br

Na sua VPS

Seu CRM, do seu jeito.

ConversasFunil de vendasAgentes de IA
WhatsApp Conectado por QRSupabase Seu banco de dados

Antes de começar

Deixe estes acessos por perto. Vamos usar cada um no seu momento.

  • VPS e domínio

    Um servidor com 4 GB de RAM e o endereço que você quer usar. Os passos 1 e 4 ajudam com isso.

  • Conta no Supabase

    O banco de dados. Vamos gerar um único token no passo 3; o instalador cuida do projeto.

  • Celular com WhatsApp

    Para ler o QR code e conectar o número de atendimento ao CRM.

  • Chave de IA opcional agora

    OpenRouter, Anthropic ou OpenAI. Você pode instalar primeiro e cadastrar a chave depois.

O que você paga: a hospedagem, o domínio e a IA que consumir. O software é gratuito, e o Supabase tem um plano grátis com limites próprios.

Os links de VPS e domínio da HostGator são de parceria. Contratar por eles apoia o projeto.

Contrate o servidor

A VPS é o computador que mantém o seu CRM no ar, mesmo quando você fecha o seu notebook.

Na HostGator, escolha uma VPS com pelo menos 2 núcleos e 4 GB de RAM. A opção com Docker pronto simplifica a preparação. Se ele não estiver instalado, o instalador oferece instalar.

Ver VPS na HostGator ↗

Link de parceria: contratar por ele apoia o projeto. Se precisar de um domínio, você também pode registrá-lo na HostGator.

Guarde os dados de acesso enviados pela hospedagem: IP, usuário, senha e porta SSH. Eles entram no próximo passo.

Tudo certo quando: você tem o IP do servidor, usuário, senha e porta de acesso SSH.

Próximo: Acesso à VPS →

Entre na sua VPS

Você vai abrir o terminal do seu computador e entrar no servidor. A partir daí, os comandos rodam na VPS.

No Windows, abra o PowerShell. No Mac ou Linux, abra o Terminal. Troque SEU_IP pelo IP recebido e use o usuário informado pela hospedagem (geralmente root).

ssh root@SEU_IP
Minha hospedagem informou uma porta diferente de 22

Use o comando abaixo, substituindo SUA_PORTA pela porta informada.

ssh -p SUA_PORTA root@SEU_IP

Na primeira conexão, confira se o endereço é o da sua VPS. Se o terminal perguntar Are you sure you want to continue connecting?, digite yes. Depois, cole a senha e pressione Enter.

Portas e firewall: confira antes de continuar

As portas 80 e 443 precisam aceitar acesso ao site, no servidor e no painel da hospedagem.

Antes de ativar qualquer firewall, libere também a porta SSH que você está usando. Ela pode ser diferente de 22. Se usar a porta errada, você perde o acesso ao servidor; nesse caso, entre pelo console ou VNC da hospedagem para corrigir.

Tudo certo quando: o terminal mostra o usuário e o nome do servidor, depois de aceitar sua senha.

Próximo: Token do Supabase →

Gere o token do Supabase

O Supabase guarda seus contatos, conversas e negócios. Agora, um token de acesso pessoal permite que o instalador prepare o banco por você.

  1. Entre na sua conta do Supabase. Se ainda não tem uma, crie a conta primeiro.
  2. Abra Access Tokens — tokens de acesso e clique em Generate new token.
  3. Dê um nome que reconheça, como Instalação do CRM, gere o token e copie o valor. Ele começa com sbp_.
  4. Volte ao terminal dentro da VPS e execute o comando abaixo. Depois, cole o token quando ele pedir e pressione Enter.
read -r -s -p 'Cole o token do Supabase e pressione Enter: ' SUPABASE_ACCESS_TOKEN; export SUPABASE_ACCESS_TOKEN; printf '\n'

O campo fica oculto enquanto você cola. Mantenha esta conexão SSH aberta até rodar o instalador: o token fica disponível nessa sessão, sem colocá-lo no histórico de comandos.

Já tenho um projeto Supabase com dados

Este caminho com token cria um novo projeto quando as credenciais estão vazias. Para aproveitar um banco existente, siga o guia de projeto existente: nesse cenário, você informa as credenciais do projeto.

Use a conexão Session pooler, em modo URI, e confira Site URL e Redirect URLs no Supabase. Não rode uma instalação nova esperando recuperar os dados de outro projeto.

Tudo certo quando: o token está disponível no terminal da VPS. O projeto será criado automaticamente ao executar o passo 5.

Próximo: Domínio →

Aponte o seu domínio

Seu domínio é o endereço que você vai abrir no navegador. Vamos fazer esse endereço chegar à VPS.

Ainda não tem um domínio? Você pode registrá-lo na HostGator e depois seguir a configuração abaixo.

Registrar domínio na HostGator ↗

Link de parceria: registrar por ele apoia o projeto.

No painel onde seu domínio foi registrado, abra a área de DNS e crie um registro com estes valores:

Tipo
A
Nome / Host
crm (ou @ para usar o domínio principal)
Aponta para / Valor
O IP da sua VPS

Por exemplo: crm.suaempresa.com.br. Anote o endereço completo; é ele que você vai informar ao instalador. Use só o endereço, sem https:// e sem barra no final.

Tudo certo quando: o endereço escolhido aponta para o IP do servidor. O instalador confere isso antes de publicar o site.

Próximo: Instalação →

Instale o CRM

Com o token na mesma sessão SSH e o domínio preparado, é hora de colocar o CRM no ar.

No terminal da VPS, copie e execute

git clone https://github.com/melgarafael/DeskcommCRM.git deskcommcrm
cd deskcommcrm
bash hostgator-setup-kit/install.sh
unset SUPABASE_ACCESS_TOKEN

O primeiro comando baixa o projeto. Depois você entra na pasta e inicia a instalação. Ao final, o último comando retira o token desta sessão. Se o Git não estiver disponível, siga a orientação da sua hospedagem para instalá-lo.

O que vai acontecer

  1. Preparação: confere o servidor e oferece instalar o Docker se ele faltar.
  2. Banco automático: usa o token do passo 3 para criar o projeto Supabase e obter as credenciais.
  3. Suas informações: pergunta o domínio, os dados de acesso do administrador e qual IA você quer usar.
  4. Publicação: prepara o banco, baixa as imagens prontas do sistema e verifica os serviços. A VPS não precisa compilar o CRM.

Deixe estas respostas por perto

  • O domínio completo e seu e-mail para os avisos do certificado.
  • O e-mail e a senha que você quer usar para entrar como administrador.
  • O nome que quer mostrar na interface.
  • A chave de OpenRouter, Anthropic ou OpenAI, se já tiver uma. Você pode pular a chave e cadastrar depois.

A versão da imagem já vem sugerida. Com o banco criado pelo token, as quatro credenciais do Supabase são preenchidas automaticamente.

Prefiro instalar com ajuda de um assistente de IA

Abra seu assistente de programação dentro da VPS, pela conexão SSH. Você pode usar Claude Code, Codex ou OpenCode. Instale-o seguindo a documentação oficial e use este pedido:

Clone https://github.com/melgarafael/DeskcommCRM na minha VPS e instale o CRM seguindo hostgator-setup-kit/install.sh e o guia .agents/skills/deskcomm-instalar/SKILL.md. Use o token pessoal do Supabase para criar o projeto automaticamente, sem me pedir as quatro credenciais do banco. Eu vou colar o token diretamente no terminal, em um campo oculto. Conduza a instalação, me pergunte os outros dados quando precisar e resolva os erros sem expor segredos.

O assistente também pode pedir dados de domínio e administrador. O token do Supabase deve ser colado no campo oculto do terminal.

Ver os guias dos assistentes →

Tudo certo quando: o instalador mostra a conclusão e o endereço de acesso ao CRM.

Próximo: Primeiro acesso →

Faça o primeiro acesso

A parte do servidor terminou. Agora você continua pelo navegador, no endereço que escolheu.

  1. Abra https://crm.suaempresa.com.br, trocando pelo seu endereço.
  2. Entre com o e-mail e a senha do administrador que definiu na instalação.
  3. Siga o onboarding para informar o nome da empresa, o que ela faz e o fuso horário.

O certificado de segurança pode levar alguns minutos no primeiro acesso. Se aparecer um aviso, aguarde e recarregue. Se continuar, consulte a ajuda ao final desta página.

Tudo certo quando: você entrou no CRM com a conta do administrador e começou a configurar sua empresa.

Próximo: WhatsApp →

Conecte o WhatsApp

Tenha o celular por perto. O número de atendimento vai se conectar ao CRM por QR code.

  1. No celular, abra o WhatsApp → Aparelhos conectados → Conectar um aparelho.
  2. No passo de conexão do onboarding, gere o QR code.
  3. Leia o QR com a câmera do WhatsApp. Se expirar, clique em Gerar novo QR Code e tente de novo.
  4. Envie uma mensagem de outro número para conferir a chegada na Inbox do CRM.

Tudo certo quando: a conexão aparece ativa no CRM e você consegue acompanhar uma mensagem de teste na Inbox.

Próximo: Inteligência artificial →

Prepare a sua IA

A instalação coloca o sistema no ar. A configuração do agente ensina como ele deve atender o seu negócio.

Se pulou a chave na instalação, cadastre em IA → Credenciais. Se já informou, ela estará configurada. Você pode escolher entre OpenRouter, Anthropic e OpenAI.

Em Agente de IA → Agentes, configure o nome, as instruções, o tom de voz, as ações permitidas e a base de conhecimento da sua empresa. Faça uma conversa de teste para conferir as respostas antes de atender seus clientes.

Quer trocar a IA depois? A configuração de provedores fica na tela, sem reinstalar o sistema. O curso em imagens mostra onde clicar e como preparar o atendimento.

Tudo certo quando: sua credencial está cadastrada, o agente tem instruções do seu negócio e você conferiu uma conversa de teste.

Próximo passo: começar o curso visual →

Instalação concluída

Seu próximo passo é aprender a usar.

Continue no curso visual gratuito. Com telas reais e indicações de onde clicar, você aprende a atender pela Inbox, organizar o funil e configurar os agentes de IA.

Começar o curso visual →

Abra o CRM ao lado do curso e acompanhe no seu ritmo. A primeira lição apresenta a Inbox.

Instalou? Cuide do que é seu.

Para atualizar, procure “Nova versão” no rodapé do menu do CRM e clique em “Atualizar agora”. A tela mostra a mudança e acompanha a atualização, com backup antes.

Conferir a saúde do sistema

bash hostgator-setup-kit/healthcheck.sh

Fazer backup

bash hostgator-setup-kit/backup.sh

Atualizar pelo terminal

bash hostgator-setup-kit/update.sh

Redefinir a senha

bash hostgator-setup-kit/reset-password.sh seu@email.com

Recuperar acesso sem o autenticador

bash hostgator-setup-kit/reset-mfa.sh seu@email.com

Execute dentro da pasta deskcommcrm, na VPS. Nos comandos de recuperação, troque seu@email.com pelo e-mail da conta.

Preciso restaurar um backup

A restauração exige um banco vazio. Não rode uma instalação nova antes de restaurar, nem tente aplicar o backup por cima do banco em uso. Siga o guia de restauração para preparar o destino correto.

Travou? Comece por aqui.

As dúvidas mais comuns de quem instala pela primeira vez.

Colei a senha ou o token e não apareceu nada

É normal: o terminal esconde os campos secretos. Cole uma vez e pressione Enter. Nas perguntas do instalador, a confirmação “recebido” mostra quantos caracteres chegaram. Colar duas vezes junta os valores e pode invalidar a chave.

O Supabase recusou a criação do projeto

Confira se o token é um Personal Access Token da conta, gerado na página do passo 3, e se continua válido. Confira também se a conta ainda pode criar um projeto no plano escolhido. Se já existe um banco com dados, use o caminho de projeto existente; não crie outro para tentar recuperar esses dados.

O site não abre ou está sem cadeado

Confira se o registro A aponta para o IP da VPS e se as portas 80 e 443 estão liberadas no servidor e no painel da hospedagem. O domínio pode levar um tempo para propagar. Com Cloudflare, deixe “Somente DNS” até concluir a instalação. Aguarde a emissão do certificado e recarregue; não ignore o aviso de segurança do navegador.

A instalação parou. Preciso começar tudo de novo?

Volte à pasta deskcommcrm e rode bash hostgator-setup-kit/install.sh novamente. Ele aproveita as respostas já salvas e permite corrigir os campos. O token pessoal não é salvo: se for necessário, informe-o de novo. Não apague a configuração nem os dados para recomeçar.

Apareceu “Network unreachable” no banco

No caminho manual, a causa comum é usar a Direct connection do Supabase. Use Session pooler em modo URI, que aceita IPv4. O caminho com token do passo 3 descobre e testa a conexão automaticamente.

O QR code do WhatsApp expirou

Abra Aparelhos conectados no celular antes de gerar o QR. Na tela do CRM, clique em “Gerar novo QR Code” e escaneie o novo código. Use o número que você quer dedicar ao atendimento.

Fiquei sem acesso por SSH depois de ativar o firewall

Entre pelo console ou VNC no painel da hospedagem e libere a porta SSH correta. Uma VPS pode usar outra porta, além da padrão 22. Libere a porta que veio nos seus dados de acesso antes de ativar o firewall.

Ainda precisa de ajuda? Consulte os guias dos assistentes ou o catálogo de problemas do instalador. Não compartilhe senhas, tokens ou dados de clientes ao pedir ajuda.

Adaptado do guia original no Notion e revisado com o kit de instalação. Fluxo deste guia: Supabase na nuvem com token pessoal. Para banco no próprio servidor, veja o guia específico.