Configurer MagicAI Chat

Dans cet article, vous apprendrez à créer une configuration de chat, à la paramétrer dans les cinq onglets de sa page de détail, à l'activer dans vos studios et à intégrer le chat sur votre site web.

Sommaire

• Conditions préalables
• Vue d'ensemble des configurations
• Créer une nouvelle configuration
• Enregistrer la configuration
• Vue détaillée et statut
• Onglet Paramètres
• Configuration du libre-service client
• Onglet Sources d'information
• Onglet Directives
• Onglet Informations sur le studio
• Fast Finance Link
• Activer et autoriser
• Intégrer le widget de chat
• Où les membres trouvent le chat
• Conversations par chat
• Données de tiers et licences
• Articles associés

---

Conditions préalables

• Permission : Paramètres / Intelligence artificielle / Configurer les paramètres du chatbot. Pour lire les conversations du chat, vous avez également besoin de Communication / Intelligence artificielle / MagicAI conversations par chat. Vous attribuez ces deux permissions dans les paramètres des rôles.
• Licence : MagicAI Chat est une extension soumise à une licence distincte. Si elle n'est pas active pour votre studio, Paramètres / MagicAI / Chatbot ouvre une page d'information avec le bouton Démarrer maintenant au lieu de la configuration.
• 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 vers Zendesk : l'URL de votre instance Zendesk, un nom d'utilisateur d'agent et un jeton d'API.
• Pour un transfert vers HubSpot : un jeton d'accès HubSpot, l'ID du pipeline et l'ID de l'étape du pipeline.
• Pour les offres de contrat : un canal d'offres tenu à jour (Outil d'aide à la vente, Connect API, Contrats MySports en ligne ou Open API).
• Studio de facturation par défaut éligible : le studio de facturation par défaut de la configuration doit être un studio dans lequel le chatbot est disponible contractuellement et avec lequel la configuration est partagée. Si l'une de ces conditions n'est pas remplie, la configuration ne peut pas être enregistrée.

Vue d'ensemble des configurations

Ouvrez la configuration sous Paramètres / MagicAI / Chatbot. La page de vue d'ensemble répertorie toutes les configurations de chat de votre site.

Colonnes de la liste :

• Nom : le nom interne de la configuration, visible uniquement par les utilisateurs du Backoffice. Une puce de statut à côté du nom indique l'état dans le studio actuel, par exemple Activé dans ce studio ou Brouillon.
• Nom de marque : le nom de marque de votre studio. Utile pour distinguer les configurations entre plusieurs marques.
• Nom du chatbot : le nom public que les membres voient dans le widget de chat.
• Dernière mise à jour : la date de la dernière modification de la configuration.
• Activé(e) pour : le nombre de studios dans lesquels la configuration est actuellement active.
• Sites : le nombre de studios avec lesquels la configuration est partagée.

Vous pouvez filtrer et trier la liste, et afficher ou masquer des colonnes. Le sélecteur de site en haut à droite vous permet de voir les configurations d'autres sites. Pour créer une nouvelle configuration, utilisez Créer un chatbot.

L'activation et la désactivation se font toujours depuis cette page de vue d'ensemble. Les règles d'activation sont décrites sous Activer et autoriser.

Créer une nouvelle configuration

Créer un chatbot ouvre une boîte de dialogue en cinq étapes. Le pied de la boîte de dialogue propose Annuler, Sauvegarder le brouillon et Suivant.

1. Informations de base : noms, message d'accueil et studio de facturation par défaut.
2. Consentement légal : boîte de dialogue de consentement facultative.
3. Apparitions : couleurs et avatars.
4. Champ d'application : ce que le chatbot est autorisé à faire.
5. Sources d'information : au moins une source à partir de laquelle le chatbot répond.

L'étape 1, Informations de base, contient les champs suivants :

• Nom, Nom de marque et Nom du chatbot (max. 30 caractères chacun).
• Titre d'accueil (max. 100 caractères), Message et Informations Complémentaires.
• Studio de facturation par défaut.
• Modifier le partage des données : choisissez les studios avec lesquels la configuration est partagée.

Les champs de toutes les étapes sont les mêmes que ceux que vous modifiez ensuite sur la page de détail. Ils sont décrits dans les sections Onglet Paramètres et Onglet Sources d'information.

Enregistrer la configuration

La boîte de dialogue offre deux façons de quitter le processus de création :

• Sauvegarder le brouillon (bouton en pied de la boîte de dialogue) : enregistre la configuration à l'état Brouillon. Dans ce mode, les champs obligatoires peuvent rester vides. Un brouillon ne peut pas être activé.
• Suivant à la dernière étape : enregistre la configuration à l'état Publié. Tous les champs obligatoires doivent être remplis. Publié signifie uniquement que la configuration est enregistrée et complète ; le chat n'est pas encore disponible pour les membres. L'activation dans les studios est une étape distincte (voir Activer et autoriser).

Dans les deux cas, vous arrivez sur la page de détail de la configuration.

Vue détaillée et statut

L'en-tête de la page de détail affiche le nom de la configuration, le nombre de sites, la puce de statut, le Nom de marque et le Studio de facturation par défaut.

Puce de statut à côté du nom de la configuration :

• Brouillon : la configuration est encore incomplète et ne peut pas être activée.
• Actif : publiée et activée dans au moins un studio.
• Inactif : publiée, mais activée nulle part pour le moment.

Les brouillons affichent en outre la bannière « 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. »

Le menu de l'en-tête propose Modifier les paramètres une fois la configuration publiée ; un brouillon propose Modifier le projet à la place. Modifier les paramètres contient le Nom, le Nom de marque, le Studio de facturation par défaut et Modifier le partage des données, où vous choisissez les studios avec lesquels la configuration est partagée.

La page de détail comporte cinq onglets :

Onglet	Ce que vous y définissez
Paramètres	Informations de base, consentement légal, apparence, fonctionnalités et extrait de code.
Self-Service	Les données de compte que les membres peuvent consulter et modifier via le chat.
Sources d'information	Les fichiers, sites web et Help Centers à partir desquels le chatbot répond.
Directives	Les règles de comportement que le chatbot doit respecter.
Informations sur le studio	Des informations temporaires ou liées à une situation pour certains studios.

Onglet Paramètres

L'onglet Paramètres affiche une carte par domaine. Vous modifiez chaque carte via son menu : Modifier les informations de base, Modifier le consentement légal, Modifier les couleurs et l'apparence, Editer le logo, Modifier les capacités et Copier Extrait de code.

Informations de base

Les informations de base déterminent les noms et le contenu que les membres voient à l'ouverture du chat.

• Nom du chatbot : le nom que les membres voient dans le widget de chat (max. 30 caractères).
• Titre d'accueil (max. 100 caractères) et Message : le message d'accueil que les membres voient à l'ouverture du chat.
• Informations Complémentaires : texte complémentaire facultatif.
• Message d'annonce (max. 500 caractères) avec l'interrupteur Activer le teaser : un court texte d'accroche pour le widget de chat.
• Afficher les teasers sur les appareils mobiles : détermine si le teaser et les suggestions s'affichent également sur les appareils mobiles.
• Activer les suggestions d'actualités et Afficher les suggestions sur l'écran d'accueil : proposent aux membres des questions préparées. Chaque suggestion se compose d'un Texte du bouton et du Message associé (max. 500 caractères). Ajoutez d'autres suggestions avec Ajouter une suggestion.

Remarque : les membres doivent pouvoir reconnaître clairement qu'ils interagissent avec un système d'IA (comme l'exige le règlement européen sur l'IA, article 50). Formulez le message d'accueil en conséquence. Exemple : « Bonjour ! Je suis votre assistant numérique IA. Je réponds volontiers à vos questions sur votre abonnement, nos cours ou des informations générales sur le studio. Comment puis-je vous aider aujourd'hui ? »

Le Nom interne, le Nom de marque (max. 30 caractères chacun) et le Studio de facturation par défaut se modifient dans le menu de l'en-tête, sous Modifier les paramètres. Le studio de facturation par défaut est le studio de repli pour les conversations de chat qui ne peuvent pas encore être attribuées à un studio précis, par exemple avec un prospect non authentifié.

Consentement légal

Si vous remplissez les deux champs, les membres voient avant leur premier message une boîte de dialogue de consentement avec les actions Déclin (refuser) et Accepter. Les deux champs sont facultatifs : si vous les laissez vides, aucune boîte de dialogue de consentement ne s'affiche.

• Titre de consentement légal : titre de la boîte de dialogue de consentement (max. 30 caractères).
• Description de l'autorisation légale : le texte qui explique à 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 est une ébauche de travail pour la boîte de dialogue de consentement. Avant la mise en service, remplacez les liens génériques par votre propre politique de confidentialité et vos conditions d'utilisation.

• Titre : Information sur le traitement des données
• Description : Vos saisies, y compris vos données personnelles, sont traitées automatiquement afin de 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

Adaptez l'apparence du widget de chat à votre marque. Dans la boîte de dialogue de création, cette étape s'intitule Apparitions ; dans l'onglet Paramètres, vous la retrouvez dans les cartes Couleurs et aspect et Logos. Vous configurez trois couleurs de base et la forme des bulles ; toutes les autres couleurs du widget en sont dérivées automatiquement.

Couleurs et aspect

• Primaire : couleur d'accentuation principale en valeur hexadécimale, utilisée pour les boutons et les mises en évidence, par exemple #166cb8.
• Arrière-plan du chat : couleur de fond du widget de chat en valeur hexadécimale, par exemple #6d2929.
• Couleur du dégradé de l'en-tête : seconde couleur facultative pour le dégradé de l'en-tête. Si le champ est vide, l'en-tête utilise la couleur Primaire. Valeur hexadécimale. Sur la carte et dans la boîte de dialogue de modification de l'onglet Paramètres, ce champ s'affiche sous le nom Secondaire.
• Utiliser des formes arrondies pour les bulles de dialogue : interrupteur oui/non.

Logos

Deux emplacements d'avatar sont disponibles, avec une image par emplacement.

• Avatar de chatbot ouvert : l'image affichée dans l'en-tête du widget de chat (max. 3 Mo).
• Avatar de chatbot fermé : l'image affichée sur le bouton de chat flottant qui ouvre le widget (max. 3 Mo).

Champ d'application

Activez les fonctionnalités que le chatbot doit prendre en charge. Le chatbot n'effectue que les actions que vous avez activées ici.

Fonctionnalité	Ce qu'elle fait
Informations sur le studio	Le chatbot fournit des informations sur l'emplacement du studio, ses coordonnées et ses horaires d'ouverture. Pour les informations temporaires, utilisez l'Onglet Informations sur le studio.
Réservation d'une séance d'essai	Le chatbot réserve une séance d'essai en fonction des créneaux disponibles.
Annulation du contrat	Après une authentification suffisante, le membre peut demander la résiliation de son contrat via le chatbot.
Fast Finance Link	Le chatbot envoie aux membres un Fast Finance Link pour régler des créances en cours ou mettre à jour leurs informations de paiement. Nécessite un modèle de communication dans les paramètres du Fast Finance Link (voir Fast Finance Link).
Transfert humain	Le chatbot transfère la conversation à un collaborateur. Nécessite un Taper (type) de transfert (voir ci-dessous).
Libre-service pour les clients	Selon la configuration, les membres peuvent modifier leur adresse, demander des périodes de report ou obtenir des informations sur leur contrat. Se configure dans l'onglet Self-Service (voir Configuration du libre-service client).
Recherche de rendez-vous	Le chatbot recherche les rendez-vous disponibles et les présente aux membres. Nécessaire pour Réservation.
Réservation	Le chatbot prend en charge la réservation de rendez-vous. Ne fonctionne qu'avec Recherche de rendez-vous.
Inscription aux cours	Le chatbot inscrit les membres et les prospects à des cours.
Calendrier des cours	Le chatbot affiche les cours disponibles dans un studio précis sur la période choisie.
Offres de contrat	Le chatbot fournit des informations sur les offres de contrat configurées. Nécessite un Type de groupe de tarifs (voir ci-dessous).

Configurer le Transfert humain

Si vous activez Transfert humain, choisissez le Taper (type) : Zendesk, Email ou HubSpot. Une seule configuration de transfert est autorisée par chatbot.

• Zendesk : URL de votre instance Zendesk, Nom d'utilisateur de l'agent utilisé pour créer les tickets et Jeton pour l'authentification.
• Email : Email, l'adresse de destination des conversations transférées. Il doit s'agir d'une adresse e-mail valide.
• HubSpot : Jeton d'accès à HubSpot (saisi comme secret), ID du pipeline HubSpot et ID d'étape du pipeline HubSpot de l'étape du pipeline utilisée pour le transfert.

Configurer les offres de contrat

Si vous activez Offres de contrat, vous devez également sélectionner le Type de groupe de tarifs dont proviennent les offres. Sans sélection, la configuration ne peut pas être enregistrée. Les options sont Outil d'aide à la vente, Connect API, Contrats MySports en ligne et Open API. Votre choix détermine où le chatbot récupère les offres et où l'inscription a lieu.

Extrait de code

La carte Extrait de code contient le champ Sélectionner un club et le code d'intégration pour votre site web. Son utilisation est décrite sous Intégrer le widget de chat.

Configuration du libre-service client

Si vous activez Libre-service pour les clients sous Champ d'application, vous déterminez dans l'onglet Self-Service les données de compte que les membres peuvent consulter et modifier via le chat.

Données personnelles du membre

• Données principales
• Adresse
• Coordonnées

Données du contrat

• Données du contrat : les contrats que le chat affiche, par exemple Afficher uniquement les contrats actifs.
• Reports d'abonnement : si les membres peuvent demander une période de report.

Chaque ligne affiche son statut actuel, par exemple Activé, et la manière dont les modifications sont traitées, par exemple Vérifier les modifications. Vous modifiez les paramètres via le menu de la carte concernée.

La résiliation ne se configure pas dans cet onglet. Les membres ne peuvent demander une résiliation via le chat que si la fonctionnalité Annulation du contrat est activée dans l'onglet Paramètres.

Onglet Sources d'information

L'onglet Sources d'information répertorie toutes les sources avec les colonnes Source, Type et Mode « Crawl ». Au-dessus de la liste, vous voyez quand les sources ont été traitées pour la dernière fois (Dernière exécution du résumé).

La façon dont vous structurez le contenu de vos sources influence directement la qualité des réponses, et certains sujets doivent être laissés de côté parce que le logiciel les fournit déjà. Pour savoir quoi inclure et comment le mettre en forme, consultez Constituer la base de connaissances pour MagicAI Chat.

Ajouter une source

1. Cliquez sur Ajouter une source de connaissances.
2. Choisissez le Type de source : Dossier (fichier), URL ou Zendesk.
3. Remplissez les champs correspondant au type (voir ci-dessous) et cliquez sur Créer.

• Fichier : téléchargez un fichier par source, de 10 Mo maximum, au format PDF, TXT, DOCX ou MD. Pour plusieurs fichiers, créez plusieurs sources.
• URL : saisissez l'URL et choisissez le Mode « Crawl ». Explorer l'intégralité du site web part de cette URL et récupère automatiquement jusqu'à 50 sous-pages, sur une profondeur maximale de 5 niveaux. Afficher uniquement cette page traite uniquement cette URL exacte, sans sous-pages.
• Zendesk : saisissez l'URL de votre Zendesk Help Center, par exemple https://yourstudio.zendesk.com.

Mettre à jour les sources de connaissances

Si vous avez ajouté des sources ou si le contenu d'une source a changé, cliquez sur Mettre à jour les sources de connaissances dans l'en-tête de l'onglet afin que le chatbot travaille avec le contenu actuel. Si vous ne lancez pas de mise à jour manuelle, toutes les sources de connaissances sont réindexées automatiquement chaque nuit.

Onglet Directives

Les directives sont des règles de comportement que le chatbot doit respecter. L'onglet les répertorie avec les colonnes Sommaire (contenu) et Activé(e) pour.

1. Cliquez sur Créer Directives. La boîte de dialogue Créer une directive s'ouvre.
2. Sous Gérer l'activation, choisissez les studios auxquels la directive s'applique. Tous les studios s'applique à tous les studios activés actuellement ou à l'avenir pour cette configuration de chat.
3. Saisissez la règle sous Sommaire (max. 500 caractères) et cliquez sur Enregistrer.

Les modifications sont publiées immédiatement et peuvent influencer les réponses du chatbot.

Onglet Informations sur le studio

Les informations sur le studio sont destinées aux informations temporaires ou liées à une situation. Les données standard telles que l'adresse, les horaires d'ouverture et les équipements sont fournies automatiquement et n'ont pas besoin d'être saisies ici. L'onglet répertorie les entrées avec les colonnes Sommaire (contenu) et Activé(e) pour.

1. Cliquez sur Créer Informations sur le studio. La boîte de dialogue Ajouter des informations sur le studio s'ouvre.
2. Sous Gérer l'activation, attribuez l'information à un ou plusieurs studios.
3. Saisissez l'information sous Sommaire (max. 500 caractères) et cliquez sur Enregistrer.

Les modifications sont publiées immédiatement et peuvent influencer les réponses du chatbot.

Fast Finance Link

Si vous activez Fast Finance Link sous Champ d'application, le chatbot peut envoyer par e-mail un Fast Finance Link à un membre authentifié, après avoir vérifié son statut de paiement, afin qu'il puisse régler des créances en cours ou mettre à jour son moyen de paiement. L'e-mail est envoyé de la même manière qu'un envoi manuel depuis le compte du membre, avec le modèle de communication qui y est configuré.

• Condition préalable : un modèle de communication pour l'envoi manuel doit être configuré dans les paramètres du Fast Finance Link du studio. Sans modèle, le chatbot ne peut pas envoyer l'e-mail. Pour plus de détails, consultez Configurer le Fast-Finance Link.
• Le lien lui-même n'apparaît jamais dans la conversation du chat. Après l'envoi, le chatbot affiche uniquement au membre une confirmation masquée de l'adresse du destinataire (par exemple d***n@example.com).
• Les éléments (paiement, moyen de paiement) que contient l'e-mail dépendent de la configuration du Fast Finance Link du studio ; le chatbot ne fait pas sa propre sélection.
• Le chatbot ne promet jamais qu'une restriction d'accès sera levée immédiatement après le paiement. Il indique au membre que la restriction peut être levée en conséquence et lui recommande de contacter le studio si le problème persiste.

Activer et autoriser

Deux paramètres distincts déterminent où une configuration est disponible et où elle s'exécute :

• Partage : les studios qui ont accès à une configuration. Se définit sur la page de détail sous Modifier les paramètres / Modifier le partage des données.
• Activation : les studios dans lesquels cette configuration est la configuration active. Se définit depuis la vue d'ensemble avec Gérer l'activation.

Pour activer une configuration :

1. Ouvrez la vue d'ensemble sous Paramètres / MagicAI / Chatbot.
2. Ouvrez le menu de la ligne (trois points) de la configuration et choisissez Gérer l'activation. Le même menu contient aussi Supprimer Chatbot.
3. Dans la boîte de dialogue, sélectionnez dans le sélecteur de sites les studios dans lesquels la configuration doit s'exécuter.
4. Confirmez avec le bouton qui indique le nombre de studios sélectionnés, par exemple Activez 2.

Règles importantes :

• Une seule configuration peut être active par studio. L'activation d'une configuration dans un studio désactive automatiquement la configuration qui y était active auparavant.
• Si vous activez une configuration dans un studio avec lequel elle n'est pas encore partagée, le studio est ajouté automatiquement au partage.
• Un brouillon ne peut pas être activé. Complétez-le et publiez-le d'abord ; 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 d'abord partout.

Sur votre propre site web, le chat n'apparaît que lorsque le code d'intégration est également en place (voir Intégrer le widget de chat). Dans la Member Platform et dans Branded Web, aucun code d'intégration n'est nécessaire (voir Où les membres trouvent le chat).

Intégrer le widget de chat

La carte Extrait de code de l'onglet Paramètres contient le code d'intégration pour le site web de votre studio. Copiez-le avec Copier Extrait de code dans le menu de la carte et collez-le dans la section <head> de votre site web. L'extrait n'est nécessaire que pour votre propre site web.

Deux exigences techniques s'appliquent :

• La politique de sécurité du contenu (CSP) de votre site web doit autoriser les connexions vers magicline.com.
• Si le chat est intégré à une page propre à un studio, sélectionnez le studio dans le champ Sélectionner un club. L'extrait contient alors les paramètres studioId et studioName, afin que le chatbot sache à quel studio appartient la page.

Le comportement de la carte dépend du 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. » Aucun extrait ne peut être copié.
• Publié : l'extrait s'affiche et peut être copié.

Où les membres trouvent le chat

Les membres accèdent au chat à trois endroits. Sur votre propre site web, il apparaît dès que vous avez collé le code d'intégration. Dans la Member Platform et dans Branded Web, il apparaît de lui-même, sous forme de bouton de chat flottant, sans autre configuration.

Un membre voit le chat dans la Member Platform et dans Branded Web lorsque son propre studio dispose d'une configuration à la fois publiée et activée. C'est le studio du membre qui compte, et non le studio qu'il visite à ce moment-là ; dans une configuration multi-studios, vous décidez donc studio par studio si ses membres disposent du chat.

Il en découle deux conséquences :

• Un brouillon n'atteint les membres nulle part, ni sur votre site web ni dans la Member Platform.
• La désactivation d'une configuration dans un studio retire le chat pour les membres de ce studio également dans la Member Platform et dans Branded Web, et pas seulement sur votre site web.

Conversations par chat

Vous trouvez les conversations que les membres ont eues avec le chatbot sous Plus de / Communication / MagicAI / Conversations par chat. Cela nécessite la permission MagicAI conversations par chat (voir Conditions préalables).

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 impose de signaler cette utilisation de manière transparente ; veuillez conserver cette mention si vous réutilisez l'article.

Articles associés

• Directives et informations sur le studio pour MagicAI Chat
• Message d'annonce et suggestions de messages dans MagicAI Chat

---

Remarque : Cet article a été créé à l'aide de l'intelligence artificielle et traduit automatiquement sans relecture. Nous vous prions de nous excuser pour d'éventuelles erreurs.