Dans cet article, vous apprendrez à créer une configuration de chat dans le Backoffice, à parcourir les sections du dialogue de configuration, à l'enregistrer comme brouillon ou à la publier directement, et à la déployer dans vos studios.
Sommaire
- Conditions préalables
- Vue d'ensemble des configurations
- Créer une nouvelle configuration
- Enregistrer la configuration
- Vue détaillée et statut
- Configuration du libre-service client
- Activer et autoriser (whitelist)
- Intégrer le widget de chat
- Données de tiers et licences
Conditions préalables
- Permission : Configurer les paramètres du chat MagicAI, disponible sous Paramètres / Permissions dans la sous-catégorie Intelligence artificielle . Une permission distincte, Conversations par chat MagicAI, contrôle la visibilité de la boîte de réception côté agent et se trouve dans la sous-catégorie Communication .
- Licence : MagicAI Chat ne fait pas partie des forfaits tarifaires habituels ; il est proposé sous son propre modèle de licence. Contactez votre responsable de compte Sport Alliance pour l'activer pour un studio.
- Images d'avatar : un avatar principal du chatbot pour le widget de chat ouvert et un avatar d'appel à l'action pour le bouton de chat flottant, chacun jusqu'à 3 Mo.
- Au moins une source de connaissances : fichier (max. 10 Mo), URL ou Zendesk Help Center.
- Pour un transfert humain via Zendesk : sous-domaine Zendesk, nom d'utilisateur de l'agent et jeton d'API.
- Pour les offres de contrat : un canal d'offres maintenu (Sales tool, Studio pages and Connect API, MySports ou Open API).
- Studio de facturation par défaut valide : le studio de facturation par défaut de la configuration doit être un studio où le chatbot est disponible contractuellement et qui fait partie des studios autorisés de la configuration. Si l'une de ces conditions n'est pas remplie, la configuration ne peut pas être enregistrée.
Vue d'ensemble des configurations
Ouvrez le point d'entrée de la configuration sous Paramètres / MagicAI / Chat. La barre latérale affiche la nouvelle section MagicAI avec une entrée Chat et porte un badge Nouveau au lancement.
La page de vue d'ensemble répertorie toutes les configurations de chat de votre site.
Colonnes de la liste :
- Nom: l'identifiant interne, visible uniquement par les utilisateurs du Backoffice. Une puce Brouillon apparaît à côté du nom tant que la configuration est encore en cours de création.
- Nom de marque: le nom de marque de votre studio. Pas visible par les membres en soi, mais utile pour distinguer les configurations entre les marques.
- Nom du chatbot: le nom public que les membres voient dans le widget de chat.
- Dernière mise à jour: l'horodatage de la dernière modification de la configuration.
- Publié pour: un badge avec le nombre de studios dans lesquels la configuration est actuellement active. Une puce Actif apparaît ici une fois que la configuration est activée dans au moins un studio.
- Lieux: un badge avec le nombre de studios pour lesquels la configuration est autorisée ; survolez ou cliquez pour voir la liste des studios.
Depuis la liste, vous pouvez filtrer par statut, rechercher par nom ou nom de marque, trier et afficher ou masquer des colonnes. Utilisez le sélecteur de site en haut à droite pour voir les configurations d'autres sites. Lancez le dialogue de configuration avec Créer une configuration de chat en haut à droite.
L'activation et la désactivation s'effectuent toujours depuis cette page de vue d'ensemble. La vue détaillée ne gère que le contenu et l'autorisation (whitelist). Consultez Activer et autoriser (whitelist) pour connaître toutes les règles d'activation.
Créer une nouvelle configuration
Créer une configuration de chat ouvre un dialogue unique qui vous guide à travers cinq sections, chacune se terminant par un bouton Suivant . L'en-tête du dialogue propose une action Enregistrer le brouillon que vous pouvez utiliser à tout moment pour conserver votre travail en cours. Aucun numéro d'étape n'est affiché ; le titre de la section et la progression dans le dialogue indiquent où vous en êtes.
Informations de base
La première section recueille les données de base de la configuration.
Noms
- Nom: nom interne de la configuration (max. 30 caractères). Visible uniquement par les utilisateurs du Backoffice.
- Nom de marque: votre nom de marque (max. 30 caractères). Affiché dans la vue d'ensemble du Backoffice.
- Nom du chatbot: le nom que les membres voient dans le widget de chat (max. 30 caractères).
Message de bienvenue
- Message de bienvenue: le message d'accueil affiché lorsqu'un membre ouvre le chat (max. 400 caractères).
Studio de facturation
- Studio de facturation par défaut: le studio de repli utilisé pour les conversations de chat qui ne peuvent pas encore être attribuées à un studio précis (par exemple, un prospect non authentifié). Le studio doit figurer sur la liste d'autorisation de la configuration et être un studio où le chatbot est disponible contractuellement ; sinon, la configuration ne peut pas être enregistrée.
Consentement légal
Si vous remplissez les deux champs, l'aperçu affiche un dialogue de consentement avec les actions Refuser et Accepter que les membres voient avant leur premier message. Les deux champs sont facultatifs : si vous les laissez vides, aucun dialogue de consentement n'est affiché.
- Titre de consentement légal: titre du dialogue de consentement (max. 30 caractères).
- Description du consentement légal: le texte du corps expliquant ce à quoi le membre consent, avec des options de texte enrichi (gras, italique, souligné, couleur du texte, lien).
Texte de consentement suggéré
Le texte suivant a été fourni par le service juridique (Bjoern Baltbardis) comme brouillon de travail pour le dialogue de consentement. Adaptez les liens de substitution à votre propre politique de confidentialité et à vos conditions d'utilisation avant la mise en ligne.
- Titre : Avis sur le traitement des données
- Description : Votre saisie, y compris les données personnelles, est traitée automatiquement pour répondre à votre demande. Vous pouvez retirer ce consentement à tout moment avec effet pour l'avenir. Veuillez ne pas saisir de données de santé ni d'autres informations sensibles. Vous trouverez plus d'informations sur le traitement des données et sur vos droits dans notre [politique de confidentialité] et nos [conditions d'utilisation].
Apparence
Personnalisez l'apparence visuelle du widget de chat pour qu'elle corresponde à votre marque. Vous configurez trois couleurs de base plus une forme de bulle ; toutes les autres couleurs de l'interface (texte, bordures, états d'erreur) sont dérivées automatiquement.
Couleurs et aspect
-
Primaire: couleur d'accent principale sous forme de valeur hexadécimale, utilisée pour les éléments d'interface principaux tels que les boutons et les surbrillances, p. ex.
#166cb8. -
Arrière-plan du chat: couleur de la surface du widget de chat sous forme de valeur hexadécimale, p. ex.
#6d2929. - Couleur du dégradé de l'en-tête: deuxième couleur facultative utilisée pour le dégradé de l'en-tête. Si elle est vide, l'en-tête utilise la couleur primaire. Valeur hexadécimale.
- Utiliser des formes arrondies pour les bulles de dialogue: interrupteur oui/non.
Avatar
Deux emplacements d'avatar sont pris en charge. Une seule image est autorisée par emplacement.
- Avatar de chatbot ouvert: le logo principal affiché dans l'en-tête du widget de chat (max. 3 Mo).
- Avatar de chatbot fermé: le logo ou l'icône affiché sur le bouton de chat flottant qui ouvre le widget (max. 3 Mo).
Fonctionnalités
Activez les fonctionnalités que le bot doit gérer. Chaque fonctionnalité débloque une fonctionnalité spécifique pour les utilisateurs finaux. Après l'enregistrement, vous pouvez affiner chaque flux de travail sur sa carte dans la vue détaillée.
| Fonctionnalité | Ce qu'elle fait |
|---|---|
| Informations sur le studio | Le chatbot peut répondre aux questions sur les détails du studio (horaires, adresse, équipements). |
| Réservation d'une séance d'essai | Les utilisateurs finaux peuvent réserver une séance d'essai ou d'entraînement via le chatbot. |
| Calendrier des cours | Le chatbot peut afficher les cours disponibles dans un studio précis sur une plage de dates choisie. |
| Annulation du contrat | Les membres peuvent demander l'annulation d'un contrat via le chatbot. |
| Transfert humain | Lorsque le chatbot ne peut pas résoudre une demande, il crée une demande d'assistance et la transmet à un agent humain. Nécessite une configuration supplémentaire de Transfert humain (voir ci-dessous). |
| Libre-service pour les clients | Les membres peuvent consulter et modifier les données de leur compte (données principales, adresse, coordonnées, périodes de report, données du contrat) via le chatbot. Nécessite une configuration supplémentaire de libre-service (voir Configuration du libre-service client). |
| Offres de contrat | Le chatbot peut présenter et recommander des offres de contrat aux prospects. Nécessite de sélectionner un type de groupe de tarifs. |
Configurer le Transfert humain
Si vous activez Transfert humain, choisissez le Type. de transfert. Une seule configuration de Transfert humain est autorisée par chatbot.
Type Email
- Email: adresse de destination pour les conversations transférées. Doit être une adresse e-mail valide.
Type Zendesk
- URL: URL de votre instance Zendesk.
- Nom d'utilisateur: le nom d'utilisateur de l'agent utilisé pour créer les tickets.
- Jeton: jeton d'API pour l'authentification.
Configurer les offres de contrat
Si vous activez Offres de contrat, vous devez également sélectionner le Type de groupe de tarifs à partir duquel les offres sont extraites. Sans sélection, la configuration ne peut pas être enregistrée. Les quatre options correspondent aux valeurs de RateBundleGroupTypeEnum :
- Sales tool: offres du groupe de tarifs Sales tool.
- Studio pages and Connect API: offres du groupe de tarifs Studio pages and Connect API.
- MySports: offres du groupe de tarifs MySports.
- Open API: offres du groupe de tarifs Open API.
Votre sélection détermine d'où le bot extrait les offres et où l'inscription a lieu.
Sources de connaissances
Au moins une source de connaissances est requise. Utilisez + Ajouter une source de connaissances pour en ajouter d'autres. Pour chaque source, vous choisissez le Type de source: File, URL ou Zendesk.
Ajouter une source n'est que la moitié du travail. La façon dont vous structurez le contenu de vos sources influe directement sur la qualité des réponses, et certains sujets devraient être omis entièrement parce que le logiciel les fournit déjà. Pour savoir quoi inclure, quoi laisser de côté et comment mettre en forme votre contenu, consultez Constituer la base de connaissances pour MagicAI Chat.
Type File
Téléchargez directement un fichier texte ou PDF (max. 10 Mo par fichier). Pour plusieurs fichiers, créez plusieurs sources.
Type URL
Saisissez l'URL de départ d'une page web. Le système explore jusqu'à 5 niveaux de profondeur et suit un maximum de 50 liens à partir de l'URL de départ. Les deux limites sont fixes et ne peuvent pas être modifiées.
Type Zendesk
Saisissez l'URL de base de votre Zendesk Help Center, par exemple https://yourstudio.zendesk.com. Les articles sont récupérés dans toutes les langues disponibles dans votre Zendesk Help Center, selon la configuration par tenant.
Mettre à jour les sources d'information
Lorsque vous enregistrez une nouvelle source d'information, elle est automatiquement publiée et indexée afin que le bot puisse l'utiliser.
Si le contenu derrière une source d'information existante change (par exemple, votre site web a été mis à jour ou vous avez téléchargé un nouveau fichier), déclenchez une mise à jour immédiate avec le bouton Mettre à jour les sources de connaissances en bas de la carte des sources d'information sur la page détaillée. Cela réindexe toutes les sources immédiatement, de sorte que les modifications apparaissent aussitôt dans les réponses du bot. Si vous n'exécutez pas de mise à jour manuelle, toutes les sources d'information sont automatiquement réindexées chaque nuit.
Contenu et format recommandés
La capacité du chatbot à bien répondre dépend beaucoup plus de la structure et du langage de vos sources que du type de source. Suivez les recommandations suivantes lorsque vous préparez le contenu.
- Formats préférés : Markdown ou texte brut. Les deux sont clairement structurés et se découpent proprement en blocs. Les PDF fonctionnent tant que le texte est extractible ; évitez les PDF numérisés, les fichiers composés uniquement d'images et les feuilles Excel.
- Utilisez une structure de FAQ : le titre est la question, le corps est une réponse autonome. Chaque section doit avoir du sens en elle-même ; une certaine répétition entre les sections est acceptable si elle permet à chaque bloc de rester autosuffisant.
- Terminologie cohérente : utilisez les mêmes mots pour le même concept partout. Évitez le langage marketing, les affirmations contradictoires entre les sources et le contenu obsolète.
Enregistrer la configuration
Le dialogue propose deux façons de quitter le flux de création :
- Enregistrer le brouillon (action dans l'en-tête du dialogue) : conserve la configuration à l'état Brouillon . Dans ce mode, les champs obligatoires peuvent être vides. Utilisez-le pour conserver des configurations en cours sans les rendre activables.
- Suivant (le bouton principal en bas de chaque section) : fait avancer à travers les sections. Sur la dernière section, il devient l'action de soumission et enregistre la configuration à l'état Publié . Les champs obligatoires doivent être complets ; sinon, le dialogue bloque la soumission. Publié signifie seulement que la configuration est enregistrée et complète ; cela ne rend pas encore le chat actif pour les membres. L'activation dans les studios est une étape distincte (voir Activer et autoriser (whitelist)).
Dans les deux cas, vous arrivez sur la page détaillée, où chaque section apparaît sous forme de carte et peut être modifiée individuellement.
Vue détaillée et statut
La page détaillée comporte deux onglets :
- Paramètres: cartes pour Informations de base, Consentement légal, Apparence (avec les sous-cartes Couleurs et aspect et Avatar), Fonctionnalités, Sources de connaissances et Extrait de code.
- Self-service: cartes pour Données personnelles du membre et Données du contrat. Consultez Configuration du libre-service client.
La page détaillée présente le statut actuel à deux endroits.
Puce de statut à côté du titre de la configuration :
- Brouillon: la configuration est encore en cours de création et ne peut pas être activée.
- Actif: publiée et activée dans au moins un studio.
- Inactif: publiée mais actuellement activée nulle part.
Bannière d'alerte en haut de la page :
- Les brouillons affichent : Cette configuration n'est pas encore complète et se trouve actuellement à l'état de "brouillon". Pour l'activer, vous devez d'abord remplir tous les champs obligatoires.
- Les configurations publiées affichent une bannière de confirmation (gravité informative).
L'action Modifier les paramètres dans l'en-tête de la page détaillée n'est disponible que lorsque la configuration est à l'état Publié .
Configuration du libre-service client
Lorsque vous activez Libre-service pour les clients dans la section Fonctionnalités, l'onglet Self-service de la page détaillée devient l'endroit pour contrôler quelles zones du compte les membres peuvent consulter et modifier via le chat. L'onglet contient deux cartes.
Données personnelles du membre
- Données principales: si les membres peuvent consulter ou modifier leurs données principales.
- Adresse: accès aux informations d'adresse.
- Coordonnées: accès au téléphone, à l'e-mail et aux coordonnées similaires.
Données du contrat
- Données du contrat: quels contrats sont visibles (Tous les contrats ou Contrats actifs).
- Résiliation du contrat principal: si les membres peuvent résilier leur contrat principal via le chat.
- Proposer une période de report avant la résiliation: si le chat propose de manière proactive une période de report lorsqu'un membre tente de résilier.
- Périodes de report: si les membres peuvent demander une période de report.
Chaque champ modifiable affiche son statut actuel (par exemple, Activé) et un lien Vérifier les modifications qui ouvre les paramètres de vérification du champ.
Activer et autoriser (whitelist)
Deux concepts distincts contrôlent où une configuration est disponible et où elle est activée :
- Autorisation (whitelist) : les studios qui ont accès à une configuration. Défini dans la vue détaillée de la configuration.
- Activation : les studios où cette configuration est celle qui est active. Défini depuis la vue d'ensemble des configurations. Le chat ne devient visible pour les membres qu'une fois le code d'intégration également présent sur le site web du studio (voir Intégrer le widget de chat).
Pour activer une configuration :
- Ouvrez la vue d'ensemble sous Paramètres / MagicAI / Chat.
- Sélectionnez la configuration que vous souhaitez activer.
- Choisissez les studios dans lesquels elle doit s'exécuter.
Règles importantes :
- Une seule seule configuration peut être active par studio. L'activation d'une configuration dans un studio désactive automatiquement toute configuration qui y était active auparavant.
- Si vous activez une configuration dans un studio qui n'est pas encore autorisé, le studio est ajouté automatiquement à la liste d'autorisation.
- Vous ne pouvez pas activer une configuration qui est encore à l'état de brouillon. Enregistrez-la d'abord comme une configuration complète et publiée ; sinon, l'activation échoue avec Impossible d'activer un projet de configuration.
- Vous ne pouvez pas supprimer une configuration tant qu'elle est active dans un studio. Désactivez-la partout d'abord.
Intégrer le widget de chat
La page détaillée contient une carte Extrait de code avec le code d'intégration pour le site web de votre studio. Copiez l'extrait et collez-le dans le code source de votre site web pour afficher le widget de chat.
La carte se comporte différemment selon le statut de la configuration :
- Brouillon: la carte affiche le message La configuration actuelle est actuellement en mode brouillon. Pour obtenir un extrait de code, veuillez compléter la configuration du chatbot. L'action de copie est désactivée.
- Publié: l'extrait est affiché avec une action Copier qui place le code dans le presse-papiers.
Données de tiers et licences
Pour les données de localisation des studios, nous utilisons des données géographiques de GeoNames.org, sous licence CC BY 4.0. La licence nous oblige à divulguer cette utilisation de manière transparente ; veuillez laisser cette mention en place lorsque vous réutilisez l'article.