Un manuel SEMJAT soutenu par une capture d'écran, construit à partir du flux réel du tableau de bord sem.chat. Chaque guide vous indique sur quoi cliquer, ce qui doit se passer après le clic, comment le tester, comment le dépanner et que faire ensuite.
Aucun guide correspondant trouvé. Essayez un mot clé plus court tel que widget, API, voix, facturation, webhook, WordPress, SendPulse ou planification.
Note sur les captures d’écran : chaque image de ce manuel a été capturée depuis la vraie application sem.chat avec un espace de travail de démonstration. Les détails sensibles du compte, les données client, les clés API, les informations de paiement et le contenu des conversations privées sont masqués avant publication.
01
Commencer
Créez le compte, terminez l'intégration, comprenez le tableau de bord, créez le premier bot, testez-le en privé, installez-le et choisissez le bon plan.
/authInscription, essai et premier bot
1Commencez par vous inscrire ou vous connecter à partir du site ou de l'application publique.
2Vérifiez l'adresse e-mail avant de vous fier aux notifications ou aux messages de facturation.
3Utilisez l'intégration pour créer le premier bot avant d'ouvrir le tableau de bord.
/aperçuAperçu après la connexion
1Utilisez des actions rapides pour créer un bot, afficher les robots, ouvrir des analyses ou gérer la facturation.
2Examinez les robots actifs, conversations, les minutes vocales et la satisfaction avant d'apporter des modifications.
3Vérifiez l'activité récente après chaque test de configuration.
Premier lancement
Inscrivez-vous, démarrez l'essai et comprenez le tableau de bord
A quoi ça sert : Utilisez ce flux de travail pour un tout nouvel espace de travail ou lors de l'intégration d'un coéquipier qui n'a jamais utilisé sem.chat.
Avant de commencer
Utilisez une messagerie professionnelle pouvant recevoir des e-mails de vérification et de facturation.
Décidez à qui appartient l’espace de travail avant d’inviter le reste de l’équipe.
Gardez un site Web de test sécurisé ou une page de préparation prête pour l'installation du widget.
1
Ouvrez la page d'inscription à l'application
Accédez à app.sem.chat/auth à partir du bouton de connexion/inscription du site Web.
Résultat attendu : La page d'authentification affiche les options de connexion et de création de compte.
2
Créer le compte
Entrez l'e-mail professionnel, créez le mot de passe et soumettez le formulaire d'inscription.
Résultat attendu : L'application demande une vérification ou passe à l'intégration une fois le compte accepté.
3
Vérifiez l'e-mail
Ouvrez l'e-mail de vérification et cliquez sur le lien de confirmation.
Résultat attendu : Le compte peut recevoir des messages de facturation, d'invitation, de rapport et d'alerte.
4
Intégration complète
Entrez le nom de l'entreprise, décrivez l'objectif de l'assistant, choisissez une couleur de départ et créez le premier bot.
Résultat attendu : L'espace de travail s'ouvre avec un brouillon de bot et un état d'essai actif.
5
Ouvrir l'aperçu
Cliquez sur Présentation dans la barre latérale gauche.
Résultat attendu : Le tableau de bord affiche les cartes usage, les actions rapides et l'activité récente.
6
Choisissez l'action suivante
Utilisez Créer un nouveau bot pour la configuration, Afficher tous les robots pour la gestion, Analytics pour les performances ou Facturation pour les limites du plan.
Résultat attendu : Vous savez où continuer en fonction de l'état de l'espace de travail.
Comment le tester : Créez un robot de test privé et envoyez un message de test avant d'inviter des coéquipiers. Confirmez les modifications apportées à l'activité Aperçu après le test.
Problème
Corriger
L'e-mail de vérification n'arrive pas
Vérifiez le spam, confirmez l'orthographe de l'e-mail, puis demandez un autre e-mail de vérification.
Le tableau de bord s'ouvre lors de la facturation
L’espace de travail peut nécessiter un essai ou un plan actif. Démarrez l’essai ou choisissez le bon plan avant la configuration.
Un coéquipier ne peut pas accéder à l'espace de travail
Invitez-les depuis Paramètres, Équipe au lieu de partager la connexion du propriétaire.
Que faire ensuite : Créez le premier bot, testez-le en privé, puis installez le widget sur une page intermédiaire.
Test de lancement privé
Créez le premier test de bot privé avant de le mettre en ligne
A quoi ça sert : Utilisez-le pour vérifier le suivi du compte, du bot, du widget et de l’historique avant que les clients ne voient l’assistant.
Avant de commencer
Préparez un exemple de question client.
Préparez une page de préparation ou une page de test HTML locale.
N'utilisez pas de données client réelles lors du premier test.
1
Ouvrez My Bots
Cliquez sur My Bots dans la barre latérale ou utilisez Afficher tous les robots depuis la présentation.
Résultat attendu : Vous pouvez voir le bot créé lors de l'intégration ou un état vide avec un bouton Nouveau Bot.
2
Ouvrez le générateur de bot
Cliquez sur Nouveau bot ou Modifier sur le bot existant.
Résultat attendu : Le Bot Builder s'ouvre avec les commandes de base, de widget, de connaissances, de voix et d'intégration.
3
Enregistrez le bot une fois
Remplissez le nom du bot et le premier message requis, puis cliquez sur Enregistrer.
Résultat attendu : Le bot reçoit un identifiant valide et peut générer du code intégré.
4
Aperçu en privé
Utilisez le panneau d’aperçu et posez votre exemple de question.
Résultat attendu : La réponse doit correspondre à vos instructions ou révéler les connaissances manquantes.
5
Installer sur la scène
Ouvrez Embed, copiez l'extrait HTML et collez-le avant la balise body de fermeture sur la page de préparation.
Résultat attendu : Le widget apparaît dans le coin configuré sur ordinateur et mobile.
6
Confirmer le suivi
Ouvrez la boîte de réception ou Chat History après la conversation test.
Résultat attendu : La conversation de test apparaît avec le bot, le canal et l'historique des messages corrects.
Comment le tester : Envoyez un message texte et un test vocal si la voix est activée. Confirmez que les deux apparaissent dans Chat History.
Problème
Corriger
Le code intégré n'est pas disponible
Enregistrez d'abord le bot. Si la synchronisation vocale est toujours en attente, attendez la synchronisation ou enregistrez à nouveau une fois les champs obligatoires remplis.
Le widget affiche le mauvais bot
Confirmez que le data-bot-id dans l'extrait correspond à l'ID du bot du modal Embed.
Aucune conversation n'apparaît dans l'historique
Actualisez Chat History, confirmez que le bot est actif et assurez-vous que le test a eu lieu sur le widget installé, et non sur une page obsolète.
Que faire ensuite : Passez à la configuration et à la formation des connaissances de Bot Builder.
02
Créer et configurer un bot
Créez, modifiez, prévisualisez, activez, transférez ou supprimez des robots de My Bots et Bot Builder.
/tableau de bordCentre de contrôle My Bots
1Cliquez sur Nouveau Bot pour démarrer un nouvel assistant.
2Utilisez Modifier, Intégrer, Transférer, Activer ou Supprimer sur chaque carte de robot.
3Vérifiez l'état actif et l'heure de la dernière mise à jour avant de tester.
/bots/:id/modifierOnglet de base Bot Builder
1Remplissez le nom du robot, l'avatar, le premier message et les instructions système.
2Utilisez Aperçu pour tester avant de publier.
3Enregistrez et synchronisez avant de copier le code intégré.
Créer un robot
Créez un nouveau bot à partir de My Bots
A quoi ça sert : Utilisez ce flux de travail lorsqu'une nouvelle marque, un nouveau site Web, une file d'attente d'assistance ou une campagne a besoin de son propre assistant.
Avant de commencer
Préparez le nom du bot, l’objectif, le premier message et deux ou trois exemples de questions.
Collectez le site Web public URL si vous envisagez d'importer du contenu.
Confirmez que le plan autorise le nombre de robots et de fonctionnalités vocales/avatar dont vous avez besoin.
1
Ouvrez My Bots
Cliquez sur My Bots dans la barre latérale.
Résultat attendu : Les robots existants et le bouton Nouveau robot sont visibles.
2
Cliquez sur Nouveau robot
Démarrez un nouveau bot à partir de la page My Bots.
Résultat attendu : Bot Builder s'ouvre avec un assistant de brouillon.
3
Définir l'identité du bot
Entrez le nom du robot, téléchargez ou choisissez un avatar et rédigez le premier message que les visiteurs verront.
Résultat attendu : Le panneau d'aperçu reflète le nom de l'assistant, l'avatar et le message d'accueil.
4
Écrire les instructions du système
Décrivez ce que le robot doit faire, comment il doit parler, ce qu'il doit éviter et quand il doit demander de l'aide humaine.
Résultat attendu : L'assistant dispose de règles de comportement claires avant d'ajouter des connaissances.
5
Ajouter des connaissances de base
Collez les informations essentielles sur l'entreprise, le produit, l'assistance, les prix et les contacts dans la zone de connaissances.
Résultat attendu : Le bot peut répondre aux questions courantes sans avoir encore besoin d’importer le site Web.
6
Enregistrez le robot
Cliquez sur Enregistrer et attendez la confirmation enregistrée ou synchronisée.
Résultat attendu : Le bot a un identifiant stable, l'aperçu peut être testé et les options d'intégration deviennent disponibles.
7
Prévisualiser le résultat
Posez les exemples de questions préparés dans Aperçu.
Résultat attendu : Les réponses doivent suivre les instructions et utiliser les connaissances que vous avez saisies.
8
Activer uniquement lorsque vous êtes prêt
Activez le bot une fois le test privé réussi.
Résultat attendu : Le bot est prêt pour le trafic de widgets ou de canaux.
Comment le tester : Posez au moins cinq questions réalistes. Vérifiez si la réponse est correcte, si elle reste fidèle à la marque et si elle demande de l'aide humaine en cas de besoin.
Problème
Corriger
La réponse est trop générique
Ajoutez des connaissances plus spécifiques et réécrivez les instructions avec des exemples de bonnes réponses.
Le bot refuse les questions auxquelles il devrait répondre
Supprimez les instructions trop strictes et ajoutez des connaissances fiables sur ce sujet.
L'enregistrement ne génère pas de code d'intégration
Vérifiez les champs obligatoires et enregistrez à nouveau une fois la synchronisation du fournisseur vocal terminée.
Que faire ensuite : Configurez les paramètres du widget, ajoutez des connaissances sur le site Web, puis installez le bot.
Gérer les robots
Modifier, cloner un workflow, transférer, désactiver ou supprimer un bot
A quoi ça sert : Utilisez ce flux de travail lorsqu'un bot a besoin de mises à jour, de changements de propriété, d'une pause temporaire ou d'une suppression permanente.
Avant de commencer
Exportez toutes les données de conversation ou de contact que vous devez conserver avant de supprimer un bot.
Vérifiez que le bot n'est pas intégré à un site Web en direct avant de le supprimer ou de le transférer.
Informez vos coéquipiers avant de désactiver un robot de production.
1
Ouvrez My Bots
Recherchez la carte du robot par nom ou statut.
Résultat attendu : La carte affiche l'état actuel et les actions disponibles.
2
Cliquez sur Modifier
Ouvrez le générateur de bot et apportez les modifications requises.
Résultat attendu : L'éditeur charge la configuration actuelle.
3
Enregistrer et retester
Cliquez sur Enregistrer après chaque modification importante, puis exécutez les questions d'aperçu.
Résultat attendu : La configuration enregistrée est utilisée par l'aperçu et le widget installé.
4
Désactiver temporairement
Utilisez la bascule active si le bot doit cesser de gérer les visiteurs pour le moment.
Résultat attendu : Le bot cesse de diffuser le trafic en direct tout en préservant la configuration.
5
Transférer la propriété
Utilisez Transfert, saisissez l'e-mail du destinataire et confirmez.
Résultat attendu : Le compte sélectionné devient propriétaire en fonction du flux de transfert de l'application.
6
Supprimer seulement après vérifications
Utilisez Supprimer, lisez l’avertissement et confirmez uniquement lorsque le bot n’est plus nécessaire.
Résultat attendu : Le bot et la configuration associée sont supprimés conformément à l'avertissement.
Comment le tester : Après l'édition, ouvrez le widget installé et posez la question exacte qui a motivé le changement. Confirmez que la réponse en direct a été modifiée.
Problème
Corriger
L'ancienne réponse apparaît toujours
Actualisez la page du site Web, confirmez que vous avez enregistré le bon bot et vérifiez si les connaissances importées nécessitent une synchronisation.
Le transfert échoue
Confirmez que l'e-mail du destinataire est valide et que le compte de destination peut accepter le bot.
L'utilisateur a cliqué sur Supprimer par erreur
Arrêtez-vous avant la confirmation finale. Des avertissements de suppression existent car l'action peut supprimer définitivement les données du robot.
Que faire ensuite : Examinez les analyses et l'historique après les modifications en direct pour vous assurer que l'expérience des visiteurs s'est améliorée.
03
Installer le widget
Copiez le code d'intégration correct, installez-le dans des contextes HTML, WordPress, React ou avancés SDK, puis vérifiez le comportement sur ordinateur et mobile.
Intégrer le modalCopiez l'extrait d'installation du site Web
1Choisissez HTML, WordPress, React ou NPM/SDK en fonction de la pile du site.
2Copiez le code une fois le bot enregistré et synchronisé.
3Collez l'extrait avant la balise body de fermeture ou dans la mise en page du framework.
HTML installer
Installez le widget sur un site Web HTML standard
A quoi ça sert : Utilisez-le lorsque vous pouvez modifier le modèle de page, le pied de page du thème ou la mise en page globale HTML.
Avant de commencer
Enregistrez d'abord le bot afin que le modal d'intégration ait un véritable identifiant de bot.
Utilisez un site de préparation avant la production.
Conservez la version exacte du script et data-bot-id du modal.
1
Ouvrez My Bots
Recherchez le bot que vous souhaitez installer et cliquez sur Intégrer.
Résultat attendu : Le modal Embed s’ouvre avec les onglets d’installation.
2
Sélectionnez HTML
Choisissez l'onglet HTML et cliquez sur Copier le code.
Résultat attendu : Le script du widget est copié avec l'ID du bot attaché.
3
Ouvrez le modèle de site Web
Modifiez le pied de page global ou le fichier de mise en page qui s'affiche sur chaque page où le widget doit apparaître.
Résultat attendu : Vous modifiez le shell du site partagé, pas une seule page isolée, sauf si cela est intentionnel.
4
Coller avant de fermer le corps
Collez l'extrait immédiatement avant la balise body de fermeture.
Résultat attendu : Le script se charge après le contenu de la page et peut monter le conteneur de widgets.
5
Publier ou déployer
Enregistrez le modèle et déployez le site.
Résultat attendu : Le script du widget est en direct sur les pages cibles.
6
Tester ordinateur et mobile
Ouvrez le site dans une nouvelle fenêtre de navigateur et sur une fenêtre mobile.
Résultat attendu : Le widget apparaît dans la position configurée et s'ouvre sans erreur de console.
Comment le tester : Envoyez un message depuis la page en direct, puis ouvrez la boîte de réception et Chat History pour confirmer que la conversation appartient au bon bot.
Problème
Corriger
Le widget est manquant
Confirmez que le code se trouve avant la balise de fermeture du corps, que les scripts ne sont pas bloqués par le constructeur du site et que le bot est actif.
Un mauvais bot apparaît
Copiez à nouveau l'extrait et comparez le data-bot-id avec le bot souhaité.
Le widget chevauche les contrôles de page
Modifiez la position ou la taille dans les paramètres du widget et testez à nouveau sur mobile.
Que faire ensuite : Ajustez les paramètres du widget et la capture de leads après l'installation.
Installer dans les flux WordPress, React ou vocaux avancés SDK
A quoi ça sert : Utilisez-le lorsque le site Web est géré par un CMS, une application React ou une intégration vocale personnalisée.
Avant de commencer
Sachez quelle pile possède la mise en page partagée.
Utilisez l'extrait exact affiché dans sem.chat pour le bot sélectionné.
Pour une utilisation avancée de SDK, confirmez que vous disposez de la clé publique Vapi et de l'ID d'assistant requis.
1
Option WordPress
Utilisez Apparence, Theme Editor, footer.php ou un plugin d’en-têtes et de pieds de page fiable.
Résultat attendu : L'extrait est chargé sur les pages publiques WordPress.
2
Option React
Créez un petit composant ChatWidget, ajoutez le script dans useEffect et affichez-le dans la disposition racine.
Résultat attendu : Le widget se charge une fois et se nettoie si la mise en page se démonte.
3
Option avancée SDK
Utilisez l'onglet NPM/SDK uniquement lorsque vous avez besoin de commandes d'appel vocal personnalisées au-delà du widget par défaut.
Résultat attendu : Votre application contrôle la session vocale tandis que sem.chat reste la source d'assistant configurée.
4
Vérifier l'ID du bot
Confirmez que le code installé fait référence à l'ID du bot à partir du modal Embed.
Résultat attendu : Le widget en direct se connecte à l'assistant prévu.
5
Vérifier la console
Ouvrez les outils de développement du navigateur et rechargez.
Résultat attendu : Il n’y a pas d’erreurs de script bloqué, de conteneur en double ou de réseau.
Comment le tester : Complétez un message de test à partir du site installé, puis confirmez qu'il apparaît dans la boîte de réception avec la page attendue URL.
Problème
Corriger
React charge les widgets en double
Protégez l'insertion du script avec une référence ou restituez le composant uniquement dans la disposition racine.
WordPress supprime les balises de script
Utilisez un plugin d'injection de pied de page ou un fichier de thème autorisant les scripts.
L'appel SDK ne peut pas démarrer
Vérifiez la clé publique, l'ID de l'assistant, les autorisations du navigateur et planifiez l'accès pour la voix.
Que faire ensuite : Accédez aux paramètres du widget pour contrôler le comportement, l’image de marque et la capture de prospects.
npm install @vapi-ai/web
import Vapi from '@vapi-ai/web';
const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');
vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04
Paramètres des widgets
Configurez le mode, le thème, la taille, la position, la couleur, la marque, les réactions, le son, le consentement, la capture de prospects, les évaluations, l'e-mail de suivi et l'état d'activation.
Bot Builder / WidgetApparence du widget et comportement des visiteurs
1Choisissez le mode chat, vocal ou hybride.
2Définissez le thème, la couleur, la position, la taille, la marque, le consentement et le son.
3Configurez la capture de leads, les évaluations, les réactions et le comportement de suivi.
Comportement des widgets
Configurer le comportement du widget destiné aux visiteurs
A quoi ça sert : Utilisez-le après la première installation ou à chaque fois que le widget doit correspondre au site Web et capturer de meilleurs prospects.
Avant de commencer
Installez le widget sur une page intermédiaire.
Sachez si les visiteurs doivent commencer par chat, par la voix ou par les deux.
Préparez une copie du consentement et de la capture des prospects si nécessaire pour la région.
1
Ouvrez le générateur de bot
Ouvrez My Bots, cliquez sur Modifier, puis choisissez l'onglet Widget.
Résultat attendu : Les contrôles du widget apparaissent pour le bot sélectionné.
2
Choisissez le mode
Sélectionnez Chat, Voix ou Hybride en fonction de l'expérience visiteur souhaitée.
Résultat attendu : L'aperçu change pour afficher le mode choisi.
3
Définir l'apparence
Choisissez le thème, la couleur, la taille, la position du bouton et les options de marque.
Résultat attendu : Le widget correspond au site sans couvrir le contenu important.
4
Activer les contrôles des visiteurs
Activez ou désactivez les réactions, le son, les évaluations et les invites de consentement.
Résultat attendu : Les visiteurs voient uniquement les commandes que vous souhaitez qu’ils utilisent.
5
Configurer la capture de leads
Choisissez les champs obligatoires, le champ de description facultatif et le moment où le formulaire apparaît.
Résultat attendu : Les contacts sont collectés avant ou pendant conversations selon votre configuration.
6
Définir un e-mail de suivi
Configurez le comportement des e-mails de suivi si votre forfait l'inclut.
Résultat attendu : Les visiteurs peuvent recevoir des messages de suivi après avoir résolu conversations.
7
Enregistrer et tester
Cliquez sur Enregistrer, rechargez la page de préparation et ouvrez le widget.
Résultat attendu : Le widget en direct correspond aux paramètres enregistrés.
Comment le tester : Ouvrez le widget sur ordinateur et mobile, soumettez un formulaire pour prospects, laissez une note et confirmez que le contact et la conversation sont enregistrés.
Problème
Corriger
La couleur n'a pas été mise à jour
Enregistrez le bot, actualisez le site Web et confirmez que le widget installé utilise le même ID de bot.
Les champs de prospects sont manquants
Confirmez que la capture de leads est activée et que la condition de déclenchement sélectionnée est remplie.
Les visiteurs ne peuvent pas utiliser la voix
Vérifiez les paramètres vocaux, l'autorisation du microphone du navigateur, le plan d'accès et les limites de minutes vocales.
Que faire ensuite : Ajoutez des paramètres de voix/avatar et des sources de connaissances avant le lancement de la production.
05
Voix et avatars
Sélectionnez les voix d'origine, configurez le mode vocal et les limites, lisez les transcriptions, clonez les voix, attribuez des voix clonées et gérez les avatars d'origine ou personnalisés.
Bot Builder / VoixVoix, limites, transcriptions et avatars
1Choisissez une voix stock ou une voix clonée enregistrée.
2Définissez des limites de minutes de voix et la sauvegarde des transcriptions.
3Choisissez des avatars standards ou téléchargez un avatar personnalisé si le plan le permet.
Configuration vocale
Configurer des appels vocaux et des transcriptions
A quoi ça sert : Utilisez-le lorsque les visiteurs doivent parler au bot au lieu de simplement taper.
Avant de commencer
Confirmez que le forfait comprend les minutes vocales et les options voix/avatar souhaitées.
Utilisez un environnement de navigateur silencieux pour les tests.
Préparez une question d’assistance ou de vente réaliste à tester vocalement.
1
Ouvrir les paramètres vocaux
Ouvrez le générateur de robots et sélectionnez la zone Voix ou Voix et avatars.
Résultat attendu : Les commandes vocales et la sélection vocale actuelle sont visibles.
2
Sélectionnez une voix standard
Prévisualisez les voix disponibles, choisissez la meilleure solution et enregistrez la sélection.
Résultat attendu : Le bot utilise la voix choisie pour les appels.
3
Configurer le mode vocal
Utilisez les paramètres du widget pour choisir Voix ou Hybride lorsque la voix doit être disponible pour les visiteurs.
Résultat attendu : Les visiteurs voient une option vocale dans le widget.
4
Définir des limites de voix
Définissez des limites par utilisateur ou par espace de travail, si disponibles.
Résultat attendu : Les appels longs ou répétés ne peuvent pas consommer plus de minutes que prévu.
5
Activer les transcriptions
Activez l'enregistrement de la transcription si vous avez besoin d'une révision des appels dans l'historique.
Résultat attendu : Les appels vocaux créent des transcriptions lisibles après la session.
6
Tester un appel
Ouvrez le widget, autorisez l'accès au microphone, démarrez un appel et posez la question préparée.
Résultat attendu : Le bot répond vocalement et l’appel se termine proprement.
7
Lire la transcription
Ouvrez Chat History et recherchez la conversation vocale.
Résultat attendu : La transcription montre ce que le visiteur et le bot ont dit.
Comment le tester : Effectuez un court appel et confirmez que les minutes vocales, la transcription et le mode de conversation sont enregistrés.
Problème
Corriger
Le navigateur bloque le microphone
Autorisez l’autorisation du microphone dans le navigateur et rechargez la page.
L'option vocale est verrouillée
Ouvrez Facturation et confirmez que le plan d'espace de travail inclut des fonctionnalités vocales.
La transcription est vide
Confirmez que l’enregistrement de la transcription est activé et que l’appel s’est terminé normalement.
Que faire ensuite : Ajoutez ou affinez vos connaissances pour que les réponses vocales soient exactes.
Clone de voix et avatar
Cloner une voix et attribuer un avatar personnalisé
A quoi ça sert : Utilisez-le lorsque l'assistant a besoin d'une voix de marque ou d'une expérience d'avatar parlant.
Avant de commencer
Utilisez uniquement le son et les images que vous êtes autorisé à utiliser.
Enregistrez des échantillons de voix clairs avec un faible bruit de fond.
Confirmez les limites du forfait pour les voix clonées et les avatars personnalisés.
1
Clonage de voix ouverte
Cliquez sur Cloner la voix dans la zone Voix.
Résultat attendu : La boîte de dialogue de téléchargement affiche les exemples d'exigences acceptées.
2
Télécharger des échantillons
Téléchargez un à cinq enregistrements clairs et soumettez la demande de clonage.
Résultat attendu : La voix clonée apparaît après le traitement ou la boîte de dialogue affiche l'exigence suivante.
3
Attribuer la voix clonée
Sélectionnez la voix clonée dans le sélecteur de voix et enregistrez.
Résultat attendu : Les prochains appels utiliseront la voix clonée.
4
Choisissez un avatar standard
Choisissez un avatar inclus si le téléchargement d'un avatar personnalisé n'est pas nécessaire.
Résultat attendu : L’expérience vocale a une identité visuelle.
5
Télécharger un avatar personnalisé
Téléchargez une image de visage claire ou une courte vidéo si votre forfait le prend en charge.
Résultat attendu : L'avatar est traité et devient disponible pour la sélection.
6
Exécuter un aperçu complet
Démarrez un appel vocal et confirmez ensemble le comportement de la voix, de l'avatar et de la transcription.
Résultat attendu : L'expérience du visiteur correspond à la marque configurée.
Comment le tester : Posez une courte question avec la voix clonée sélectionnée et confirmez que l'appel utilise la voix/l'avatar attendu.
Problème
Corriger
La qualité du clone est médiocre
Enregistrez des échantillons plus propres avec un seul haut-parleur, un volume stable et sans musique.
Le téléchargement d'avatar personnalisé n'est pas disponible
Vérifiez la facturation pour connaître les limites d'avatar liées au plan.
La vieille voix joue toujours
Enregistrez le bot après avoir sélectionné la nouvelle voix et rechargez la page du widget.
Que faire ensuite : Passez à Connaissances et données pour que l'expérience vocale ait des réponses précises.
06
Connaissances et données
Ajoutez des connaissances manuelles, importez le contenu du site Web, appliquez les résultats de l'analyse, synchronisez le contenu importé, ajoutez des flux de produits URLs, actualisez ou supprimez des flux et vérifiez les réponses avec des questions de test.
Bot Builder / ConnaissanceSources de connaissances et tests de réponses
1Ajoutez des connaissances manuelles sur les règles de politique, de tarification et de marque.
2Importez des pages de sites Web et appliquez les résultats de l'analyse.
3Ajoutez des flux de produits et synchronisez-les lorsque l'inventaire change.
Sources de connaissances
Former le bot avec des connaissances manuelles, l'importation de sites Web et des flux de produits
A quoi ça sert : Utilisez-le chaque fois que l'assistant donne des réponses incomplètes ou a besoin d'informations récentes sur un produit, une politique ou un site Web.
Avant de commencer
Préparez les URL sources et les flux de produits URL.
Décidez quelles pages ne doivent pas être importées, comme les pages d'administration ou privées.
Créez des questions de test pour chaque sujet que vous ajoutez.
1
Connaissance ouverte
Ouvrez Bot Builder et choisissez l'onglet Connaissances ou Données.
Résultat attendu : Les connaissances manuelles, l'importation de sites Web et les outils de flux de produits sont visibles.
2
Ajouter des connaissances manuelles
Collez des faits concis, des politiques, des tarifs, des coordonnées et des notes de style de réponse.
Résultat attendu : Le bot dispose d’une source fiable immédiate pour les réponses hautement prioritaires.
3
Importer le contenu du site Web
Collez le site Web public URL et lancez l'exploration/l'importation.
Résultat attendu : Les résultats de l'analyse affichent les pages découvertes ou l'état de l'importation.
4
Examiner et appliquer les résultats
Conservez les pages utiles, supprimez les pages non pertinentes, puis appliquez le contenu sélectionné.
Résultat attendu : Seul le contenu du site Web approuvé entre dans la base de connaissances.
5
Ajouter un flux de produits URLs
Collez Google Merchant Center ou les flux pris en charge URLs et importez.
Résultat attendu : Les produits, les prix, la disponibilité et les attributs deviennent disponibles pour le bot.
6
Actualiser ou supprimer des flux
Utilisez l'actualisation lorsque les données du catalogue changent et supprimez les flux qui ne sont plus utilisés.
Résultat attendu : Le bot évite les données produit obsolètes ou en double.
7
Enregistrer et synchroniser
Enregistrez le bot et attendez la fin de la synchronisation.
Résultat attendu : Les dernières connaissances sont utilisées par les réponses en aperçu et en direct des widgets.
8
Poser des questions de vérification
Posez une question test par source que vous avez ajoutée.
Résultat attendu : La réponse cite ou reflète avec précision le contenu mis à jour.
Comment le tester : Posez des questions sur les prix, les retours, la disponibilité, les informations sur l'entreprise et les sujets non pris en charge. Confirmez que le bot répond à des sujets connus et n'invente pas de détails inconnus.
Problème
Corriger
Le robot importe les pages non pertinentes
Supprimez ces pages des résultats sélectionnés et ajoutez des instructions manuelles plus claires.
Les prix des produits sont obsolètes
Actualisez le flux et confirmez que le flux URL lui-même contient les valeurs actuelles.
Le robot invente des réponses
Ajoutez une règle selon laquelle le bot doit dire qu'il n'est pas sûr et offrir une assistance humaine lorsque les connaissances manquent.
Que faire ensuite : Revenez à Aperçu, testez à nouveau, puis installez ou mettez à jour le widget.
07
Boîte de réception, Live Support, Historique, Contacts
Gérez quotidiennement conversations, réclamez des demandes d'assistance en direct, remettez le contrôle à l'IA, exportez l'historique, gérez les contacts et synchronisez les contacts avec SendPulse.
/boîte de réceptionFlux de travail des conversations en boîte de réception
1Filtrez par bot ou par canal.
2Ouvrez une conversation et répondez en tant qu'humain en cas de besoin.
3Utilisez les contrôles de traduction, de résolution et de transfert avec précaution.
/support-en directContrôle de transfert de support en direct
1Réclamez rapidement les transferts en attente.
2Répondez en tant qu'agent ou remettez la conversation à l'IA.
3Résolvez lorsque le visiteur n’a plus besoin d’aide humaine.
/chat-historiqueHistorique des conversations et exportations
1Recherchez par visiteur, bot, canal ou date.
2Ouvrez les transcriptions complètes pour les sessions textuelles et vocales.
3Exportez CSV ou JSON si nécessaire.
/contactsContacts et export SendPulse
1Filtrez les contacts par bot ou par source.
2Ouvrez les coordonnées et le contexte de la conversation.
3Exportez ou synchronisez les contacts sélectionnés vers SendPulse.
Réponse dans la boîte de réception
Ouvrez une conversation et envoyez une réponse humaine
A quoi ça sert : Utilisez-le lorsqu'un opérateur doit répondre à un client depuis sem.chat au lieu de laisser l'IA continuer seule.
Avant de commencer
Confirmez que l'opérateur a accès au bot ou à l'espace de travail.
Lisez la conversation avant de répondre.
Sachez si le visiteur attend la même langue.
1
Ouvrir la boîte de réception
Cliquez sur Boîte de réception dans la barre latérale.
Résultat attendu : Les conversations récents apparaissent avec le bot, le canal, le visiteur, le statut et l'heure.
2
Filtrer si besoin
Utilisez des filtres de canal, de bot, non lu ou de statut pour rechercher la conversation.
Résultat attendu : La liste se limite à l'ensemble de conversations dont vous avez besoin.
3
Ouvrir la conversation
Cliquez sur la ligne du visiteur.
Résultat attendu : Le fil de discussion complet, les informations sur les visiteurs et les contrôles de réponse sont visibles.
4
Traduire si besoin
Utilisez des contrôles de traduction lorsque la langue du visiteur diffère de celle de l'agent.
Résultat attendu : L'agent peut comprendre et répondre de manière appropriée.
5
Envoyer une réponse
Écrivez la réponse humaine et envoyez-la.
Résultat attendu : Le message est ajouté au fil de discussion en tant que réponse d'agent/humain.
6
Résoudre ou garder ouvert
Résolvez la conversation si elle est terminée ou laissez-la ouverte pour un suivi.
Résultat attendu : L'état de la boîte de réception correspond à l'état réel du client.
Comment le tester : Envoyez une réponse de test sécurisée à une conversation de test et confirmez qu'elle apparaît dans le widget visiteur et Chat History.
Problème
Corriger
La réponse n'a pas pu être envoyée
Vérifiez l'état du réseau, l'état de la conversation et si une assistance en direct a été demandée.
La langue du visiteur est incorrecte
Utilisez la traduction ou mettez à jour les paramètres de langue du robot avant de répondre.
La conversation n'est pas dans la boîte de réception
Recherchez Chat History et confirmez que le test du widget a utilisé le bon bot.
Que faire ensuite : Utilisez Live Support pour les files d'attente de transfert actives et Chat History pour les audits.
Assistance en direct
Réclamez, répondez, remettez à l'IA et résolvez un transfert
A quoi ça sert : Utilisez-le lorsque l'IA demande un humain ou qu'un visiteur a explicitement besoin d'un agent.
Avant de commencer
Ayez un agent disponible avant d’activer l’assistance en direct.
Définissez quand l’IA doit demander le transfert dans les instructions du bot.
Gardez les paramètres de notification activés pour les alertes de transfert.
1
Ouvrez Live Support
Cliquez sur Live Support dans la barre latérale.
Résultat attendu : L'attente et le transfert actif conversations sont visibles.
2
Réclamez la demande
Cliquez sur Réclamation dans la conversation en attente.
Résultat attendu : Les autres agents peuvent voir que la conversation est gérée activement.
3
Lire le contexte
Ouvrez les messages et les détails du visiteur avant de répondre.
Résultat attendu : L'agent comprend pourquoi le transfert a eu lieu.
4
Envoyez la réponse humaine
Répondez clairement et tenez le fil de discussion à jour.
Résultat attendu : Le visiteur reçoit une réponse humaine.
5
Rendre à l'IA le cas échéant
Utilisez la main lorsque le problème est résolu et que l'IA peut continuer.
Résultat attendu : L'IA reprend le traitement de la conversation.
6
Résoudre une fois terminé
Cliquez sur Résoudre une fois que le visiteur n'a plus besoin d'aide.
Résultat attendu : Le transfert est fermé et supprimé de la file d'attente active.
Comment le tester : Créez un transfert de test, réclamez-le, répondez une fois, remettez-le et confirmez les changements de statut dans Live Support et Chat History.
Problème
Corriger
Les agents manquent des demandes
Activez les notifications de navigateur/e-mail/push et ajoutez un processus pour la propriété de la file d'attente.
L’IA continue de prendre le dessus trop tôt
Ajustez les instructions et les règles de transfert afin que le contrôle humain reste actif jusqu'à ce qu'il soit résolu ou restitué.
CRM externe n'est pas synchronisé
Utilisez des webhooks ou des sondages de la section Recettes pour développeurs.
Que faire ensuite : Connectez CRM/webhooks si les équipes d'assistance travaillent en dehors de sem.chat.
Historique et contacts
Rechercher, exporter et utiliser des enregistrements de conversation/contact
A quoi ça sert : Utilisez-le pour les audits, l'examen des prospects, l'exportation CSV et la synchronisation SendPulse.
Avant de commencer
Décidez si vous avez besoin de conversations, de contacts ou des deux.
Appliquez la plage de dates correcte avant d’exporter.
N'exportez pas plus de données personnelles que nécessaire.
1
Ouvrez Chat History
Cliquez sur Chat History dans la barre latérale.
Résultat attendu : Les filtres de conversation, les statistiques et la liste des transcriptions sont visibles.
2
Rechercher et filtrer
Filtrez par bot, canal, mode, visiteur ou plage de dates.
Résultat attendu : Seuls les conversations correspondants restent visibles.
3
Ouvrir une transcription
Cliquez sur une conversation pour lire le fil de discussion complet.
Résultat attendu : Le contexte complet, les coordonnées et les métadonnées de la conversation sont visibles.
4
Exporter conversations
Cliquez sur Exporter et choisissez le format requis s'il est disponible.
Résultat attendu : L'export contient les données de conversation filtrées.
5
Ouvrir les contacts
Cliquez sur Contacts dans la barre latérale.
Résultat attendu : Les enregistrements de leads/contacts apparaissent avec la source, le bot et le statut.
6
Filtrer et exporter des contacts
Recherchez des contacts, sélectionnez les enregistrements souhaités, puis exportez ou synchronisez vers SendPulse.
Résultat attendu : Les contacts sélectionnés sont disponibles en dehors de sem.chat selon l'action choisie.
Comment le tester : Exportez un petit CSV filtré et ouvrez-le localement pour confirmer que les colonnes et la plage de dates sont correctes.
Problème
Corriger
Contact manquant dans les contacts
Confirmez que la capture de leads est activée et que le visiteur a soumis le formulaire.
L'exportation est trop importante
Affinez la plage de dates ou le filtre du bot avant d’exporter.
Synchronisation SendPulse indisponible
Connectez d'abord SendPulse dans Intégrations, puis revenez à Contacts.
Que faire ensuite : Consultez Analytics pour comprendre les tendances de performances une fois les opérations exécutées.
08
Canaux et intégrations
Connectez Slack, Facebook, Instagram, WhatsApp, Telegram via BotFather, des informations d'identification manuelles, des liens chat alternatifs, des intégrations SendPulse et CRM.
/intégrationsCanaux, CRM et connexions de messagerie
1Choisissez le canal ou la carte d'intégration CRM.
2Suivez les étapes OAuth ou d'identification pour chaque fournisseur.
3Déconnectez ou testez à nouveau les intégrations à partir de la même page.
Connecter les chaînes
Connectez un canal de messagerie ou une intégration CRM
A quoi ça sert : Utilisez-le lorsque sem.chat doit recevoir conversations en dehors du widget du site Web ou envoyer des contacts vers d'autres outils.
Avant de commencer
Avoir un accès administrateur à la plateforme externe.
Sachez quel bot doit recevoir les messages du canal.
Utilisez des canaux de test avant de connecter des comptes de production.
1
Intégrations ouvertes
Cliquez sur Intégrations dans la barre latérale.
Résultat attendu : Les canaux disponibles, les outils CRM, SendPulse et les options de widget de site Web sont visibles.
2
Choisissez l'intégration
Cliquez sur Connecter sur Slack, les méta-canaux, Telegram, SendPulse, CRM ou les informations d'identification manuelles.
Résultat attendu : La boîte de dialogue de configuration ou le flux OAuth s'ouvre.
3
Configuration complète du fournisseur
Pour les canaux OAuth, approuvez les autorisations demandées. Pour les canaux manuels, collez le jeton, le secret, l'ID de compte ou le webhook requis URL.
Résultat attendu : sem.chat stocke la connexion et affiche l'intégration comme connectée.
4
Attribuer le bot
Choisissez quel bot doit gérer les messages de ce canal lorsque la boîte de dialogue le demande.
Résultat attendu : Les messages entrants sont acheminés vers le bon assistant.
5
Testez la chaîne
Envoyez un message test depuis le canal externe.
Résultat attendu : Le message apparaît dans la boîte de réception ou Chat History sous le bon canal.
6
Déconnecter si nécessaire
Utilisez Se déconnecter de la carte d'intégration lorsque le canal doit s'arrêter.
Résultat attendu : sem.chat cesse de recevoir ou d'envoyer via cette intégration.
Comment le tester : Envoyez un message test via le canal connecté et confirmez la réponse du bot, la ligne de la boîte de réception et l'historique.
Problème
Corriger
Le jeton Telegram échoue
Créez ou réinitialisez le jeton dans BotFather et collez-le à nouveau.
Les messages Slack n'arrivent pas
Vérifiez les étendues de l'application, l'abonnement aux événements URL, le jeton de bot, le secret de signature et l'adhésion au canal.
La connexion au méta-canal échoue
Confirmez que le compte Facebook/Instagram/WhatsApp dispose des autorisations d'administrateur et de l'accès professionnel requis.
La synchronisation SendPulse échoue
Reconnectez SendPulse et confirmez que les champs de contact sont mappés.
Que faire ensuite : Documentez la propriété des canaux pour l'équipe et surveillez la boîte de réception après le lancement.
09
Planification
Créez des types d'événements, configurez la disponibilité, connectez des calendriers, gérez les réservations, créez des liens ponctuels, configurez les e-mails de réservation, examinez les analyses, définissez des événements payants et testez les liens de réservation publics.
/planificationEspace de travail de planification
1Utilisez les onglets pour les types d'événements, les réservations, les analyses, les liens ponctuels, les calendriers, les e-mails et les paramètres.
2Modifiez, copiez, intégrez, activez ou mettez en pause les types d'événements.
3Copiez le lien public et effectuez un test de réservation privée.
Editeur d'événementsConfiguration du type d'événement
1Entrez le nom, la description, la durée, l'emplacement et les tampons.
2Définissez la disponibilité, les fenêtres de réservation, les questions, les options d'événements payants et les règles d'annulation.
3Enregistrez l'événement avant de partager le lien.
/book/:nom d'utilisateur/:eventSlugPage de réservation publique
1Les visiteurs choisissent une date sur la page de réservation publique.
2Les visiteurs choisissent un créneau horaire disponible.
3Les visiteurs confirment la réservation et reçoivent des e-mails de confirmation.
Type d'événement
Créer un type d'événement et publier un lien de réservation
A quoi ça sert : Utilisez-le lorsque les visiteurs doivent réserver des démos, des consultations, des appels commerciaux, des sessions d'intégration ou d'assistance.
Avant de commencer
Choisissez le nom de l'événement, la durée, le type de réunion et le propriétaire.
Définissez le fuseau horaire et la disponibilité avant de partager des liens.
Connectez les calendriers si la double réservation est importante.
1
Planification ouverte
Cliquez sur Planification dans la barre latérale.
Résultat attendu : L'espace de travail de planification affiche des onglets pour les types d'événements, les réservations, les analyses, les liens ponctuels, les calendriers, les e-mails et les paramètres.
2
Créer un type d'événement
Cliquez sur Créer, puis ajoutez le nom, la description, la durée, l'emplacement, la zone tampon et les règles de réservation.
Résultat attendu : L'événement dispose de suffisamment d'informations publiques pour que les visiteurs puissent le comprendre.
3
Définir la disponibilité
Configurez les heures hebdomadaires, les remplacements de date, les fenêtres de préavis et la fenêtre de réservation.
Résultat attendu : Les visiteurs ne voient que les horaires que vous êtes prêt à proposer.
4
Ajouter des questions
Ajoutez des questions obligatoires telles que le téléphone, l'entreprise, le site Web ou l'objectif de la réunion.
Résultat attendu : Les réservations collectent le contexte dont votre équipe a besoin avant l'appel.
5
Connecter les calendriers
Ouvrez les calendriers et connectez Google, Outlook ou iCal si disponible.
Résultat attendu : Les périodes de pointe peuvent être bloquées et les réservations confirmées peuvent être inscrites dans le calendrier.
6
Définir des e-mails et des rappels
Ouvrez les e-mails et configurez les messages de confirmation, de rappel, d'annulation et de reprogrammation.
Résultat attendu : Les visiteurs reçoivent une communication de réservation correcte.
7
Partager et tester le lien public
Copiez le lien de l'événement, ouvrez-le dans une fenêtre privée, choisissez un créneau et effectuez une réservation test.
Résultat attendu : La réservation apparaît dans l'onglet Réservations et des messages de confirmation sont envoyés.
Comment le tester : Effectuez une réservation de test, une reprogrammation et une annulation. Confirmez que chaque événement apparaît dans Planification et calendriers connectés.
Problème
Corriger
Aucune heure n'apparaît sur la page publique
Vérifiez le fuseau horaire, la disponibilité hebdomadaire, les remplacements de date, la fenêtre de notification et les conflits de calendrier connectés.
E-mail de réservation manquant
Vérifiez les paramètres de messagerie et le dossier spam, puis envoyez une autre réservation test.
Le paiement échoue lors d'un événement payant
Vérifiez que les paramètres d'intégration de facturation/paiement et la devise sont valides avant la publication.
Que faire ensuite : Intégrez des liens de réservation dans le bot, le site Web ou les e-mails de suivi.
Planification avancée
Utilisez des liens ponctuels, des analyses, des intégrations et des événements payants
A quoi ça sert : Utilisez-le lorsque la planification nécessite une disponibilité temporaire, des rapports, une réservation intégrée ou un paiement.
Avant de commencer
Créez d'abord au moins un type d'événement.
Connectez les calendriers avant d’utiliser massivement des liens ponctuels.
Définissez la politique de remboursement/annulation avant d’activer les événements payants.
1
Créer un lien unique
Ouvrez les liens ponctuels, sélectionnez les créneaux horaires ou les règles proposés, puis générez le lien.
Résultat attendu : Le destinataire peut réserver uniquement à partir de la disponibilité sélectionnée.
2
Planification intégrée
Utilisez l'option d'intégration de la carte d'événement si le flux de réservation doit apparaître sur votre site Web.
Résultat attendu : L'interface utilisateur de réservation peut être placée dans la page où les visiteurs effectuent la conversion.
3
Examiner les analyses de planification
Ouvrez Analytics dans Scheduling.
Résultat attendu : Vous pouvez voir les réservations, les tendances d’achèvement et les performances des types d’événements.
4
Activer les événements payants
Ouvrez l'éditeur d'événements, définissez le prix, la devise et le comportement de paiement.
Résultat attendu : Les visiteurs doivent compléter l'étape de paiement selon la configuration de l'événement.
5
Réservations d'audit
Ouvrez les réservations et examinez les entrées à venir, terminées, annulées et reprogrammées.
Résultat attendu : L’équipe peut gérer les présences et le suivi.
Comment le tester : Réservez via la page publique et via une page intégrée si utilisée. Confirmez que les deux créent le même type d’enregistrement de réservation.
Problème
Corriger
Un lien unique expose de mauvais emplacements
Régénérez le lien avec un ensemble de créneaux horaires plus petit ou une plage de dates plus stricte.
La réservation intégrée est trop étroite
Placez l'intégration dans un conteneur de contenu plus large et vérifiez la disposition mobile.
Les analyses semblent vides
Créez ou attendez de vraies réservations ; les analyses dépendent des enregistrements de réservation.
Que faire ensuite : Connectez les résultats de la planification aux rapports et analyses.
10
Analyses et rapports
Choisissez des plages de dates, utilisez des dates personnalisées, lisez les indicateurs de base, exportez CSV, examinez les tendances de satisfaction et de conversation, configurez les rapports par courrier électronique et vérifiez la livraison.
/analyseTableau de bord analytique
1Choisissez des plages de dates ou des dates personnalisées.
2Lisez les mesures de conversation, de satisfaction, de langue, de canal et de conversion.
3Exportez CSV pour une analyse hors ligne.
Paramètres / RapportsConfiguration du rapport par courrier électronique
1Choisissez la cadence des rapports quotidiens, hebdomadaires ou mensuels.
2Ajoutez des destinataires du rapport.
3Envoyez un rapport instantané pour tester la livraison.
Examen des analyses
Lire des analyses et exporter des données de performances
A quoi ça sert : Utilisez-le pour les examens hebdomadaires, les contrôles de lancement, l'examen de la qualité du support et l'analyse des conversions.
Avant de commencer
Choisissez la plage de dates avant de lire les métriques.
Sachez quel bot ou canal vous évaluez.
Excluez les dates de tests privés lors du rapport sur les performances de production.
1
Analyse ouverte
Cliquez sur Analytics dans la barre latérale.
Résultat attendu : Les métriques du tableau de bord et les panneaux graphiques sont visibles.
2
Choisir une plage de dates
Sélectionnez aujourd'hui, 7 jours, 30 jours ou des dates personnalisées.
Résultat attendu : Tous les graphiques sont mis à jour selon la période sélectionnée.
3
Lire les métriques de base
Examinez conversations, les minutes vocales, la satisfaction, la conversion et la combinaison de canaux.
Résultat attendu : Vous comprenez le volume et la qualité des interactions clients.
4
Examiner les tendances
Examinez les tendances de conversation, les changements de satisfaction, les questions les plus fréquentes et les modèles de langue/canal.
Résultat attendu : Vous pouvez identifier où améliorer les instructions du robot ou le personnel.
5
Exporter CSV
Utilisez Export CSV lorsque l'équipe a besoin d'une analyse de feuille de calcul.
Résultat attendu : Le CSV contient la plage de dates et les statistiques sélectionnées.
6
Transformez les résultats en changements
Mettez à jour les instructions du robot, les connaissances, les paramètres des widgets ou la couverture d'assistance en fonction des données.
Résultat attendu : Les analyses conduisent à des améliorations concrètes des produits.
Comment le tester : Exportez une petite date personnalisée CSV et vérifiez que la plage de dates et les métriques correspondent à ce qu'affiche le tableau de bord.
Problème
Corriger
Les statistiques semblent trop élevées
Vérifiez si la préparation/le test conversations sont inclus dans la plage de dates sélectionnée.
La satisfaction est vide
Activez les évaluations dans les paramètres du widget et attendez que les visiteurs laissent des évaluations.
Les minutes vocales ne correspondent pas aux attentes
Confirmez que le mode vocal est activé uniquement sur les robots prévus.
Que faire ensuite : Planifiez des rapports par e-mail pour une visibilité récurrente.
Rapports
Configurer des rapports par e-mail récurrents et tester la livraison
A quoi ça sert : Utilisez-le lorsque les propriétaires, les gestionnaires ou les clients ont besoin de résumés automatiques des performances.
Avant de commencer
Décidez qui doit recevoir les rapports.
Utilisez des adresses e-mail vérifiées.
Choisissez une cadence qui correspond aux rythmes des évaluations commerciales.
1
Ouvrez Paramètres, puis Rapports
Accédez à Paramètres et sélectionnez l'onglet Rapports, ou utilisez la redirection Rapports si disponible.
Résultat attendu : La cadence des rapports, les destinataires et l'historique sont visibles.
2
Choisissez la cadence
Activez les rapports quotidiens, hebdomadaires ou mensuels.
Résultat attendu : La planification du rapport est stockée pour l'espace de travail.
3
Ajouter des destinataires
Saisissez les adresses e-mail qui doivent recevoir les rapports.
Résultat attendu : Les rapports sont envoyés aux bonnes parties prenantes.
4
Envoyer un rapport instantané
Cliquez sur Envoyer maintenant ou sur une action de rapport instantané équivalente.
Résultat attendu : Un e-mail de rapport est envoyé immédiatement pour vérification.
5
Vérifier l'historique du rapport
Vérifiez le panneau d'historique après l'envoi des rapports.
Résultat attendu : Vous pouvez confirmer l’état et le calendrier de livraison.
Comment le tester : Envoyez un rapport instantané à un destinataire du test et confirmez la réception et le formatage.
Problème
Corriger
L'e-mail de rapport n'arrive pas
Vérifiez l'orthographe du destinataire, le dossier spam et l'état de l'historique des rapports.
Les mauvaises personnes reçoivent des rapports
Mettez à jour les destinataires et enregistrez avant le prochain envoi programmé.
Le contenu du rapport semble bruyant
Ajustez les attentes en matière de plage de dates et utilisez Analytics pour un examen manuel plus approfondi.
Que faire ensuite : Utilisez la cadence des rapports comme rythme de fonctionnement pour les améliorations des robots.
Démarrez ou mettez à niveau des plans, gérez le portail de facturation, invitez des coéquipiers, définissez des rôles, modifiez le profil/la langue, configurez les notifications, activez 2FA, utilisez les actions de zone de danger et exécutez le flux de travail d'affiliation.
/facturationContrôles des forfaits et de la facturation
1Examinez le plan actuel, l’état de l’essai et les limites usage.
2Comparez les fonctionnalités du forfait avant de procéder à la mise à niveau.
3Ouvrez le portail de facturation pour les factures, les modes de paiement, l'annulation ou la réactivation.
/paramètresParamètres, équipe et sécurité
1Utilisez Général pour le profil et la langue.
2Utilisez Team pour les invitations et les rôles.
3Utilisez la sécurité pour les clés 2FA, API et les actions dans les zones dangereuses.
/affiliéContrôles du programme d'affiliation
1Rejoignez le programme pour créer un lien de parrainage.
2Copiez le lien de parrainage pour les campagnes.
3Définissez l'e-mail de paiement et demandez des paiements éligibles.
Facturation
Démarrer, mettre à niveau, annuler ou réactiver un forfait
A quoi ça sert : Utilisez-le lorsque l'espace de travail nécessite une activation d'essai, des limites supplémentaires, des factures, des mises à jour de paiement ou des modifications d'abonnement.
Avant de commencer
Le propriétaire du compte ou l'administrateur de facturation doit effectuer des actions de facturation.
Confirmez quelles fonctionnalités sont planifiées : voix, voix clonées, avatars personnalisés, API, équipe, CRM et canaux.
Utilisez le portail de facturation sécurisé pour les modifications de mode de paiement et de facture.
1
Facturation ouverte
Cliquez sur Facturation dans la barre latérale.
Résultat attendu : Le plan actuel, l'état de l'essai, les limites usage et les cartes de plan sont visibles.
2
Comparez les forfaits
Passez en revue chat, voix, équipe, API, avatar, intégration, planification et limites de support.
Résultat attendu : Vous savez quel plan débloque la fonctionnalité nécessaire.
3
Choisir l'intervalle de facturation
Sélectionnez mensuel ou annuel si la bascule est disponible.
Résultat attendu : Mise à jour des prix et des économies pour l'intervalle sélectionné.
4
Mettre à niveau ou commencer le paiement
Choisissez le plan souhaité et finalisez le paiement.
Résultat attendu : L'abonnement devient actif après confirmation du paiement.
5
Portail client ouvert
Utilisez le portail de facturation pour le mode de paiement, les factures, l'annulation ou la réactivation.
Résultat attendu : Les actions de facturation sensibles ont lieu dans le portail sécurisé du fournisseur.
6
Vérifier l'accès aux fonctionnalités
Revenez à la fonctionnalité qui a été verrouillée et rechargez l'application.
Résultat attendu : La fonctionnalité déverrouillée est désormais disponible si le forfait l'inclut.
Comment le tester : Après la mise à niveau, ouvrez la fonctionnalité précédemment verrouillée, telle que le clonage vocal ou les touches API, et confirmez que le verrouillage a disparu.
Problème
Corriger
La fonctionnalité reste verrouillée après la mise à niveau
Actualisez l'application, attendez un instant la synchronisation de l'abonnement, puis vérifiez à nouveau la facturation.
Le paiement a été annulé
Revenez à Facturation et recommencez le paiement ; aucun changement de plan ne se produit après un paiement annulé.
Besoin d'un changement de facture ou de carte
Ouvrez le portail client au lieu de modifier les détails de paiement dans l'application.
Que faire ensuite : Invitez des coéquipiers et sécurisez le compte propriétaire.
Équipe et sécurité
Invitez des coéquipiers, définissez des rôles, modifiez le profil, activez 2FA et gérez les paramètres
A quoi ça sert : Utilisez-le lorsque l’espace de travail passe d’une configuration solo à une opération en équipe.
Avant de commencer
Connaissez le rôle de chaque coéquipier avant d’envoyer des invitations.
Utilisez l'accès avec le moindre privilège : propriétaire, administrateur, éditeur, visualiseur.
Préparez une application d’authentification pour 2FA.
1
Ouvrir les paramètres
Cliquez sur Paramètres dans la barre latérale.
Résultat attendu : Les onglets Général, Notifications, Équipe, Rapports, Développeurs, Sécurité et associés sont visibles.
2
Modifier le profil et la langue
Mettez à jour le nom d’affichage, les informations de profil et la langue préférée en général.
Résultat attendu : L'application identifie correctement l'utilisateur et utilise la langue choisie lorsqu'elle est disponible.
3
Inviter les membres de l'équipe
Ouvrez Team, saisissez un e-mail, choisissez un rôle et envoyez l'invitation.
Résultat attendu : Le coéquipier reçoit un lien d'invitation et apparaît comme en attente jusqu'à son acceptation.
4
Définir les autorisations de rôle
Utilisez Propriétaire pour un contrôle total, Administrateur pour la gestion, Éditeur pour les modifications de contenu et Visionneuse pour un accès en lecture seule.
Résultat attendu : Chaque utilisateur dispose d'un accès adapté à sa responsabilité.
5
Configurer les notifications
Choisissez les notifications par e-mail, navigateur, push, assistance en direct, facturation et rapport.
Résultat attendu : Les bonnes personnes reçoivent des alertes sans bruit inutile.
6
Activer 2FA
Ouvrez la sécurité, activez l'authentification à deux facteurs, scannez le code et stockez les détails de récupération.
Résultat attendu : Le compte nécessite un deuxième facteur après la connexion par mot de passe.
7
Utilisez les actions dans les zones dangereuses avec prudence
Exportez les données nécessaires et confirmez les widgets/intégrations actifs avant les actions destructrices du compte.
Résultat attendu : L'espace de travail évite la perte accidentelle de données.
Comment le tester : Invitez un coéquipier de test, acceptez l'invitation dans un navigateur distinct et confirmez que le rôle expose uniquement les fonctionnalités prévues.
Problème
Corriger
E-mail d'invitation manquant
Vérifiez le spam, renvoyez l'invitation et vérifiez l'adresse.
Un coéquipier voit trop de choses
Réduisez leur rôle et examinez les paramètres d’accès aux robots.
La configuration 2FA échoue
Vérifiez l'heure de l'appareil, scannez à nouveau le code QR et stockez les détails de récupération avant de vous y fier.
Que faire ensuite : Configurez les clés API uniquement pour les utilisateurs et les services qui en ont besoin.
Affilié
Rejoignez l'affilié, copiez le lien de parrainage, définissez l'e-mail de paiement et demandez le paiement
A quoi ça sert : Utilisez-le lorsqu'un partenaire ou un client souhaite parrainer de nouveaux utilisateurs sem.chat et suivre l'activité des commissions.
Avant de commencer
Utilisez le compte qui doit posséder l'attribution de référence.
Préparez l'e-mail de paiement avant de demander le paiement.
Vérifiez les règles du programme avant de publier des campagnes de parrainage.
1
Affilié ouvert
Cliquez sur Affilier dans la barre latérale ou ouvrez l'onglet d'affiliation dans Paramètres s'il y est lié.
Résultat attendu : La page du programme d'affiliation affiche les zones d'adhésion, de parrainage, de paiement et d'historique.
2
Rejoignez le programme
Cliquez sur Rejoindre si le compte n'a pas encore rejoint.
Résultat attendu : Un code de parrainage et un lien de parrainage sont créés.
3
Copier le lien de parrainage
Copiez le lien unique et utilisez-le dans le contenu, les campagnes ou les messages des partenaires.
Résultat attendu : Les inscriptions via le lien peuvent être attribuées au compte affilié.
4
Définir l'e-mail de paiement
Saisissez l'e-mail de paiement et enregistrez-le.
Résultat attendu : Les paiements éligibles peuvent être acheminés correctement.
5
Examiner les références et les commissions
Vérifiez la liste de références, le statut des commissions et l’historique des paiements.
Résultat attendu : Vous savez ce qui est en attente, éligible ou déjà payé.
6
Demander un paiement
Cliquez sur Demander un paiement lorsque les règles et les minimums du programme sont respectés.
Résultat attendu : La demande de paiement est enregistrée pour traitement.
Comment le tester : Ouvrez le lien de parrainage dans un navigateur privé et confirmez qu'il atterrit sur le flux d'inscription attendu avec le suivi des parrainages.
Problème
Corriger
Le lien de parrainage est manquant
Rejoignez d'abord le programme ou actualisez la page d'affiliation après votre adhésion.
Demande de paiement indisponible
Vérifiez le seuil de paiement minimum, l'état de la commission éligible et l'e-mail de paiement.
Référence non attribuée
Confirmez que le visiteur a utilisé le lien de parrainage exact et n'a pas supprimé les paramètres de suivi.
Que faire ensuite : Utilisez Analytics et Reports pour surveiller l’impact sur les clients référés, le cas échéant.
12
Notifications et App Updates
Consultez les alertes, marquez les notifications comme lues, filtrez les événements importants et utilisez les mises à jour des applications pour comprendre les nouvelles modifications apportées aux produits.
/notificationsCentre de notifications
1Utilisez Marquer tout comme lu après avoir examiné les alertes non lues.
2Filtrez par événements non lus, de facturation, d'assistance en direct ou système.
3Ouvrez la fonctionnalité associée après avoir lu l'alerte.
/mises à jour de l'applicationFlux de mises à jour d'applications
1Lisez les notes de version pour connaître les nouvelles fonctionnalités et les correctifs.
2Utilisez les détails pour former vos coéquipiers avant les modifications du flux de travail.
3Vérifiez les mises à jour après avoir remarqué des changements dans l'interface utilisateur ou dans le comportement.
Notifications
Examiner les notifications et réagir aux alertes
A quoi ça sert : Utilisez-le lorsque l'application signale des transferts, l'état de facturation, des événements système, la livraison de rapports ou une activité importante dans l'espace de travail.
Avant de commencer
Assurez-vous que les préférences de notification sont définies dans Paramètres.
Bénéficiez d’une couverture d’assistance en direct si les alertes de transfert sont activées.
Examinez les alertes non lues avant de les marquer comme lues.
1
Ouvrir les notifications
Cliquez sur Notifications dans la barre latérale ou dans l’entrée de notification de l’en-tête de l’application.
Résultat attendu : Le centre de notification répertorie les alertes récentes.
2
Filtrer les alertes
Utilisez des filtres non lus ou de catégorie pour vous concentrer sur la facturation, l'assistance en direct, les robots, les rapports ou les événements système.
Résultat attendu : Seules les alertes correspondantes restent visibles.
3
Ouvrir la page correspondante
Cliquez sur l'alerte ou utilisez son contexte pour ouvrir Billing, Live Support, Reports ou le bot concerné.
Résultat attendu : Vous agissez sur la notification plutôt que de simplement la lire.
4
Marquer comme lu
Marquez une seule alerte comme lue ou utilisez Marquer toutes les lectures après examen.
Résultat attendu : Le nombre de baisses de nombres non lus et les éléments examinés ne sont plus mis en évidence.
5
Ajuster les préférences
Ouvrez Paramètres, Notifications si trop ou trop peu d’alertes arrivent.
Résultat attendu : Le flux de notification correspond aux besoins de l'équipe.
Comment le tester : Créez un événement de test sécurisé tel qu'une demande d'assistance en direct ou un rapport instantané, puis confirmez que la notification apparaît et peut être marquée comme lue.
Problème
Corriger
Aucune notification n'arrive
Vérifiez les préférences de notification des paramètres, l'autorisation du navigateur et si l'événement s'est réellement produit.
Trop d'alertes
Désactivez les catégories bruyantes ou envoyez-les uniquement aux membres responsables de l’équipe.
Le nombre de non lus semble bloqué
Actualisez l'application après avoir marqué tous les éléments lus et confirmez que les filtres ne masquent pas les éléments non lus.
Que faire ensuite : Consultez App Updates lorsque le comportement change ou que de nouveaux contrôles apparaissent.
Mises à jour de l'application
Utiliser les mises à jour de l'application pour comprendre les modifications apportées aux produits
A quoi ça sert : Utilisez-le lorsque vos coéquipiers ont besoin de savoir ce qui a changé avant d'utiliser une nouvelle fonctionnalité.
Avant de commencer
Ouvrez les mises à jour après les versions majeures ou lorsque l'interface utilisateur change.
Partagez des notes de mise à jour pertinentes avec les utilisateurs du support et des ventes.
Testez à nouveau les flux de travail critiques après des changements majeurs.
1
Ouvrez App Updates
Cliquez sur App Updates dans la barre latérale.
Résultat attendu : Le flux de mise à jour affiche les nouvelles fonctionnalités, les correctifs et les notes de version.
2
Lire la dernière mise à jour
Ouvrez la carte de mise à jour ou la vue détaillée la plus récente.
Résultat attendu : Vous voyez ce qui a changé et quel flux de travail cela affecte.
3
Mappez le changement sur votre flux de travail
Identifiez si la mise à jour affecte les robots, les widgets, le support, la planification, la facturation ou les développeurs.
Résultat attendu : Les bons membres de l’équipe savent quoi vérifier.
4
Retester les chemins critiques
Si la mise à jour affecte un flux de production, répétez les étapes manuelles pertinentes de cette documentation.
Résultat attendu : L'équipe confirme que le flux de travail modifié fonctionne toujours.
5
Partager en interne
Envoyez le résumé de la mise à jour aux utilisateurs propriétaires de la zone concernée.
Résultat attendu : L'adoption par l'équipe est plus fluide et les questions d'assistance diminuent.
Comment le tester : Après une mise à jour pertinente, répétez le guide pour la fonctionnalité concernée et confirmez que les captures d'écran ou les noms d'étape correspondent toujours.
Problème
Corriger
La mise à jour mentionne une fonctionnalité verrouillée
Ouvrez Facturation pour confirmer si le forfait actuel l'inclut.
L'équipe a raté un changement
Ajoutez la révision App Updates aux routines de version ou d’opérations hebdomadaires.
La documentation semble obsolète après une mise à jour
Utilisez le Guide de l'ingénieur pour mettre à jour les captures d'écran et les étapes.
Que faire ensuite : Maintenez la documentation publique à jour à mesure que les fonctionnalités évoluent.
13
Recettes de développeur
Générez des clés API, utilisez l'authentification x-api-key, appelez des points de terminaison basés sur des actions, reliez la prise en charge en direct à un CRM, enregistrez des webhooks, vérifiez les signatures et intégrez le widget dans le code.
Paramètres / DéveloppeursTouches API, démarrage rapide et onglets usage
1Générez et révoquez les clés API à partir de l'onglet Clés API.
2Utilisez Quick Start pour les premiers exemples de boucles.
3Vérifiez l'utilisation avant d'activer l'automatisation à grand volume.
API démarrage rapide
Générez une clé API et effectuez les premiers appels API
A quoi ça sert : Utilisez-le pour les scripts de reporting, les applications personnalisées, les ponts CRM, l'assistance externe en direct ou l'automatisation.
Avant de commencer
Utilisez un environnement côté serveur. N'exposez pas les clés API dans le navigateur JavaScript.
Générez une clé distincte pour chaque intégration.
Copiez la clé immédiatement car les secrets sont affichés une fois.
1
Développeurs ouverts
Ouvrez Paramètres et sélectionnez Développeurs, ou utilisez la redirection Développeurs si disponible.
Résultat attendu : Les onglets API Clés, Quick Start, Documentation et Utilisation sont visibles.
2
Générer une clé
Cliquez sur Générer une clé, attribuez-lui une étiquette claire et copiez-la immédiatement.
Résultat attendu : La clé commence par sk_live_ et est disponible pour les requêtes côté serveur.
3
Envoyer l'en-tête x-api-key
Incluez x-api-key dans chaque demande publique API.
Résultat attendu : Le public API peut authentifier la demande et l'étendre au propriétaire.
4
Répertorier les robots
Appelez action=list-bots pour trouver l’ID de bot dont vous avez besoin.
Résultat attendu : La réponse renvoie les ID de bot, les noms, l'état actif et le résumé de la configuration.
5
Envoyer un message chat
POST action chat avec botId et message.
Résultat attendu : La réponse renvoie les informations de réponse, de modèle et usage.
6
Vérifiez usage
Appelez action=usage avant d’exécuter des tâches à volume élevé.
Résultat attendu : Vous connaissez le plan actuel et l'état usage avant l'exécution de l'automatisation.
7
Faites pivoter les clés si nécessaire
Révoquez les clés inutilisées et générez-en de nouvelles pour les fournisseurs ou services modifiés.
Résultat attendu : Les anciens services ne peuvent pas continuer à utiliser des informations d'identification obsolètes.
Comment le tester : Exécutez list-bots et chat à partir d'un terminal ou d'un serveur local, puis confirmez que la conversation apparaît dans Chat History si chat a été envoyé.
Problème
Corriger
401 ou réponse non autorisée
Vérifiez l'orthographe de x-api-key, copiez la clé complète et confirmez qu'elle n'a pas été révoquée.
Bot introuvable
Utilisez à nouveau list-bots et confirmez que le bot appartient au propriétaire de la clé API.
Problème CORS du navigateur
Déplacez l'appel API vers votre backend ; Les clés API sont destinées à une utilisation côté serveur.
Que faire ensuite : Utilisez /api-docs pour une référence ciblée sur les points de terminaison et conservez cette page comme guide de flux de travail.
Répertorier les robots
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
-H "x-api-key: sk_live_your_key_here"
Envoyer un message chat
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
-H "x-api-key: sk_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"action": "chat",
"botId": "YOUR_BOT_ID",
"message": "What can you help me with?"
}'
Pont CRM avec assistance en direct
Sondez ou envoyez des demandes d'assistance en direct dans un CRM
A quoi ça sert : Utilisez-le lorsque les agents travaillent dans un autre système mais que sem.chat reçoit la conversation du visiteur.
Avant de commencer
Créez une clé API dédiée nommée pour le pont CRM.
Décidez si les sondages ou les webhooks conviennent à votre infrastructure.
Assurez-vous que CRM stocke les identifiants de conversation pour les réponses/résolutions futures.
1
Liste des transferts en attente
GET action=live-support-list avec status=requested ou status=all.
Résultat attendu : Le CRM reçoit un conversations ouvert nécessitant une attention humaine.
2
Récupérer des messages
GET action=live-support-messages avec conversationId.
Résultat attendu : Le CRM contient le contexte complet du fil de discussion et les détails du visiteur.
3
Réclamation avant de répondre
POST action=live-support-claim.
Résultat attendu : sem.chat marque la conversation comme étant activement gérée.
4
Envoyer la réponse de l'agent
POST action=live-support-reply avec conversationId, message et agentName.
Résultat attendu : Le visiteur reçoit la réponse humaine et le fil de discussion est mis à jour.
5
Résoudre ou rendre
POST action=live-support-resolve avec résolution de résolution ou retour.
Résultat attendu : La conversation quitte la file d’attente ou l’IA reprend le contrôle.
6
État du journal dans CRM
Stockez le dernier statut de transfert, l’ID du message et les horodatages.
Résultat attendu : CRM et sem.chat restent auditables.
Comment le tester : Créez un transfert sécurisé, mettez-le en miroir sur CRM, répondez depuis le pont et confirmez les mises à jour du fil de discussion des visiteurs.
Problème
Corriger
Billets CRM en double
Utilisez conversationId comme clé d'idempotence dans votre pont CRM.
Les réponses arrivent dans le désordre
Stockez les horodatages des messages et évitez les réponses simultanées de plusieurs systèmes.
L'IA répond pendant que l'agent travaille
Réclamez d'abord le transfert et ne le restituez que lorsque l'agent a terminé.
Que faire ensuite : Enregistrez des webhooks si l'interrogation est trop lente ou trop coûteuse.
Webhooks
Enregistrez les webhooks et vérifiez X-SemChat-Signature
A quoi ça sert : Utilisez-le lorsque votre système a besoin d'événements en temps réel pour les transferts, les messages et les mises à jour de résolution.
Avant de commencer
Le webhook URL doit être HTTPS et accessible depuis l'Internet public.
Stockez immédiatement le secret du webhook ; il est affiché une fois.
Vérifiez les signatures avant de traiter les événements.
1
Enregistrez le webhook
POST action webhook-register avec URL et événements.
Résultat attendu : La réponse comprend les détails du webhook et un secret de signature unique.
2
Gardez le secret
Enregistrez le secret dans votre environnement de serveur ou dans votre gestionnaire de secrets.
Résultat attendu : Les livraisons futures peuvent être vérifiées.
3
Vérifier la signature
Lisez X-SemChat-Signature et comparez-le à un HMAC SHA-256 sur le corps brut de la requête.
Résultat attendu : Seules les livraisons sem.chat authentiques sont acceptées.
4
Gérer les tentatives de manière idempotente
Utilisez l’ID d’événement ou l’ID de conversation/message pour éviter un traitement en double.
Résultat attendu : Les nouvelles tentatives ne créent pas d'enregistrements CRM en double.
5
Répertorier les webhooks
GET action webhook-list pour auditer les points de terminaison configurés.
Résultat attendu : Vous pouvez voir les URL, les événements, l'état activé et l'état de livraison récent.
6
Supprimer les webhooks obsolètes
POST action webhook-delete avec ID de webhook.
Résultat attendu : Les anciens points de terminaison ne reçoivent plus d’événements.
Comment le tester : Enregistrez un point de terminaison de test, déclenchez un événement de support en direct, vérifiez la signature et confirmez que votre gestionnaire renvoie 2xx.
Problème
Corriger
La signature ne correspond pas
Utilisez le corps brut, non analysé JSON, et confirmez le bon secret du webhook.
Le Webhook ne reçoit aucun événement
Confirmez que la liste des événements inclut l'événement que vous testez et que le point de terminaison est HTTPS.
Le webhook expire
Reconnaissez rapidement et traitez les longs travaux de manière asynchrone.
Que faire ensuite : Reliez les ingénieurs à /api-docs pour obtenir des détails et des exemples sur les points finaux.
Utilisez correctement le API public basé sur l'action
A quoi ça sert : Utilisez-le lorsque vous choisissez la bonne action pour une fonctionnalité.
Avant de commencer
Chaque requête utilise la même fonction d'API publique URL.
Les actions GET utilisent des paramètres de requête. Les actions POST utilisent le corps JSON.
Envoyez x-api-key sur toutes les demandes.
Comment le tester : Appelez usage et list-bots comme test de fumée après tout changement de clé ou de point de terminaison API.
Problème
Corriger
Inadéquation des méthodes
Utilisez la méthode indiquée dans le tableau des points de terminaison. Certaines actions sont uniquement GET ou POST.
Valeur requise manquante
Vérifiez botId, conversationId, l'identifiant du webhook et l'orthographe de l'action.
Que faire ensuite : Utilisez Quick Start pour les premières requêtes, puis /api-docs pour la référence complète.
Méthode
Action
Objectif
GET
list-bots
Répertoriez tous les robots disponibles pour le propriétaire de la clé API.
GET
get-bot
Récupérez une configuration de bot par ID de bot.
POST
chat
Envoyez un message de visiteur à un bot et renvoyez la réponse de l'IA.
GET
conversations
Répertoriez les conversations récents pour un bot, jusqu'à 100 enregistrements.
GET
usage
Plan de retour, crédits, nombre de robots, conversations et API clé usage.
GET
live-support-list
Liste conversations en attente ou gérée par un agent humain.
GET
live-support-messages
Récupérez un fil de transfert avec des messages et des informations sur les visiteurs.
POST
live-support-reply
Envoyez une réponse humain-agent depuis un système externe.
POST
live-support-claim
Réclamez une conversation de transfert en attente.
POST
live-support-resolve
Résolvez le transfert ou remettez le contrôle à l’IA.
POST
webhook-register
Enregistrez un point de terminaison de webhook HTTPS.
GET
webhook-list
Répertoriez les enregistrements de webhooks sans renvoyer de secrets.
POST
webhook-delete
Supprimez un enregistrement de webhook par ID.
14
Guide de l'ingénieur : ajouter des fonctionnalités
Ajoutez des itinéraires, une navigation dans le tableau de bord, des paramètres de création de robots, des tables/fonctions/migrations Supabase, des documents API, une documentation publique, des contrôles SEO et une vérification locale.
Flux de travail des fonctionnalités de l'application
Ajouter un itinéraire d'application, une page, un élément de navigation et une entrée de documentation
A quoi ça sert : Utilisez-le lors de l’ajout d’une nouvelle fonctionnalité de tableau de bord destiné aux clients.
Avant de commencer
Créez une branche avant de modifier.
Identifiez si la fonctionnalité appartient au dépôt d'application ou au dépôt frontal public sem.chat.
Inspectez les modèles d'itinéraire, de barre latérale, d'i18n et de paramètres existants avant d'ajouter une nouvelle structure.
1
Ajouter l'itinéraire
Mettez à jour src/App.tsx avec une route protégée pour les pages clients, ou une route publique uniquement lorsque la page doit être publique.
Résultat attendu : Le URL se résout dans l'application sans appuyer sur NotFound.
2
Créer ou mettre à jour le composant de page
Utilisez les modèles de page existants, le chargement des données, les états vides, les états de chargement et les autorisations.
Résultat attendu : La fonctionnalité se comporte de manière cohérente avec le tableau de bord.
3
Ajouter la navigation dans le tableau de bord
Mettez à jour la source de la barre latérale/de navigation avec l'étiquette, l'icône, l'itinéraire et les portes du plan si nécessaire.
Résultat attendu : Les utilisateurs peuvent découvrir la nouvelle page depuis le shell de l'application.
4
Ajouter un onglet ou un paramètre de création de robots
Si la fonctionnalité appartient à un bot, ajoutez-la dans les onglets Bot Builder et conservez-la dans les flux de sauvegarde existants.
Résultat attendu : La configuration spécifique au bot est enregistrée avec le bot, et non bloquée dans l'état local.
5
Ajouter des modifications de schéma/fonction Supabase
Créez des migrations pour les tables/politiques et les fonctions Edge pour le travail côté serveur.
Résultat attendu : Le comportement de la base de données et du serveur peut être déployé de manière répétée.
6
Mettre à jour la forme API si elle est publique
Ajoutez ou étendez la gestion des actions dans supabase/functions/public-api/index.ts et documentez le comportement x-api-key.
Résultat attendu : Les intégrations peuvent utiliser la fonctionnalité en toute sécurité.
7
Mettre à jour les documents de l'application et la documentation publique
Mettez à jour les documents du développeur dans l'application et cette page /documentation avec des captures d'écran et des étapes clic par clic.
Résultat attendu : Les utilisateurs et les ingénieurs voient la fonctionnalité aux deux endroits.
8
Effectuer des contrôles
Exécutez des tests/construction d'applications, un optimiseur de référencement sur le site public, des vérifications du plan du site et une vérification du navigateur.
Résultat attendu : La fonctionnalité fonctionne localement et le site public reste explorable.
Comment le tester : Ouvrez la nouvelle route, utilisez la fonctionnalité de bout en bout, inspectez les erreurs de console/réseau et vérifiez toutes les modifications de la base de données à partir de l'interface utilisateur.
Problème
Corriger
L'itinéraire fonctionne mais le système de navigation ne met pas en évidence
Vérifiez la correspondance des itinéraires de la barre latérale et redirigez les chemins.
Les données fonctionnent localement mais ne sont pas déployées
Confirmez la migration, les politiques RLS et les variables d’environnement des fonctions Edge.
Documents publics manquants dans le plan du site
Exécutez l'optimiseur de référencement et inspectez sitemap.xml pour le URL canonique.
Que faire ensuite : Capturez ou régénérez des captures d'écran de la documentation chaque fois que l'interface utilisateur change.
Flux de travail de maintenance des documents
Mettre à jour cette page de documentation publique après les modifications du produit
A quoi ça sert : Utilisez-le lorsque les captures d'écran, les flux de travail, le comportement API ou la navigation changent.
Avant de commencer
Utilisez uniquement des données de démonstration sécurisées.
N'exposez jamais de vrais clients, e-mails, détails de paiement, clés API ou conversations privé.
Mettez d’abord à jour le manuel anglais, puis actualisez chaque page de documentation localisée avant les contrôles SEO.
1
Auditer l'itinéraire modifié
Ouvrez l'itinéraire de l'application et identifiez ce qui a changé visuellement et procéduralement.
Résultat attendu : Vous savez quelles lignes de guide, de capture d'écran et de dépannage nécessitent des modifications.
2
Capturer ou générer une capture d'écran sécurisée
Utilisez un espace de travail de démonstration et masquez les secrets avant d'enregistrer les ressources WebP sous ressources/documentation.
Résultat attendu : La capture d'écran est exacte et peut être publiée en toute sécurité.
3
Mettre à jour le guide
Modifiez les sections pertinentes À quoi cela sert, Avant de commencer, Étapes, Résultats attendus, Test, Dépannage et Suivant.
Résultat attendu : Le guide indique aux utilisateurs sur quoi cliquer et ce qui doit se passer après chaque clic.
4
Mettre à jour la navigation si nécessaire
Ajoutez la section à la table des matières collante, au sélecteur de section mobile et à l'index visuel s'il s'agit d'une page majeure.
Résultat attendu : Les lecteurs peuvent trouver rapidement le nouveau contenu.
5
Exécuter des outils de référencement
Exécutez node tools/seo-optimize-static-pages.js et node tools/seo-optimize-static-pages.js --check.
Résultat attendu : Les sorties canoniques, métadonnées, plan du site et robots restent correctes.
6
Exécuter des vérifications de nettoyage et de comparaison
Exécutez node tools/static-translation-cleanup.js --audit et git diff --check.
Résultat attendu : Les traductions statiques et les espaces sont propres.
7
Vérification du navigateur
Servir le site localement et tester/documenter sur ordinateur et mobile.
Résultat attendu : Les images se chargent, la recherche fonctionne, les boutons de copie fonctionnent, les surlignages de la table des matières et la mise en page ne chevauchent pas la bannière des cookies.
Comment le tester : Recherchez le nom de la fonctionnalité modifiée dans /documentation et confirmez que le bon bloc de guide apparaît.
Problème
Corriger
Les marqueurs de capture d'écran dérivent sur mobile
Conservez les marqueurs à l’intérieur de l’image de capture d’écran ou utilisez les coordonnées des marqueurs réactifs.
La recherche manque le nouveau guide
Ajoutez des mots-clés utiles au titre des données et incluez les termes de produits exacts recherchés par les utilisateurs.
La documentation localisée devient obsolète
Après avoir modifié le manuel anglais, actualisez chaque page de documentation localisée, relancez l’optimiseur SEO et vérifiez que sitemap.xml contient chaque URL de documentation.
Que faire ensuite : Validez ensemble les modifications de la page de documentation, des ressources, des liens d'en-tête/pied de page, du fichier .htaccess et du plan du site.
Besoin de la référence API ciblée ?
L'ancienne page /api-docs reste disponible pour les détails API au niveau du point de terminaison.