Configurer MagicAI Chat

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
• Fast Finance Link
• Activer et autoriser (whitelist)
• Intégrer le widget de chat
• Données de tiers et licences
• Où les membres trouvent le chat

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).

Remarque : Les membres doivent pouvoir reconnaître clairement qu’ils interagissent avec un système d’IA (conformément au règlement européen sur l’IA, article 50). Rédigez le message de bienvenue en conséquence. Exemple : « Bonjour ! Je suis votre assistant numérique IA. Je vous aide volontiers pour toute question concernant votre abonnement, nos cours ou des informations générales sur le studio. Comment puis-je vous aider aujourd’hui ? »

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 est un 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.

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.

Fast Finance Link

Si tu actives Fast Finance Link dans la section Fonctionnalités, le chatbot peut envoyer à un membre authentifié un Fast Finance Link par e-mail, après avoir vérifié son statut de paiement, afin qu'il puisse régler des demandes en cours ou mettre à jour son moyen de paiement. L'envoi utilise le même chemin que l'envoi manuel depuis le compte membre, y compris 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. Plus de détails dans l'article 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 destinataire (par exemple d***n@example.com).
• Les éléments inclus dans l'e-mail (paiement, moyen de paiement) dépendent de la configuration du Fast-Finance Link du studio ; le chatbot n'effectue 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 se résoudre grâce à cela, et recommande de contacter le studio si le problème persiste.

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).

Cela s'applique au site web du studio. Dans la Member Platform et dans Branded Web, aucun code d'intégration n'est nécessaire. Où les membres trouvent le chat.

Pour activer une configuration :

1. Ouvrez la vue d'ensemble sous Paramètres / MagicAI / Chat.
2. Sélectionnez la configuration que vous souhaitez activer.
3. 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. Le snippet n'est nécessaire que pour votre propre site web. Dans la Member Platform et dans Branded Web, le chat apparaît sans lui.

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.

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 inséré 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 configuration supplémentaire.

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. Dans un groupe de plusieurs studios, vous décidez donc studio par studio si ses membres obtiennent le chat.

Deux conséquences à connaître :

• Une configuration encore à l'état de brouillon n'atteint les membres nulle part, ni sur le site web ni dans la Member Platform.
• Si vous désactivez une configuration dans un studio, le chat disparaît pour les membres de ce studio également dans la Member Platform et dans Branded Web, et pas seulement sur le site web.

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.

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