Documentação White-Label 15 min de leitura

Instalar o WordChats White-Label e deixar com a sua marca

Este guia mostra, do começo ao fim e sem precisar programar, como colocar o WordChats no ar na sua própria VPS, com o seu nome, o seu domínio, os seus e-mails, os seus planos e a sua receita. Seus clientes só veem a sua marca — nunca "WordChats".

O que é o White-Label?

No modo White-Label, você recebe a plataforma completa do WordChats — atendimento no WhatsApp e Instagram, IA que responde 24h, agendamentos, campanhas, CRM — instalada num servidor seu e com a sua marca em cada detalhe. Você vira o dono de um SaaS: cria seus planos, define seus preços e cobra os seus clientes.

Sua marca e seu domínio
E-mails com o seu nome
Seus termos e privacidade
Seus planos e preços
Sua receita, sua conta
17+ recursos de IA prontos
Precisa saber programar?

Não — você não escreve nenhuma linha de código. A instalação é um comando que você cola no servidor e ele faz o trabalho pesado sozinho (servidor web, segurança/SSL, banco de dados e a plataforma). Existem algumas tarefas de configuração (conectar no servidor, apontar o domínio, ligar os pagamentos) que a gente te guia passo a passo aqui — e o nosso suporte ajuda se você travar em qualquer ponto.

O que você recebe

A plataforma inteira

Todos os recursos do WordChats, rodando no seu servidor, atualizável com um comando.

Marca 100% sua

Nome, logo, favicon, cores, e-mails e documentos legais — nada leva o nome "WordChats".

Seus clientes, seu banco

As empresas que assinam ficam no seu servidor e no seu banco de dados. Você é o dono dos dados.

Você define e cobra

Cria planos com os seus preços e recebe direto na sua conta de pagamentos.

Pré-requisitos

Antes de instalar, tenha em mãos:

Uma VPS (servidor virtual) com Ubuntu 22 ou 24 — pode alugar em qualquer provedor (Hostinger, Contabo, DigitalOcean, etc.)
Configuração mínima: 4 GB de RAM e 2 vCPUs (recomendamos 8 GB+ quando começar a crescer)
2 domínios (ou subdomínios) apontando para o IP da VPS — um para o painel e um para o sistema (ex.: painel.suamarca.com e api.suamarca.com)
As portas 80 e 443 abertas na VPS (é o padrão da maioria dos provedores)
Sua chave de licença White-Label (você recebe por e-mail após a compra — veja o Passo 1)
Uma conta de e-mail para envio (SMTP) — do seu domínio, Gmail Workspace, Zoho, Amazon SES, etc. (usada no Passo 6)
Uma conta de recebimento (Stripe) + uma conta na Stryhub para cobrar os seus clientes (Passo 7). A aprovação da Stripe pode levar alguns dias — comece cedo.
Seu logo e favicon prontos (imagens PNG) para aplicar a sua marca no Passo 5
Não sabe contratar uma VPS ou apontar um domínio?

Sem problema — a gente te ajuda no processo. Fale com o nosso time pelo WhatsApp e passamos o caminho das pedras junto com você.

Como funciona, em resumo

São 8 etapas. As 4 primeiras colocam o sistema no ar; as 4 seguintes deixam ele com a sua cara e prontos para vender:

Comprar Licença VPS + domínios Instalar
Sua marca E-mails Pagamentos Vender
Quanto tempo leva?

A parte "ativa" (rodar a instalação e configurar o painel) leva cerca de 30 minutos. Some a isso a espera do domínio apontar (de minutos a algumas horas) e, na primeira vez, a aprovação da conta de pagamentos (pode levar dias). Nada disso dá trabalho — é só aguardar enquanto você adianta as outras etapas.

Passo 1: Comprar e receber a sua licença

1

Depois de adquirir o plano White-Label, o processo é automático:

  1. Você recebe um e-mail com um link de acesso ao seu portal.
  2. No link, você define a sua senha e entra no portal do cliente White-Label.
  3. Dentro do portal ficam a sua chave de licença, o comando de instalação pronto para copiar, e a página de Atualizações.
Guarde a sua chave de licença

Ela tem o formato WC-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX e é usada na instalação e nas atualizações. O comando que aparece no portal já vem com a sua chave embutida.

Passo 2: Preparar a VPS e os domínios

2
  1. Contrate a VPS (Ubuntu 22/24, mínimo 4 GB RAM e 2 vCPUs). O provedor te dá o IP e uma senha de root.
  2. No painel de DNS do seu domínio, crie 2 registros do tipo A apontando para o IP da VPS — um para o painel e outro para o sistema. Ex.:
    painel.suamarca.com → IP e api.suamarca.com → IP
  3. Espere o domínio "propagar". Para conferir, teste o seu domínio em dnschecker.org — quando o IP da sua VPS aparecer no mapa, está pronto (leva de minutos a algumas horas).
Como fica um "registro A" na prática

No painel onde você registrou/gerencia o domínio, procure por DNS ou Zona DNS e adicione dois registros assim:

Tipo: A · Nome/Host: painel · Aponta para: SEU_IP · TTL: automático
Tipo: A · Nome/Host: api · Aponta para: SEU_IP · TTL: automático

Assim você fica com painel.suamarca.com e api.suamarca.com apontando para a sua VPS. Pode usar os nomes que preferir.

Por que dois domínios?

Um é o endereço que os seus clientes acessam (o painel). O outro é o "motor" do sistema. O instalador cuida de tudo — você só precisa deixar os dois apontando para o IP. O certificado de segurança (cadeado HTTPS) é gerado sozinho.

Passo 3: Instalar (um comando)

3

Você vai conectar na sua VPS e colar um comando. "Conectar" é abrir um terminal apontando para o seu servidor — chamamos isso de acesso SSH. O usuário é o root (o administrador do servidor, com poder total; o provedor te entrega a senha dele junto com o IP da VPS).

Como conectar na sua VPS (escolha 1 das 2)

1) Pelo seu computador: no Windows, abra o PowerShell (ou "Terminal"); no Mac/Linux, abra o Terminal. Digite ssh root@SEU_IP (troque SEU_IP pelo IP da VPS) e informe a senha de root quando pedir.

2) Pelo navegador (mais fácil): quase todo provedor (Hostinger, Contabo, etc.) tem um botão "Console" ou "Terminal" dentro do painel da VPS — ele abre um terminal já conectado, sem instalar nada.

Conectado, cole o comando que aparece no seu portal (ele já vem com a sua chave):

Terminal da VPS (como root)
curl -fsSL https://license.wordchats.com.br/install -o /tmp/wc-install.sh \
  && sudo bash /tmp/wc-install.sh WC-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

Durante a instalação, o script vai te perguntar 3 coisas simples:

  1. O nome do seu app (ex.: "MinhaMarca Chat")
  2. O domínio do painel (ex.: painel.suamarca.com)
  3. O domínio do sistema e um e-mail (para o certificado de segurança)

A partir daí é só aguardar. O instalador faz tudo sozinho:

Instala o servidor web e o banco
Gera o SSL (cadeado HTTPS)
Baixa e sobe a plataforma
Deu erro de domínio?

Quase sempre é o DNS que ainda não propagou. Confirme que os 2 domínios já apontam para o IP da VPS e rode o comando de novo. Em caso de dúvida, chame o nosso suporte.

Passo 4: Primeiro acesso

4

Terminou a instalação? Abra o domínio do painel no navegador e entre com o acesso padrão:

admin@admin.com 123456
Troque a senha imediatamente

Esse é o super admin (o dono do sistema — você). Antes de qualquer coisa, altere o e-mail e a senha desse acesso. É a sua conta de administrador de tudo.

Passo 5: Deixe tudo com a SUA marca

Aqui o sistema vira seu. Como super admin, você personaliza a marca em poucos cliques — e a partir daí nenhum cliente vê "WordChats" em lugar nenhum.

5

No painel, abra as Configurações Globais — no menu lateral, clique no seu perfil/engrenagem (a área do super admin) e depois em Configurações Globais. Lá você ajusta:

Aparência

Nome do app, logo, ícone (favicon) e a cor principal. Muda o topo, a aba do navegador e o app instalado no celular.

Marca nos e-mails

Todos os e-mails (boas-vindas, cobrança, avisos) saem assinados com o seu nome e o seu domínio — nunca "WordChats".

Termos e Privacidade

Aponte para os seus Termos de Uso e Política de Privacidade e informe a sua empresa como operadora. Seus clientes aceitam os seus documentos.

Suporte

Seu WhatsApp e e-mail de suporte. Onde você não preenche, o sistema simplesmente esconde o contato — nunca mostra o nosso.

Mudou a marca? O sistema inteiro acompanha.

Ao salvar o nome no painel, ele passa a valer no app, nos e-mails e nas mensagens automáticas — sem você precisar mexer em nada por baixo. É só configurar uma vez.

Passo 6: Ligar o envio de e-mails (SMTP)

6

Para os e-mails do sistema saírem pelo seu domínio, informe um servidor de envio (SMTP). Em Configurações Globais → Servidor de E-mail, preencha:

  1. Host e porta do seu provedor de e-mail
  2. Usuário e senha da conta de envio
  3. Remetente (o "de" que aparece pro cliente, ex.: contato@suamarca.com)

Use o botão de testar para confirmar que chegou. Serve qualquer SMTP (do seu domínio, Gmail Workspace, Zoho, Amazon SES, etc.).

Esse passo é obrigatório

No modo White-Label, o sistema não usa nenhum e-mail nosso. Enquanto o SMTP não estiver configurado, os e-mails (boas-vindas, recuperação de senha, cobrança) não são enviados. Configure antes de abrir para clientes.

Passo 7: Receber pagamentos (Stryhub)

Os pagamentos das suas assinaturas passam pela Stryhub (app.stryhub.com), que conecta a sua conta de pagamentos e cuida das cobranças automáticas. O dinheiro cai na sua conta — uma pequena taxa de plataforma é descontada automaticamente em cada venda.

Comece essa etapa cedo

Abrir/conectar a conta de recebimento (Stripe) costuma pedir dados da sua empresa (CNPJ) e a aprovação pode levar de algumas horas a alguns dias. Deixe encaminhado antes de abrir para clientes — enquanto isso, você adianta a marca e os e-mails.

7a

Na Stryhub (uma vez):

  1. Crie a sua conta e conecte a sua conta de recebimento (Stripe).
  2. Crie o(s) produto(s) — a Stryhub gera automaticamente o link de pagamento.
  3. Anote o ID do preço e o link do produto.
  4. Gere uma chave de API — copie e guarde (ela costuma aparecer só uma vez).
  5. Crie um webhook — é um aviso automático que a Stryhub manda pro seu sistema toda vez que alguém paga. Na URL, use o domínio do seu sistema + /stryhub-webhook. Ex.: https://api.suamarca.com/stryhub-webhook. Marque os eventos de pagamento e de assinatura (todos os payment.*, checkout.*, subscription.* e customer.created) — sem isso, o aviso não dispara. Depois de salvar, copie o segredo do webhook.
7b

No seu painel WordChats (super admin → Configurações Globais → Stryhub):

  1. Cole a chave de API e o segredo do webhook e salve.
  2. Pronto: quando um cliente pagar, o plano dele é ativado sozinho e o e-mail de boas-vindas sai com a sua marca.
Resumo do dinheiro

Cliente paga no seu link → cai na sua conta de recebimento → a plataforma desconta a taxa automaticamente → seu sistema ativa o plano na hora. Você não toca em nada manualmente.

Passo 8: Criar os seus planos (e os tokens de IA)

8

No menu Planos, você cria os seus próprios pacotes — com os seus preços, seus limites (número de conexões, usuários, recursos liberados) e o link de pagamento do passo anterior.

Recursos por plano

Ligue ou desligue cada recurso (IA, agenda, Instagram, campanhas...) por plano. Você monta a sua própria escada de preços.

Tokens de IA: você decide

Ao criar o plano, escolha a opção "Chave OpenAI própria": se ligada, cada empresa que assinar usa a chave de IA dela (o custo dos tokens é do cliente). Se desligada, a IA usa a configuração da plataforma.

Dica de modelo de negócio

Muitos donos de White-Label vendem planos com "chave própria" ligada para não terem custo de IA nenhum — o cliente traz a chave dele. Outros absorvem o custo e cobram mais caro. Os dois modelos funcionam; é a sua escolha, plano a plano.

Custos a considerar no seu preço

Ao montar os seus valores, lembre de 3 custos: o aluguel da VPS (mensal, do seu provedor), a taxa da plataforma de pagamentos (descontada automaticamente em cada venda — o percentual aparece na configuração da Stryhub) e, quando o plano não usa "chave própria", o custo dos tokens de IA. Com "chave própria" ligada, esse custo de IA é do cliente.

Licença e disponibilidade

Sua instalação verifica a licença automaticamente. É bom você saber como funciona:

Checagem automática

O sistema confere a licença ao ligar e a cada 5 minutos. Você não precisa fazer nada.

Tolerância a quedas

Se a verificação ficar indisponível, a instalação continua funcionando por até 72 horas usando o último "ok".

Enquanto a assinatura estiver em dia

Tudo roda normalmente. A licença acompanha a sua assinatura White-Label conosco.

Reativação na hora

Regularizando a assinatura, o acesso volta sozinho na próxima checagem — sem reinstalar nada.

E se a assinatura atrasar?

A instalação mostra uma tela de "serviço indisponível" com um botão de contato, até a regularização. Seus dados ficam guardados — nada é apagado. Assim que voltar em dia, tudo volta ao normal automaticamente.

Atualizações

Quando lançamos uma nova versão, ela aparece na página Atualizações do seu portal, com um comando pronto para copiar. Você cola na sua VPS (como root) e o sistema se atualiza sozinho — baixa a nova versão, ajusta o banco se preciso e reinicia. Tem esta cara (use sempre o do seu portal):

Terminal da VPS (como root)
curl -fsSL https://license.wordchats.com.br/update-script -o /tmp/wc-update.sh \
  && sudo bash /tmp/wc-update.sh WC-XXXXX
Sem perder configuração

A atualização preserva a sua marca, os seus clientes e os seus dados. É seguro rodar sempre que uma versão nova sair.

Solução de problemas

A instalação travou

Quase sempre é o domínio ainda não apontando. Confira os 2 domínios no dnschecker.org e rode o comando de novo.

Não consigo logar

Abra o domínio do painel com https. Use admin@admin.com / 123456 (se ainda não trocou) e limpe o cache com Ctrl+F5.

E-mail não chega

Confira o SMTP (Passo 6) e use o botão de testar. Veja também se caiu na caixa de spam.

Cliente pagou e o plano não ativou

Confirme a chave de API e o segredo do webhook no painel (Passo 7) e a URL do webhook na Stryhub.

Faça backup dos seus dados

Agora você guarda dados de clientes. Ative snapshots automáticos da VPS no seu provedor (a maioria oferece com poucos cliques). Se algo der errado, você restaura rápido.

Travou em algo? Não fique parado.

Chame o nosso suporte que a gente resolve junto — da VPS à sua primeira venda.

Perguntas Frequentes

Meus clientes vão ver o nome "WordChats" em algum lugar?

Não. Depois de configurar a sua marca (Passo 5), o app, os e-mails, as mensagens automáticas, os documentos legais e o app instalado no celular usam só o seu nome. Onde você não preencher um contato de suporte, o sistema esconde o campo em vez de mostrar o nosso.

Preciso saber programar para instalar?

Não. A instalação é copiar e colar um comando no servidor — ele faz todo o trabalho técnico. Toda a personalização e o dia a dia são feitos clicando no painel. Se travar em algum ponto, o nosso suporte te acompanha.

Como eu recebo o dinheiro das assinaturas?

Direto na sua conta de recebimento, conectada via Stryhub (Passo 7). O cliente paga no seu link, o valor cai pra você e o sistema ativa o plano na hora. Uma pequena taxa de plataforma é descontada automaticamente em cada venda.

Posso ter os meus próprios planos e preços?

Sim, totalmente. Você cria quantos planos quiser, define os preços, escolhe os recursos de cada um e decide se os tokens de IA são por conta do cliente (chave própria) ou da plataforma. É o seu negócio, as suas regras.

Os dados dos meus clientes ficam comigo?

Sim. Tudo roda na sua VPS e no seu banco de dados. As empresas que assinam o seu sistema são suas — você é o responsável e o dono dos dados, com os seus próprios termos e política de privacidade.

Quantas empresas a instalação aguenta?

Depende do tamanho da VPS. A configuração mínima (4 GB) atende os primeiros clientes; conforme crescer, você aumenta a RAM/CPU da VPS (a maioria dos provedores faz isso com poucos cliques). É uma plataforma pensada para escalar.

E se a minha VPS ou o meu domínio mudarem?

É possível trocar de domínio depois — fale com o suporte que orientamos o procedimento. A recomendação é começar já com o domínio definitivo para evitar retrabalho.

Recebo atualizações e novos recursos?

Sim. Cada versão nova aparece no seu portal com um comando de atualização. Você atualiza quando quiser, sem perder a sua marca nem os seus dados.

Precisa de ajuda para instalar?

Nosso time acompanha você em cada etapa — da VPS à sua primeira venda. Fale com a gente e comece o seu SaaS com a sua marca.