Passar para o conteúdo principal

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

Encontrando problemas ao 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é Configurações > Help Center > Configurar & Estilo

  • Na seção "Domain", localize a configuração "Protocolo de segurança"

  • Defina o "Protocolo de segurança" 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 quando estiver usando 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) - neste caso, executar uma verificação CNAME normalmente não retornaria 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 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 "Flexível" ou "Completo".

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

Certifique-se de que seu Help Center está ativo

Vá para Configurações > Help Center e certifique-se de que seu Help Center está Ativo.

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

Este 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 se propagado completamente 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. Quaisquer certificados conflitantes ou adicionais configurados no seu provedor de domain causarão erros e devem ser removidos.

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

Este 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 suítes de cifra suportados.

Resolvendo problemas de sobreposição de cifra

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 este 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

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

Resolvendo problemas de SSL no Link Branding

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

Nota: Isso é separado do certificado SSL que o Intercom fornece para o domínio principal do seu Help Center.

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

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

Certifique-se de que você tenha pelo menos um artigo publicado

Se você está vendo Not found ao tentar acessar seu Help Center, certifique-se de que tenha 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 um Erro 1014 ao visitar seu domínio personalizado do Help Center, isso provavelmente se deve 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 domínio personalizado aponte para custom.intercom.help ou us.intercomhelpcenter.com (dependendo do seu método de configuração HTTPS)

  • Permita 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.

Notas:

  • O proxy do Cloudflare ativado causa falha no handshake SSL para link branding porque o Intercom apresenta apenas certificados *.intercom-mail.com.

  • A correção requer uma Regra de Origem do Cloudflare (somente para Enterprise).

  • Clientes não Enterprise devem usar o modo DNS-only.

Uma causa comum, mas fácil de perder, do Erro 1014 é não selecionar o protocolo de segurança correto nas configurações do seu Intercom Help Center após criar o registro CNAME. Mesmo que seu DNS esteja configurado corretamente, o domínio personalizado não será validado até que essa etapa seja concluída. Para resolver esse problema, vá para Configurações > Help Center > Configurar & Estilo, abra a seção Domain e selecione a opção que corresponde à sua configuração de DNS: HTTPS (Configuração Rápida) se seu CNAME apontar para us.intercomhelpcenter.com, ou HTTPS (Configuração Manual) 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 domínio. O Zone Hold valida que os nomes de host resolvam para endereços IP associados à mesma conta Cloudflare, o que impedirá que a Configuração Rápida HTTPS funcione e retornará um erro 1014 Cross-User Banned. Para desativá-lo, vá para as configurações da sua conta Cloudflare e desligue o Zone Hold para o domínio 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 domínio regional correto

  • Se estiver usando Cloudflare, certifique-se de que o modo SSL esteja definido 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 para solução de problemas.

Usando Amazon CloudFront?

Certifique-se de seguir todas as etapas no guia.

Usando Proxy Reverso Personalizado?

  • Certifique-se de que os guias sejam seguidos.

  • Exemplo de consulta CNAME para uma configuração de proxy reverso: não encontrará nada, mas saberá 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 você encontrar essa mensagem nos seus logs, 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 “Pendente” por um longo período?

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

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

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

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

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

Como garantir segurança e estabilidade a longo prazo?

Depois que a configuração rápida do HTTPS estiver habilitada e funcionando, problemas recorrentes são improváveis, a menos que as configurações sejam modificadas ou configuradas incorretamente. O 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 domínio personalizado?

Após configurar seu domínio personalizado, os links dos artigos redirecionarão automaticamente, mas os links das páginas de coleção ainda podem carregar sob o domínio padrão do Intercom se acessados diretamente. Para empresas que priorizam SEO, certifique-se de que as coleções estejam devidamente atualizadas para funcionar com o domínio 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 domínio personalizado dentro do Intercom e certifique-se de que todos os campos estejam atualizados corretamente.

  • Remova o domínio personalizado durante a solução de problemas, se necessário, e volte temporariamente ao domínio padrão do Intercom.


Ainda está enfrentando problemas?

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

Respondeu à sua pergunta?