Utiliser votre propre domaine pour votre agent

Avec les offres Pro et Enterprise, chaque agent peut avoir un domaine personnalisé : l'un de vos propres sous-domaines, comme chat.yourcompany.com ou help.yourcompany.com. Une fois connecté, votre domaine affiche la page d'aide de l'agent, son lien direct vers le chat et son script de widget, avec le HTTPS configuré automatiquement.

Ce que votre domaine affiche

Avec chat.yourcompany.com connecté :

Pour installer la bulle depuis votre domaine, utilisez cette balise script à la place de celle d'intoCHAT :

<script src="https://chat.yourcompany.com/embed.js" data-chatbot-id="YOUR_AGENT_ID"></script>

La fenêtre de chat fonctionne alors aussi sur votre domaine : la session du visiteur est donc enregistrée sous votre domaine plutôt que sous celui d'intoCHAT.

Seul cet agent existe sur le domaine. Toute autre adresse sur ce domaine, et tout autre agent, affiche « Not found ». Les adresses intoCHAT de l'agent continuent de fonctionner comme avant.

Connecter un domaine

1. Ouvrez votre agent et allez dans l'onglet Share. La carte Custom domain se trouve sous la carte de la page d'aide.
2. Saisissez le sous-domaine, par exemple chat.yourcompany.com, et cliquez sur Add domain.
3. La carte affiche les enregistrements DNS à ajouter. Chez votre fournisseur DNS (là où vous gérez les enregistrements de votre domaine), ajoutez :
   • un enregistrement CNAME avec le nom chat.yourcompany.com (certains fournisseurs ne demandent que chat) et la valeur affichée sur la carte, en général cname.vercel-dns.com ;
   • un enregistrement TXT, uniquement si la carte en affiche un. Il apparaît quand le domaine est déjà utilisé sur un autre compte de notre hébergeur, Vercel, et prouve que le domaine vous appartient.
4. Cliquez sur Check now. Les modifications DNS peuvent mettre de quelques minutes à quelques heures à se propager. intoCHAT vérifie aussi les domaines en attente une fois par jour.

Quand le statut indique Live, le domaine affiche votre agent.

Statut

• Waiting for DNS : les enregistrements ne sont pas encore en place, ou ne se sont pas encore propagés.
• Live : le domaine affiche l'agent.
• DNS changed : le domaine fonctionnait, mais son enregistrement CNAME ne pointe plus vers intoCHAT. Rétablissez l'enregistrement.
• Needs attention : le domaine ne peut pas être utilisé en l'état. Retirez-le et ajoutez-le de nouveau ; si cela ne suffit pas, contactez le support.

Bon à savoir

• Utilisez un sous-domaine. Les domaines racines comme yourcompany.com ne peuvent pas avoir l'enregistrement CNAME nécessaire : ils ne sont donc pas encore pris en charge.
• Un seul domaine personnalisé par agent. Pour le changer, retirez d'abord le domaine actuel.
• Un domaine déjà connecté à un autre projet ou compte Vercel ne peut pas être ajouté tant qu'il n'y a pas été retiré.
• Les admins et le propriétaire du compte ajoutent et retirent le domaine. Les editors peuvent cliquer sur Check now. Les viewers voient le statut.
• Remove retire le domaine en moins d'une minute. Les scripts de widget et les liens qui l'utilisent cessent de fonctionner ; supprimez ensuite les enregistrements DNS.
• Supprimer l'agent supprime aussi son domaine personnalisé.
• Si votre offre ne comprend plus de domaine personnalisé, par exemple après un passage à une offre inférieure, le domaine affiche « Not found » jusqu'à ce que vous repassiez à une offre supérieure. Le réglage est conservé.
• Le chat d'un agent privé ne fonctionne pas non plus sur le domaine, et sa page d'aide reste désactivée.
• Les domaines autorisés fonctionnent comme avant : ils déterminent quels sites peuvent afficher le chat dans un cadre ou utiliser le widget, quel que soit le domaine d'où vient le script.
• Si votre site envoie une Content Security Policy, autorisez votre domaine personnalisé à la place de https://www.intochat.ai quand vous chargez le script depuis celui-ci.
• Quand la page d'aide est servie sur votre domaine, les moteurs de recherche reçoivent votre domaine comme adresse de la page.

Voir Offres et limites pour ce que comprend chaque offre.