Vous pouvez changer l’URL de votre Help Center en configurant un domain personnalisé.
Configurer un domain personnalisé pour votre Help Center ne cassera pas les liens existants vers intercom.help/exampleapp, mais vos articles seront redirigés vers votre nouveau domain personnalisé. Par exemple, ouvrir intercom.help/exampleapp redirigera vers votre domain à la place.
Commencer
Pour ajouter votre domain personnalisé, allez dans Paramètres > Help Center > Configurer & style et ouvrez la section Général > Domains.
Après avoir spécifié votre domain, Intercom fournira une URL cible (par exemple, us.intercomhelpcenter.com ou eu.intercomhelpcenter.com ou au.intercomhelpcenter.com).
Ensuite, ajoutez un lien vers votre page de connexion dans la section Confidentialité.
Créer un enregistrement CNAME
Maintenant, allez chez votre fournisseur DNS (par exemple GoDaddy, Cloudflare, DNSimple ou Route53, etc.) et créez un enregistrement CNAME avec un hôte cible de custom.intercom.help. Nous avons créé ce guide pour vous aider ou aider votre ingénieur à le configurer.
Il est important de s’assurer que l’enregistrement CNAME se propage correctement, ce qui peut prendre jusqu’à 72 heures.
Important : Après avoir créé votre enregistrement CNAME, vous devez également configurer le protocole de sécurité dans Intercom pour correspondre à votre configuration DNS. Allez dans Paramètres > Help Center > Configurer & Style, ouvrez la section Domain et sélectionnez l’option correcte :
Sélectionnez HTTPS (Configuration rapide) si votre CNAME pointe vers us.intercomhelpcenter.com (ou l’équivalent EU/AU)
Sélectionnez HTTPS (Configuration manuelle) si votre CNAME pointe vers custom.intercom.help (ou l’équivalent EU/AU)
Sans cette sélection, le CNAME ne sera pas reconnu, votre domain personnalisé ne sera pas validé, et Cloudflare peut retourner l’erreur 1014.
Notes :
Les sous-domaines (par exemple help.exampleapp.io) et les sous-chemins (par exemple exampleapp.io/help) sont tous deux pris en charge.
Les modifications DNS peuvent prendre jusqu’à 72 heures pour être effectives, mais elles se produisent généralement beaucoup plus rapidement.
Chaque domain personnalisé ne peut prendre en charge qu’un seul sous-chemin.
En cas de problème, assurez-vous que les enregistrements DNS correspondent aux étapes de configuration fournies.
Voici un exemple de configuration utilisant Cloudfront, mais cela devrait également fonctionner avec tout autre CDN.
Tout d’abord, vous devez créer une nouvelle distribution dans Cloudfront en tant que « Web » et ajouter les détails suivants :
Paramètres d’origine
Origin Domain Name: custom.intercom.help
Origin Protocol Policy: HTTP Only
Default Cache Behavior Settings
Viewer Protocol Policy: Redirect HTTP to HTTPS
Allowed HTTP Methods: GET, HEAD, OPTIONS, POST
Forward Headers: All
Query String Forwarding and Caching: Forward all, cache based on all
Paramètres de distribution
Alternate Domain Names (CNAMEs): [Custom domain used in your Educate settings]
SSL Certificate: Your custom SSL Certificate
Custom SSL Client Support: Only Clients that Support Server Name Indication (SNI)
Après avoir créé cette distribution, vous l’ajouterez à Route53.
Voici les paramètres que vous pouvez utiliser :
Name: [Custom domain used in your Help Center settings]
Alias: Yes
Alias Target: [CloudFront Distribution you just created]
Un tutoriel est disponible ici dans notre documentation développeur.
Enfin, configurez le SSL (en utilisant un tiers ou en hébergeant vos propres certificats SSL). Intercom automatise les demandes de certificats SSL lorsque HTTPS est activé, complétant généralement rapidement le processus. Vérifiez également le SSL via les contrôles du navigateur pour valider sa bonne configuration après la finalisation.