Como resolver os erros mais comuns ao configurar o White Label no GoHighLevel

Erro 1: o domínio white label não carrega ou fica em loop

Sintoma: você aponta app.suaagencia.com.br e o navegador mostra erro de servidor, página em branco ou um redirecionamento infinito.

Causa quase sempre é uma destas três:

1. Registro DNS errado. O subdomínio precisa de um CNAME apontando para o host indicado em Settings › Company › White Label Domain. Registro A com IP fixo não funciona e quebra na próxima mudança de infraestrutura.
2. Proxy da Cloudflare ativado (nuvem laranja). Ele intercepta o certificado e gera loop. Deixe a nuvem cinza, apenas DNS.
3. Você usou o domínio raiz em vez de um subdomínio. Use sempre app. ou crm. — o domínio raiz deve continuar apontando para o seu site institucional.

Depois de corrigir, aguarde a propagação real. Ela leva de 15 minutos a 24 horas; verifique com uma ferramenta de consulta DNS antes de abrir chamado.

Erro 2: aviso de certificado SSL inválido no domínio da agência

O certificado é emitido automaticamente depois que o CNAME é validado. Se o aviso persiste por mais de algumas horas:

• Confirme que existe apenas um registro para aquele subdomínio. Dois CNAMEs, ou um CNAME e um A juntos, impedem a emissão.
• Se usa Cloudflare, mude o modo SSL/TLS para Full (strict) e mantenha o proxy desativado nesse subdomínio.
• Remova o domínio nas configurações de White Label, salve, aguarde cinco minutos e adicione de novo para forçar nova emissão.
• Verifique se há registro CAA no domínio restringindo emissores; se houver, autorize letsencrypt.org.

Erro 3: e-mails do sistema ainda saem com a marca original

Convites de usuário, redefinição de senha e notificações automáticas usam um remetente definido em outro lugar da conta — por isso mudar o logo não resolve.

1. Em Settings › Company, preencha nome da empresa, logo e favicon com os seus ativos.
2. Em Settings › Email Services, configure um domínio de envio próprio e autentique SPF, DKIM e DMARC no seu DNS.
3. Defina o endereço de remetente padrão com o seu domínio (ex.: nao-responda@suaagencia.com.br).
4. Nas subcontas, repita a definição de remetente: a configuração da agência não é herdada automaticamente em todos os pontos.
5. Envie um convite de teste para um endereço externo e confira o cabeçalho do e-mail recebido.

Erro 4: links internos e app mobile continuam expondo a marca original

• Links de calendário, formulários e funis usam o domínio da subconta. Configure um domínio ou subdomínio próprio em cada subconta, em Settings › Domains.
• O app mobile com sua marca é um recurso do plano de revenda e exige um processo de submissão separado às lojas; até ele ser aprovado, oriente o cliente a usar a versão web.
• Links de documentação e vídeos de ajuda dentro do painel podem ser ocultados nas opções de White Label — revise item por item, porque novos módulos entram com o padrão original.
• O favicon fica em cache no navegador do cliente: peça um recarregamento forçado antes de concluir que não funcionou.

Erro 5: SaaS Mode ativado mas o cliente não é cobrado

Esse é o erro mais caro, porque você entrega a plataforma e não recebe. Percorra a lista na ordem:

1. Conecte a conta de pagamento na conta de agência e confirme que ela está em modo de produção, não em teste.
2. Crie os planos de venda com preço, moeda e período corretos, e publique cada um deles.
3. Ative o SaaS Mode individualmente na subconta do cliente — ativar no nível de agência não aplica retroativamente.
4. Habilite o rebilling dos itens de consumo (SMS, e-mail, chamadas, IA) e defina a sua margem; sem isso o consumo do cliente sai do seu bolso.
5. Faça uma assinatura de teste com valor simbólico e cancele em seguida, verificando se a cobrança e o provisionamento automático da subconta ocorreram.

Quando o problema é realmente da plataforma

Se DNS, SSL, remetente e permissões estão corretos e o comportamento persiste, junte evidências antes de abrir o chamado: horário exato, ID da subconta, prints da tela de erro e o resultado da consulta DNS. Chamados com evidência técnica saem da primeira linha de suporte muito mais rápido — e essa é a diferença entre resolver em um dia ou em duas semanas.