Manuel visuel étape par étape

Documentation sem.chat

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
Capture réelle de l’espace de démonstration sem.chat
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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
L'e-mail de vérification n'arrive pasVé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 facturationL’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 travailInvitez-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èmeCorriger
Le code intégré n'est pas disponibleEnregistrez 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 botConfirmez que le data-bot-id dans l'extrait correspond à l'ID du bot du modal Embed.
Aucune conversation n'apparaît dans l'historiqueActualisez 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
Capture réelle de l’espace de démonstration sem.chat
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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
La réponse est trop génériqueAjoutez 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épondreSupprimez les instructions trop strictes et ajoutez des connaissances fiables sur ce sujet.
L'enregistrement ne génère pas de code d'intégrationVé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èmeCorriger
L'ancienne réponse apparaît toujoursActualisez 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 échoueConfirmez 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 erreurArrê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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
Le widget est manquantConfirmez 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îtCopiez à nouveau l'extrait et comparez le data-bot-id avec le bot souhaité.
Le widget chevauche les contrôles de pageModifiez 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.

HTML intégrer
<!-- sem.chat Voice & Text Widget -->
<script
  src="https://app.sem.chat/widget-v2.js?v=16"
  data-bot-id="YOUR_BOT_ID"
></script>
Installation de la plateforme

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èmeCorriger
React charge les widgets en doubleProtégez l'insertion du script avec une référence ou restituez le composant uniquement dans la disposition racine.
WordPress supprime les balises de scriptUtilisez un plugin d'injection de pied de page ou un fichier de thème autorisant les scripts.
L'appel SDK ne peut pas démarrerVé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.

WordPress extrait de pied de page
<!-- sem.chat Widget (WordPress Compatible) -->
<script>
window.SEMCHAT_CONFIG = { botId: "YOUR_BOT_ID" };
</script>
<script src="https://app.sem.chat/widget-v2.js?v=16"></script>
Composant React
import { useEffect, useRef } from 'react';

export function ChatWidget() {
  const loaded = useRef(false);

  useEffect(() => {
    if (loaded.current) return;
    loaded.current = true;

    const script = document.createElement('script');
    script.src = 'https://app.sem.chat/widget-v2.js?v=16';
    script.setAttribute('data-bot-id', 'YOUR_BOT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      const container = document.getElementById('semchat-widget-container');
      if (container) container.remove();
      script.remove();
    };
  }, []);

  return null;
}
Voix avancée SDK
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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
La couleur n'a pas été mise à jourEnregistrez le bot, actualisez le site Web et confirmez que le widget installé utilise le même ID de bot.
Les champs de prospects sont manquantsConfirmez 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 voixVé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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
Le navigateur bloque le microphoneAutorisez l’autorisation du microphone dans le navigateur et rechargez la page.
L'option vocale est verrouilléeOuvrez Facturation et confirmez que le plan d'espace de travail inclut des fonctionnalités vocales.
La transcription est videConfirmez 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èmeCorriger
La qualité du clone est médiocreEnregistrez 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 disponibleVérifiez la facturation pour connaître les limites d'avatar liées au plan.
La vieille voix joue toujoursEnregistrez 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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
Le robot importe les pages non pertinentesSupprimez ces pages des résultats sélectionnés et ajoutez des instructions manuelles plus claires.
Les prix des produits sont obsolètesActualisez le flux et confirmez que le flux URL lui-même contient les valeurs actuelles.
Le robot invente des réponsesAjoutez 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
Capture réelle de l’espace de démonstration sem.chat
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
Capture réelle de l’espace de démonstration sem.chat
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
Capture réelle de l’espace de démonstration sem.chat
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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
La réponse n'a pas pu être envoyéeVé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 incorrecteUtilisez 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éceptionRecherchez 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èmeCorriger
Les agents manquent des demandesActivez 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ôtAjustez 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èmeCorriger
Contact manquant dans les contactsConfirmez que la capture de leads est activée et que le visiteur a soumis le formulaire.
L'exportation est trop importanteAffinez la plage de dates ou le filtre du bot avant d’exporter.
Synchronisation SendPulse indisponibleConnectez 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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
Le jeton Telegram échoueCréez ou réinitialisez le jeton dans BotFather et collez-le à nouveau.
Les messages Slack n'arrivent pasVé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 échoueConfirmez que le compte Facebook/Instagram/WhatsApp dispose des autorisations d'administrateur et de l'accès professionnel requis.
La synchronisation SendPulse échoueReconnectez 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
Capture réelle de l’espace de démonstration sem.chat
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
Capture réelle de l’espace de démonstration sem.chat
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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
Aucune heure n'apparaît sur la page publiqueVé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 manquantVé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 payantVé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èmeCorriger
Un lien unique expose de mauvais emplacementsRé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 étroitePlacez l'intégration dans un conteneur de contenu plus large et vérifiez la disposition mobile.
Les analyses semblent videsCré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
Capture réelle de l’espace de démonstration sem.chat
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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
Les statistiques semblent trop élevéesVérifiez si la préparation/le test conversations sont inclus dans la plage de dates sélectionnée.
La satisfaction est videActivez les évaluations dans les paramètres du widget et attendez que les visiteurs laissent des évaluations.
Les minutes vocales ne correspondent pas aux attentesConfirmez 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èmeCorriger
L'e-mail de rapport n'arrive pasVérifiez l'orthographe du destinataire, le dossier spam et l'état de l'historique des rapports.
Les mauvaises personnes reçoivent des rapportsMettez à jour les destinataires et enregistrez avant le prochain envoi programmé.
Le contenu du rapport semble bruyantAjustez 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.

11

Facturation, équipe, sécurité, paramètres, affiliation

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
Capture réelle de l’espace de démonstration sem.chat
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é
Capture réelle de l’espace de démonstration sem.chat
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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
La fonctionnalité reste verrouillée après la mise à niveauActualisez 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 carteOuvrez 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èmeCorriger
E-mail d'invitation manquantVérifiez le spam, renvoyez l'invitation et vérifiez l'adresse.
Un coéquipier voit trop de chosesRéduisez leur rôle et examinez les paramètres d’accès aux robots.
La configuration 2FA échoueVé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èmeCorriger
Le lien de parrainage est manquantRejoignez d'abord le programme ou actualisez la page d'affiliation après votre adhésion.
Demande de paiement indisponibleVérifiez le seuil de paiement minimum, l'état de la commission éligible et l'e-mail de paiement.
Référence non attribuéeConfirmez 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
Capture réelle de l’espace de démonstration sem.chat
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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
Aucune notification n'arriveVé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'alertesDé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èmeCorriger
La mise à jour mentionne une fonctionnalité verrouilléeOuvrez Facturation pour confirmer si le forfait actuel l'inclut.
L'équipe a raté un changementAjoutez la révision App Updates aux routines de version ou d’opérations hebdomadaires.
La documentation semble obsolète après une mise à jourUtilisez 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
Capture réelle de l’espace de démonstration sem.chat
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èmeCorriger
401 ou réponse non autoriséeVérifiez l'orthographe de x-api-key, copiez la clé complète et confirmez qu'elle n'a pas été révoquée.
Bot introuvableUtilisez à nouveau list-bots et confirmez que le bot appartient au propriétaire de la clé API.
Problème CORS du navigateurDé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èmeCorriger
Billets CRM en doubleUtilisez conversationId comme clé d'idempotence dans votre pont CRM.
Les réponses arrivent dans le désordreStockez les horodatages des messages et évitez les réponses simultanées de plusieurs systèmes.
L'IA répond pendant que l'agent travailleRé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èmeCorriger
La signature ne correspond pasUtilisez le corps brut, non analysé JSON, et confirmez le bon secret du webhook.
Le Webhook ne reçoit aucun événementConfirmez que la liste des événements inclut l'événement que vous testez et que le point de terminaison est HTTPS.
Le webhook expireReconnaissez 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.

Enregistrer un webhook
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": "webhook-register",
    "url": "https://your-crm.example.com/semchat/webhook",
    "events": ["handoff.requested", "message.user", "handoff.resolved"]
  }'
Vérifier la signature du webhook
import crypto from 'node:crypto';

function verifySemChatSignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature || ''),
    Buffer.from(expected)
  );
}
Carte des points de terminaison

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èmeCorriger
Inadéquation des méthodesUtilisez la méthode indiquée dans le tableau des points de terminaison. Certaines actions sont uniquement GET ou POST.
Valeur requise manquanteVé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éthodeActionObjectif
GETlist-botsRépertoriez tous les robots disponibles pour le propriétaire de la clé API.
GETget-botRécupérez une configuration de bot par ID de bot.
POSTchatEnvoyez un message de visiteur à un bot et renvoyez la réponse de l'IA.
GETconversationsRépertoriez les conversations récents pour un bot, jusqu'à 100 enregistrements.
GETusagePlan de retour, crédits, nombre de robots, conversations et API clé usage.
GETlive-support-listListe conversations en attente ou gérée par un agent humain.
GETlive-support-messagesRécupérez un fil de transfert avec des messages et des informations sur les visiteurs.
POSTlive-support-replyEnvoyez une réponse humain-agent depuis un système externe.
POSTlive-support-claimRéclamez une conversation de transfert en attente.
POSTlive-support-resolveRésolvez le transfert ou remettez le contrôle à l’IA.
POSTwebhook-registerEnregistrez un point de terminaison de webhook HTTPS.
GETwebhook-listRépertoriez les enregistrements de webhooks sans renvoyer de secrets.
POSTwebhook-deleteSupprimez 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èmeCorriger
L'itinéraire fonctionne mais le système de navigation ne met pas en évidenceVé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éesConfirmez la migration, les politiques RLS et les variables d’environnement des fonctions Edge.
Documents publics manquants dans le plan du siteExé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èmeCorriger
Les marqueurs de capture d'écran dérivent sur mobileConservez 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 guideAjoutez 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èteAprè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.

Ouvrir API Docs