Tutoriel de configuration Livechat

Créer une authentification PAT dans la console développeur Livechat

Connectez-vous à la Console Développeur Livechat en utilisant le compte Agent LiveChat qui sera pris en charge par l'Agent IA, puis suivez ces étapes :

• Accédez à la page des paramètres, sélectionnez Jetons d'accès personnels, puis cliquez sur "Créer un nouveau jeton +"
  

• Créez le PAT, sélectionnez "tout sélectionner" pour les portées d'accès
  

• Copiez et enregistrez l'"ID de compte" et le "Jeton", qui seront nécessaires plus tard pour la configuration dans "GPTBots - Intégration Agent - Livechat".
  

Créer une application dans Livechat Créer une application pour recevoir et envoyer des messages sur la plateforme livechat.

• Rendez-vous sur la page "Applications" et cliquez sur le bouton "Créer une application" pour commencer la création
  

• Saisissez le nom de l'application, sélectionnez livechat pour Produit, puis cliquez sur "Créer l'application" pour la créer avec succès
  

• Cliquez sur l'application pour accéder à la page de détails, sélectionnez la page Blocs, puis cliquez sur le bouton "Ajouter des blocs de construction"
  

• Dans la fenêtre contextuelle "Ajouter des blocs de construction", sélectionnez l'option "Autorisation de l'application" puis cliquez sur "Ajouter un bloc"
  

• Sélectionnez l'option Application côté serveur puis cliquez sur le bouton "Enregistrer" pour la créer avec succès
  

• Copiez et enregistrez le "Client Id" et le "Client Secret", qui seront nécessaires plus tard pour la configuration dans "GPTBots - Intégration Agent - Livechat".
  

Configurer l'intégration Livechat dans GPTBots

• Sur la page "GPTBots - Paramètres Agent - Intégration - Livechat", configurez les informations sauvegardées puis cliquez sur le bouton "Soumettre" pour finaliser la configuration.

  • AgentEmail : Adresse e-mail du compte Agent LiveChat qui sera pris en charge par l'Agent IA. Cet agent doit être un compte de service client humain dans le même projet.
  • ID de compte : L'ID de compte obtenu lors de la création du PAT dans Livechat (pour le compte Agent LiveChat pris en charge par l'Agent IA).
  • Jeton : Le Jeton obtenu lors de la création du PAT dans Livechat (pour le compte Agent LiveChat pris en charge par l'Agent IA).
  • Client Id : Le Client Id obtenu lors de la création de l'application dans Livechat.
  • Client Secret : Le Client Secret obtenu lors de la création de l'application dans Livechat.

• Clé secrète : Saisissez une clé personnalisée de votre choix et enregistrez-la pour l'authentification du webhook.
  

• Après avoir complété la configuration "Intégration Livechat" dans GPTBots :

  • L'Agent IA prendra en charge la conversation utilisateur du compte AgentEmail, répondant directement aux questions des utilisateurs.
  • Selon les capacités de l'Agent IA, il peut prendre en charge l'entrée d'informations multimodales telles que texte, images et fichiers des utilisateurs.
  • La plateforme générera une adresse "Webhooks - URL de réception de messages et d'événements" qui pourra être utilisée pour créer un Webhook dans le back-office Livechat.

Configurer les webhooks de chat pour des fonctionnalités avancées comme le transfert/fermeture de chat

Créer les événements "incoming_event" et "incoming_chat"

• Retournez à la page Blocs, cliquez sur le bouton "Ajouter des blocs de construction" pour créer des webhooks
  

• Dans la fenêtre contextuelle, sélectionnez l'option "chat webhooks" (attention, il ne s'agit pas des webhooks d'application) puis cliquez sur l'option "Ajouter un bloc"
  

• Copiez l'adresse "GPTBots Webhook URL" dans "GPTBots - Configuration Agent - Intégration - Livechat"
  

• Configurez les options suivantes dans "Création du Chat Webhook" puis cliquez sur "Enregistrer" pour créer avec succès

  • Webhook URL : Renseignez dans la case l'adresse "GPTBots Webhook URL" copiée.
  • Clé secrète : Entrez la clé personnalisée enregistrée précédemment
  • Type : Sélectionnez l'option "Licence"
  • Déclencheurs du webhook : Sélectionnez les événements "incoming_event" et "incoming_chat" et cochez "chat_presence_user_ids"
    
    
    

Installer l'application et vérifier

• Rendez-vous sur la page "Installation privée" et cliquez sur le bouton "Installer l'application".
  

• Enfin, allez sur https://my.livechatinc.com/apps/settings/manage-apps/private pour vérifier si l'installation est terminée. S'il y a une marque d'installation, cela signifie que l'installation a réussi.
  

Configurer l'Agent Livechat

Sélectionnez "Équipe" - "Groupe" pour créer un nouveau groupe. Ajoutez le compte Agent LiveChat qui sera pris en charge par l'Agent IA à ce groupe. Ajoutez également un compte Agent LiveChat qui sera utilisé par le service client humain.

• Définissez le compte Agent LiveChat pris en charge par l'Agent IA comme : Agent principal.
• Définissez le compte Agent LiveChat utilisé par le service client humain comme : Agent de secours.
  

Fonctionnalités avancées de l'intégration Livechat

Paramétrage des TAG

Remarque : Après avoir activé cette fonctionnalité, le système surveillera tous les événements cibles du projet Livedesk et définira des TAGs, ce qui peut entraîner une consommation importante de crédits.
Une fois la configuration d'authentification Livechat terminée, la fonction "Paramétrage des TAG" peut être activée. La configuration spécifique est la suivante :

• Sélectionnez les scénarios de déclenchement : le système permet l'opération "Paramétrage des TAG" déclenchée par deux événements : "Fermeture de la conversation" et "Transfert de chat".
  • Fermeture de la conversation : Lorsque l'utilisateur ferme activement la conversation dans la fenêtre de chat Livechat.
  • Transfert de chat : Lorsque la conversation dans la fenêtre de chat Livechat est transférée à un autre compte de service client.
• TAG : Le système récupérera automatiquement la liste des TAGs déjà définis dans le projet Livechat.
  Lorsque le scénario de déclenchement sélectionné se produit, l'Agent IA choisira le TAG le plus approprié en fonction de l'historique de la conversation et appellera automatiquement l'API "Livechat TAG Setting" pour attribuer un TAG à la conversation. Cela aide le service client à identifier rapidement les besoins des utilisateurs et améliore l'efficacité opérationnelle.
  

Statut de réponse

Une fois la configuration d'authentification Livechat terminée, la fonction "Statut de réponse" peut être activée. Après activation, lorsqu'un utilisateur envoie un message dans la fenêtre de chat Livechat, il verra une "animation de réponse", ce qui améliore l'expérience utilisateur globale.

Formulaire pré-chat

Lorsque la fonction "Formulaire pré-chat" est activée dans le Widget Livechat, les utilisateurs seront invités à remplir un formulaire pré-chat après avoir envoyé un message dans la fenêtre de chat Livechat. Cela permet de collecter des informations sur l'utilisateur.
Une fois la fonction Formulaire pré-chat activée sur la page GPTBots - Paramètres - Intégrations - Livechat, l'Agent IA pourra recevoir les informations soumises par l'utilisateur dans le formulaire pré-chat. Ces informations seront utilisées comme contexte conversationnel, aidant l'Agent IA à mieux comprendre les besoins de l'utilisateur et à fournir des réponses plus précises.

Définir l'ID utilisateur

Lorsque les développeurs utilisent le Widget Livechat pour fournir des services aux utilisateurs du site web, ils peuvent réaliser la synchronisation de l'identité entre l'utilisateur Agent et l'utilisateur connecté du site en définissant un ID utilisateur. Lorsqu'un utilisateur du site est connecté, en appelant l'interface API fournie par le SDK LiveChat Widget pour définir l'ID utilisateur, cet ID utilisateur pourra alors être utilisé par l'Agent GPTBots. Cela aide l'Agent IA à identifier rapidement l'utilisateur, améliorant ainsi l'efficacité du service.

                      
                      LiveChatWidget.call("set_session_variables",{user_id: "your_user_id"});