Configuration du Domaine et de la Marque en marque blanche

Configuration marque blanche

Trois éléments transforment votre organisation en une plateforme entièrement personnalisée : un domaine personnalisé, votre Marque et votre propre serveur SMTP. Le domaine et le SMTP sont requis pour une configuration en production ; la marque peut être affinée à tout moment.

1. Domaine personnalisé

Vos clients se connectent sur votre propre domaine (par exemple chat.your-agency.com). L'assistant de configuration sous Compte → Configuration marque blanche vous guide pas à pas :

Saisissez votre domaine, un sous-domaine comme chat.your-agency.com est recommandé.
Créez un enregistrement DNS chez votre fournisseur DNS :
Type Nom Valeur TTL
CNAME chat.your-agency.com connect.webchatagent.com 300
Cliquez sur Vérifier le DNS maintenant. Une fois l'enregistrement propagé (généralement quelques minutes, jusqu'à 24 h selon votre fournisseur), le domaine passe à l'état Vérifié.

Type	Nom	Valeur	TTL
CNAME	`chat.your-agency.com`	`connect.webchatagent.com`	300

Le certificat TLS pour votre domaine est émis automatiquement lors de la première visite, aucun import de certificat n'est nécessaire.

Le domaine doit pointer directement vers connect.webchatagent.com (DNS uniquement). Si vous utilisez Cloudflare pour votre propre zone, définissez l'enregistrement sur "DNS uniquement" (nuage gris), et non proxifié.

Une fois vérifié, le domaine apparaît dans Paramètres → Compte avec un badge vert et votre plateforme est accessible à l'adresse https://chat.your-agency.com.

2. Marque

Sous Paramètres → Compte → Marque, vous contrôlez l'apparence de la plateforme pour vos clients :

Champ	Utilisé dans
Nom de la plateforme	Titre du navigateur, en-tête du tableau de bord, tous les e-mails
URL du logo	Barre latérale du tableau de bord, page de connexion, en-tête des e-mails
URL du favicon	Onglet du navigateur
Couleur primaire	Boutons, liens, accents dans tout le tableau de bord
Texte Powered-by et URL	Ligne d'attribution facultative dans le widget de chat
Texte du pied de page e-mail	Pied de page de chaque e-mail envoyé à vos clients
Mentions légales et URL de confidentialité	Liens juridiques dans les e-mails, pointez-les vers des pages de votre propre site web

Les modifications s'appliquent à l'ensemble de la plateforme après enregistrement.

3. SMTP (votre propre serveur de messagerie)

Tous les e-mails destinés à vos clients, qu'il s'agisse d'invitations, de réinitialisations de mot de passe ou de notifications, sont envoyés via votre serveur SMTP avec votre adresse d'expéditeur. Cette étape est obligatoire : sans configuration SMTP fonctionnelle, aucun e-mail n'est envoyé pour votre organisation (la plateforme ne bascule jamais sur son propre expéditeur, car cela révélerait l'identité de la plateforme et briserait SPF/DKIM).

Configurez-le sous Paramètres → Compte → E-mail / SMTP :

Champ	Exemple
Hôte SMTP	`smtp.your-domain.com`
Port	`587` (par défaut)
TLS/SSL	selon votre serveur
Nom d'utilisateur / mot de passe	vos identifiants SMTP
Nom de l'expéditeur	`Votre Marque`
Adresse de l'expéditeur	`noreply@your-domain.com`

Utilisez Envoyer un e-mail de test pour vérifier la configuration avant d'inviter des clients.

Assurez-vous que les enregistrements SPF/DKIM de votre domaine d'envoi incluent votre fournisseur SMTP, sinon vos invitations risquent d'arriver dans les courriers indésirables.

4. Intégration du widget sous votre marque

Le script du widget servi depuis votre domaine utilise des balises d'éléments neutres, fournissez à vos clients finaux des extraits avec <chat-widget> (flottant) ou <chat-agent-inline> (intégré), chargés depuis votre domaine en marque blanche :

<script src="https://chat.your-agency.com/widget/chat-widget.js" async></script>
<chat-widget chatbot-id="THEIR_CHATBOT_ID"></chat-widget>

Il en va de même pour les données de contexte de session : en plus de l'attribut neutre context-data, le widget accepte les noms JavaScript neutres window.chatWidgetContext (variable globale, pouvant être définie avant le chargement du script) et l'événement chat-widget:context. Pour le consentement aux cookies, l'événement neutre chat-widget:consent fonctionne en parallèle de celui avec la marque. Documentez ces noms neutres pour vos clients finaux, leurs pages n'ont ainsi jamais besoin de faire référence à la plateforme.