Passar para o conteúdo principal

Solução de problemas na configuração de domain personalizado e HTTPS/SSL

Está tendo problemas para configurar seu domain personalizado no Help Center? Este artigo apresenta várias etapas de solução de problemas que você pode tentar.

Escrito por Ivan Branimir Skoric

Configurando HTTPS (configuração manual) ou HTTP

Para ativar HTTPS ou HTTP para seu domain personalizado:

  • Navegue até Settings > Help Center > Configure & Style

  • Na seção "Domain", localize a configuração "Security protocol"

  • Defina o "Security protocol" para HTTPS (configuração manual) ou HTTP

  • Salve suas alterações

Verifique se você configurou o CNAME corretamente

Se você estiver usando HTTPS (configuração manual) ou HTTP, verifique se o registro CNAME está configurado para:

  • Se seu workspace estiver hospedado nos EUA - custom.intercom.help

  • Se seu workspace estiver hospedado na Europa - custom.eu.intercom.help

  • Se seu workspace estiver hospedado na Austrália: custom.au.intercom.help

Se você estiver usando HTTPS (configuração rápida), verifique se o registro CNAME está configurado para:

  • Se seu workspace estiver hospedado nos EUA - us.intercomhelpcenter.com

  • Se seu workspace estiver hospedado na Europa - eu.intercomhelpcenter.com

  • Se seu workspace estiver hospedado na Austrália: au.intercomhelpcenter.com

HTTPS (configuração rápida) pode não estar disponível para seu workspace.

Para verificar em qual região seu workspace está hospedado, observe a barra de URL do seu navegador ao usar o Intercom.

Se a URL começar com:

  • app.intercom.com, seu workspace está hospedado nos EUA

  • app.eu.intercom.com, seu workspace está hospedado na Europa

  • app.au.intercom.com, seu workspace está hospedado na Austrália

Verifique se as alterações do CNAME foram propagadas

As alterações do CNAME levam algum tempo para propagar. Isso pode levar até 72 horas dependendo do seu provedor.

Você pode verificar se a alteração do CNAME foi propagada usando uma ferramenta como MXToolbox.

Outra ferramenta útil para verificar a propagação do DNS é whatsmydns.net, que pode ajudar a confirmar que suas alterações de DNS foram propagadas globalmente.

Certifique-se de usar a consulta CNAME no MXToolbox

Se você estiver usando HTTPS (configuração manual) - nesse caso, executar uma verificação CNAME normalmente não retornará dados, pois não há necessidade do DNS estar vinculado a um domain Intercom. A configuração é feita dentro do serviço que você configurou para implementar o HTTPS.

Verifique suas configurações do Cloudflare

Se você estiver usando Cloudflare, certifique-se de que a nuvem ao lado do seu registro CNAME esteja laranja e que você tenha configurado o SSL na seção "Crypto" para "Flexible" ou "Full".

Não escolha ‘Full (Strict)’ pois isso resultará em um certificado SSL inválido.

Certifique-se de que seu Help Center está ativo

Vá para Settings > Help Center e certifique-se de que seu Help Center está Live.

Resolvendo erros SSL no seu Help Center Intercom

Quando você encontrar erros SSL como ERR_SSL_VERSION_OR_CIPHER_MISMATCH ou SSL_ERROR_NO_CYPHER_OVERLAP no seu Help Center Intercom, isso indica um problema na conexão segura entre seu navegador e o servidor. Este guia ajudará você a entender e resolver esses problemas comuns.

Entendendo ERR_SSL_VERSION_OR_CIPHER_MISMATCH

Esse erro ocorre quando seu navegador não consegue estabelecer uma conexão segura com o servidor devido a problemas na configuração do SSL (Secure Sockets Layer).

Causas comuns

Configurações DNS incorretas ou atrasos na propagação: Os registros DNS (Domain Name System) podem estar configurados incorretamente ou ainda não terem sido totalmente propagados pela internet.

Exemplo: Um registro CNAME (Canonical Name) apontando para us.intercomhelpcenter.com da Intercom pode ainda não ter sido propagado.

Dica: Aguarde até 24 horas para que as alterações de DNS tenham efeito. A propagação do DNS pode levar tempo dependendo do seu provedor de domain e do provedor de internet.

Certificados SSL conflitantes ou duplicados: Se você estiver usando HTTPS com um domain personalizado (configuração rápida), a Intercom fornece o certificado SSL. Qualquer certificado conflitante ou adicional configurado no seu provedor de domain causará erros e deve ser removido.

Dica profissional: Certifique-se de que apenas o certificado SSL fornecido pela Intercom esteja ativo para seu domain personalizado para evitar conflitos.

Entendendo SSL_ERROR_NO_CYPHER_OVERLAP

Esse problema ocorre durante o handshake SSL/TLS (Transport Layer Security) quando o servidor e o cliente não conseguem concordar sobre os protocolos de criptografia ou conjuntos de cifras suportados.

Resolvendo problemas de sobreposição de cifras

Garanta padrões de criptografia atualizados: Tanto seu navegador quanto o servidor devem suportar padrões modernos de criptografia.

Nota: Navegadores ou sistemas operacionais mais antigos podem não suportar os protocolos de criptografia mais recentes, causando esse erro.

Dica: Atualize seu navegador para a versão mais recente para garantir suporte aos padrões atuais de criptografia.


Resolvendo erros de handshake SSL para link branding

A Intercom não configura SSL para link branding em domains personalizados. Você é responsável por configurar e gerenciar os certificados SSL dentro do seu provedor de domain para link branding.

Resolvendo problemas SSL de Link Branding

Visite as configurações de SSL do seu provedor de domain: Para resolver problemas de handshake SSL para link branding, você precisará configurar o certificado SSL diretamente com seu provedor de domain.

Nota: Isso é separado do certificado SSL que a Intercom fornece para o domain principal do seu Help Center.

Importante: Consulte a documentação ou suporte do seu provedor de domain para instruções específicas sobre como configurar e solucionar problemas de certificados SSL.

Se seu certificado SSL for gerenciado por um provedor terceirizado, certifique-se de que ele ainda é válido.

Certifique-se de ter pelo menos um artigo publicado

Se você estiver vendo Not found ao tentar acessar seu Help Center, certifique-se de que há pelo menos um artigo publicado. Se não houver artigos publicados, seu Help Center ficará inativo e retornará Not found.

Erro 1014 - CNAME Cross-User Banned

Se você encontrar o Erro 1014 ao visitar seu domain personalizado do Help Center, provavelmente é devido a um problema de CNAME Cross User do Cloudflare. Para resolver esse erro:

  • Configurações DNS do Cloudflare: Certifique-se de que o registro CNAME esteja configurado no modo DNS-only (ícone de nuvem cinza) no Cloudflare, não proxy. A configuração proxy (ícone de nuvem laranja) pode resultar no erro 1014.

  • Registro CNAME: Crie um registro CNAME e certifique-se de que seu domain personalizado aponte para custom.intercom.help ou us.intercomhelpcenter.com (dependendo do seu método de configuração HTTPS)

  • Aguarde até 48 horas para a propagação do DNS. Se o problema persistir, pode ser necessária uma investigação mais aprofundada nas configurações do servidor.

Uma causa comum, mas fácil de esquecer, do Erro 1014 é não selecionar o protocolo de segurança correto nas configurações do seu Help Center Intercom após criar o registro CNAME. Mesmo que seu DNS esteja configurado corretamente, o domain personalizado não será validado até que essa etapa seja concluída. Para resolver esse problema, vá para Settings > Help Center > Configure & Style, abra a seção Domain e selecione a opção que corresponde à sua configuração DNS: HTTPS (Quick Setup) se seu CNAME apontar para us.intercomhelpcenter.com, ou HTTPS (Manual Setup) se seu CNAME apontar para custom.intercom.help. Lembre-se de salvar suas alterações após selecionar.

Importante: Se você estiver em um plano Cloudflare Enterprise ou superior, certifique-se de que o Zone Hold esteja desativado para seu domain. O Zone Hold valida que os nomes de host resolvem para endereços IP associados à mesma conta Cloudflare, o que impedirá o funcionamento do HTTPS Quick Setup e retornará um erro 1014 Cross-User Banned. Para desativá-lo, vá às configurações da sua conta Cloudflare e desligue o Zone Hold para o domain afetado.

Erro "Access Denied" durante a configuração HTTPS

Se você encontrar um erro "Access Denied" ao configurar o HTTPS:

  • Verifique se seu registro CNAME aponta para o domain regional correto

  • Se estiver usando Cloudflare, certifique-se de que o modo SSL esteja configurado como "Flexible" ou "Full" (não "Full (Strict)")

  • Reiniciar a configuração SSL desligando a configuração HTTPS, aguardando alguns minutos e ligando-a novamente é uma etapa recomendada de solução de problemas.

Usando Amazon CloudFront?

Certifique-se de seguir todas as etapas no guia.

Usando Proxy Reverso Personalizado?

  • Certifique-se de seguir os guias.

  • Exemplo de consulta CNAME para configuração de proxy reverso: não encontrará nada, mas indicará qual servidor DNS você utiliza.


Recebendo erro 502 ao acessar custom.domain/robots.txt?

Se você estiver usando nginx (ou ingress nginx), verifique seus logs para:

“upstream sent too big header while reading response header from upstream”

Se encontrar essa mensagem nos seus logs, você precisa aumentar, na anotação do seu ingress (o padrão é 4k):

nginx.ingress.kubernetes.io/proxy-buffer-size: "8k"


Isso resolverá o problema do erro 502 ao acessar custom.domain/robots.txt

E se o status da configuração HTTPS permanecer “Pending” por um longo período?

Se o status da configuração HTTPS permanecer “Pending” por um longo período, siga estas etapas:

  • Verifique sua configuração DNS para problemas comuns:
    • Certifique-se de que o registro CNAME está formatado corretamente e não inclui partes extras do domain (por exemplo, não adicione seu próprio domain ao host Intercom).
    • Certifique-se de que está usando um registro CNAME, não um registro A.
    • O CNAME deve apontar para o domain regional Intercom correto (por exemplo, us.intercomhelpcenter.com para workspaces dos EUA).

  • Após fazer correções, aguarde a propagação do DNS, que pode levar de 1 a 72 horas dependendo do seu provedor.

  • Quando o DNS estiver configurado corretamente e propagado, volte às configurações do Help Center e tente ativar o HTTPS (configuração rápida) novamente.

  • Se o status continuar “Pending” após essas etapas e tempo suficiente tiver passado, verifique novamente suas configurações DNS para erros.

Como garantir segurança e estabilidade a longo prazo?

Uma vez que a configuração rápida do HTTPS esteja ativada e funcionando, problemas recorrentes são improváveis, a menos que as configurações sejam modificadas ou configuradas incorretamente. A Intercom fornece certificação SSL como parte dessa configuração para garantir confiabilidade.

Os links de artigos e páginas de coleção redirecionarão automaticamente para meu domain personalizado?

Após configurar seu domain personalizado, os links de artigos redirecionarão automaticamente, mas os links das páginas de coleção ainda podem carregar sob o domain padrão da Intercom se acessados diretamente. Para empresas que priorizam SEO, certifique-se de que as coleções estejam atualizadas para funcionar com o domain personalizado.

Cenários após reativação ou suspensão de pagamento

Se o problema surgir após reativar seu Help Center ou resolver suspensões de pagamento:

  • Verifique as configurações do seu domain personalizado dentro do Intercom e certifique-se de que todos os campos estejam atualizados corretamente.

  • Remova o domain personalizado durante a solução de problemas, se necessário, e volte temporariamente ao domain padrão da Intercom.


Ainda está enfrentando problemas?

Se tudo acima parecer correto e você ainda estiver enfrentando problemas, entre em contato com nossa equipe de Suporte via Messenger, e eles ficarão felizes em investigar isso para você!

Respondeu à sua pergunta?