Contrôle de réponse de l’agent de carte

  • Rversion finale: Xanadu
  • Mis à jour 29 juil. 2024
  • 8 minutes de lecture

    • Utilisez le contrôle de réponse de l’agent de carte dans une Agent virtuel rubrique pour charger et afficher les informations sélectionnées à partir d’un enregistrement sur votre instance, ainsi que le contenu enrichi, tel qu’une vidéo ou une image.

    Une carte peut contenir des informations d’enregistrement, une image ou un contenu vidéo YouTube au format compact. Le format compact est conçu pour être lisible dans la fenêtre de chat.

    La réponse de l’agent de carte peut afficher les types de contenu suivants :

    • Enregistrement : affiche le contenu d’un seul enregistrement sur votre instance. Cet enregistrement peut être référencé à partir de variables dans le flux ou interrogé à l’aide d’un script qui renvoie un seul enregistrement Glide à partir d’une table sélectionnée. Le contenu de l’enregistrement inclut le champ d’affichage de la table en haut de la carte, suivi de tous les autres champs spécifiés par les propriétés de la réponse de l’agent.
    • Image : affiche une grande ou une petite image que vous fournissez, ainsi qu’un titre et une description. La feuille de propriétés fournit un modèle préconfiguré pour la mise en page de la carte. Spécifiez le titre, la description et la source de l’image.
    • Vidéo YouTube : s’affiche dans un lecteur vidéo intégré si elle est prise en charge par la chaîne. L’image est affichée avec un titre, une description et un lien hypertexte vers le contenu pertinent.

      Dans la version, seules les Xanadu vidéos YouTube sont prises en charge.

      Conseil :
      Vous pouvez également utiliser le contrôle de réponse du bot vidéo pour inclure des vidéos YouTube dans des conversations. Le contrôle de réponse de l’agent vidéo comprend un bouton de navigation qui met la conversation en pause. Si vous souhaitez que l’utilisateur regarde la vidéo avant de poursuivre la conversation, utilisez ce bouton de navigation. Lorsque les utilisateurs ont fini de regarder la vidéo, ils peuvent cliquer sur ce bouton de navigation pour poursuivre la conversation.
    Remarque :
    Si vous avez déjà créé des conversations qui utilisent le contrôle de réponse de l’agent HTML pour générer des mises en page de carte, envisagez de mettre à jour vos conversations pour utiliser le contrôle de réponse de l’agent de carte. La carte affiche les informations d’un enregistrement dans votre instance et contient un lien vers cet enregistrement connexe. Il peut également afficher des images et inclure un contenu riche tel qu’une vidéo.

    Propriétés du contrôle de réponse de l’agent de carte

    Propriété Description
    Nom du nœud Nom qui identifie ce nœud de contrôle de réponse de l’agent de carte dans le flux de rubriques.
    Type de carte Type de carte à utiliser. Choisissez l’une des options suivantes :
    • Enregistrement
    • Grande image avec du texte
    • Petite image avec du texte
    • Carte vidéo YouTube
      Remarque :
      Dans cette version, seules les Xanadu cartes vidéo YouTube sont prises en charge.
    Type : Enregistrement
    Enregistrement Référence à un enregistrement spécifique. Les données de la carte proviennent d’un enregistrement référencé dans une variable d’un autre nœud du flux. Par exemple, la référence peut être une liste de choix ou une action Glide.
    1. Sélectionnez une variable dans le flux actuel qui contient un objet d’enregistrement.
    2. Utilisez la liste des champs pour déterminer les champs affichés dans la carte.
    Table Table qui fait référence à un seul enregistrement Glide qui contient les données affichées sur la carte.
    Filtrer cette table à l’aide de Entrez la condition ou le script pour filtrer les données dans la table et renvoyer l’enregistrement.
    • Condition : instruction de condition qui renvoie l’enregistrement de table.
    • Script : requête d’enregistrement Glide qui renvoie l’enregistrement Glide.
    champs

    Champs de l’enregistrement ServiceNow à afficher dans la carte. Spécifiez chaque champ en cliquant sur Ajouter un champ.

    Remarque :
    Si vous utilisez Workplace, quatre champs au maximum sont affichés sur la carte. Si vous avez plus de quatre champs, les champs restants s’affichent sur une carte suivante, avec jusqu’à quatre champs par carte.
    Type : grande image avec du texte ou petite image avec du texte
    Modèle Représentation visuelle qui montre la mise en page de la carte d’image. Chaque zone du modèle est numérotée.
    Mapper les données aux champs sur la carte Champs qui correspondent aux nombres indiqués sur le modèle. Ces champs sont les suivants :
    1. Titre : nom ou étiquette de la carte
    2. Description : Explication de l’image
    3. Lien vers l’URL de l’image : spécifiez l’image affichée dans la carte de l’une des façons suivantes :
      • Spécifiez l’URL de l’image à l’aide du champ de texte, de la pastille de données ou du script.
      • Chargez l’image en cliquant sur Charger l’image.

      Si vous chargez une image, l’image sélectionnée est téléchargée sur le serveur et est stockée dans la table Images [sys_db_image] et dans les ensembles de mises à jour. Lorsque l’image est stockée dans la table Images et les ensembles de mises à jour, vous pouvez l’utiliser dans une instance de production ou de non-production, selon les besoins.

      Une fois l’image téléchargée, le lien URL est inclus dans la feuille Propriétés de laréponse .

      Le lien vers une image téléchargée s’affiche dans la feuille de propriétés.

      Cliquez sur le lien pour afficher l’image.

      L’URL est générée dynamiquement. Le nom de l’instance est inséré au début du chemin de l’URL.

      Vous pouvez modifier ou supprimer le lien vers l’image. Si vous supprimez le lien de cette feuille de propriétés, seule la référence à l’URL est supprimée. L’image reste sur le serveur pour une utilisation ultérieure.

    4. Texte alt de l’image : Texte alternatif, lisible à l’écran, qui décrit l’image pour les programmes d’accessibilité. Ce texte est utilisé avec l’image. Saisissez le texte à l’aide du champ de texte, de la pastille de données ou du script.
    Type : carte vidéo YouTube
    Modèle Représentation visuelle de la mise en page de la vidéo incluse dans la carte.
    Mapper les données aux champs sur la carte Champs qui correspondent aux nombres indiqués sur le modèle. Ces champs sont les suivants :
    • Titre : titre de la carte.
    • Lien du titre : URL vers tout contenu pertinent.
    • Description : description de la carte, telle que le sujet abordé par la vidéo.
    • ID de la vidéo YouTube : identificateur unique de la vidéo utilisée dans la carte. Cet identifiant est la chaîne qui suit le signe égal (=) à la fin du chemin de l’URL de la vidéo.

      Par exemple, dans le chemin d’accès ci-dessous, l’identificateur de la vidéo est FVgtjdEOa5M.

      Dans l’www.youtube.com/watch?v=FVgtjdEOa5M URL, l’identificateur de la vidéo est FVgtjdEOa5M.

      Dans cette URL, l’identifiant de la vidéo est l’ID de la vidéo entre accolades.
    Avancés
    Masquer ce nœud
    Afficher conditionnellement ce nœud si

    Énoncé de condition no-code ou script low-code qui spécifie une condition de présentation de ce nœud dans la conversation. La condition doit être évaluée comme vraie.

    Prise en charge du canal

    Tableau 1. Prise en charge du canal pour le contrôle de réponse de l’agent de carte
    Canal Prise en charge Contraintes
    Interface utilisateur Web Pris en charge Aucun
    Interface utilisateur mobile Pris en charge Aucun
    Panneau Now Assist Prise en charge partielle Cartes d’enregistrement et cartes d’enregistrement avec action uniquement.
    Microsoft Teams Pris en charge Le contrôle vidéo affiche une image miniature de la vidéo que les utilisateurs sélectionnent pour ouvrir la vidéo dans leur navigateur Web préféré.
    Slack Pris en charge Intégration conversationnelle de Slack Version 2.0.0 et ultérieures.

    Le contrôle vidéo affiche une image miniature de la vidéo que les utilisateurs sélectionnent pour ouvrir la vidéo dans leur navigateur Web préféré.
    Workplace Prise en charge partielle La sortie de la carte d’image n’est pas disponible.

    Les applications Facebook ne prennent plus en charge les modèles de liste verticale. La mise en page de la carte utilise un modèle de carrousel horizontal et défilant à compter du 15 août 2019. Les cartes comportent également un modèle de bouton.
    Facebook Messenger Pris en charge Aucun
    SMS Twilio Pris en charge Enregistrements et cartes d’images uniquement.
    LINE Prise en charge partielle Enregistrements et cartes d’images uniquement.
    WhatsApp Prise en charge partielle Enregistrements et cartes d’images uniquement.
    Apple Messages for Business Pris en charge Aucun
    Alexa (Voix) Prise en charge partielle Certains types de sortie ne sont disponibles que sur les appareils dotés d’écrans. Pour les appareils sans écran, le titre de la carte est lu. Pour plus de détails, voir Affinez Agent virtuel les paramètres et les rubriques pour une expérience de messagerie vocale optimale Alexa.

    Exemple de requête d’enregistrement Glide

    (function execute(table) {
    /* Write a glide record query, and return the glide record.
       For example:
       
       var now_GR = new GlideRecord(table);
       gr.addEncodedQuery('active=true^number=INC0010099');
       gr.query();
       if(gr.next()) {
          return gr;
    }
    */
})(table)

    Dans cet exemple, le script crée un objet GlideRecord, remplit cet objet à l’aide d’une requête qui doit renvoyer un seul résultat, puis renvoie l’objet. La propriété Table définit la table utilisée dans cette requête.

    Exemple de sortie de réponse de l’agent de carte pour les enregistrements

    Remarque :
    Concepteur d'agent virtuel Les commandes peuvent s’afficher et fonctionner différemment dans d’autres canaux.
    Propriétés de réponse Sortie de carte
    Figure 1. Propriétés de base du contrôle de réponse de l’agent de carte
    Les propriétés de base incluent le nom du nœud, le type de carte, la façon dont la carte doit être renseignée (enregistrement ou table) et les champs à renvoyer.
    Figure 2. Sortie de la carte d’interface utilisateur Web
    Exemple de carte qui affiche l’incident et le numéro d’incident dans l’en-tête. Les champs affichés sont Catégorie, Description brève et État.
    Figure 3. Microsoft Teams Sortie de carte
    Exemple de carte tirée d’une Microsoft Teams conversation, affichant la conversation et l’heure de création dans l’en-tête. Les champs affichés comprennent le consommateur, le SysID, le type d’appareil, ainsi que la date et l’heure de création.

    Exemple de réponse de l’agent de carte pour une grande image

    La mise en page de la réponse de la carte pour les images peut varier selon les canaux.
    Propriétés de réponse Sortie de carte

    Les propriétés de base comprennent le nom du nœud, le type de carte, le modèle de carte, le titre, la description, le lien d’image et le texte alternatif de l’image.
    Figure 4. Sortie de la carte d’image de l’interface utilisateur Web
    Carte sur laquelle on peut lire : « N’oubliez pas que nous retournons bientôt au bureau ! » dans l’en-tête. Il comprend le jour de retour du calendrier de l’utilisateur et un lien d’image vers plus d’informations.
    Figure 5. Microsoft Teams Carte d’image d’interface utilisateur
    Microsoft Teams carte d’image, affichant le titre de l’en-tête Scène et la ligne d’espace réservé Description de la scène au-dessus de l’image.

    Exemple de réponse de l’agent de carte pour une petite image

    La mise en page de la réponse de la carte pour les images peut varier selon les canaux.

    Propriétés de réponse Sortie de carte
    Les propriétés de base incluent le nom du nœud, le type de carte, le modèle, le titre, la description, le lien d’image et le texte alternatif de l’image.
    Figure 6. Sortie de la carte d’image de l’interface utilisateur Web
    L’utilisateur demande : « Quand est-ce qu’on annonce les gains ? » Une carte est retournée avec un en-tête qui se lit comme suit : « Réservez la date - Appel sur les résultats du T1 ».

    Exemple de réponse de l’agent de carte avec contenu vidéo

    La façon dont la réponse de l’agent de carte affiche les vidéos peut varier d’un canal à l’autre. Par exemple, l’affichage Slack des messages peut être différent de celui affiché sur Microsoft Teams ou Workplace from Facebook. De plus, si un lecteur intégré est pris en charge sur ce canal, le lecteur est inclus dans l’écran. Pour en savoir plus sur les canaux, consultez la documentation du canal que vous utilisez.

    Propriétés de réponse Sortie de carte
    Les propriétés de base comprennent le nom du nœud, le type de carte, le modèle, le titre, le lien du titre, la description et l’ID de la vidéo YouTube.
    Figure 7. Sortie de réponse de l’agent de carte avec vidéo sur le client Web
    Carte sur laquelle on peut lire : « Découvrez notre nouvelle campagne de Noël ». La vidéo YouTube est intégrée en dessous et affiche le titre et la description liés.
    Figure 8. Sortie de réponse de l’agent de carte avec vidéo activée Microsoft Teams
    Exemple de carte vidéo, affichant le titre de l’en-tête, l’exemple de vidéo et la ligne d’espace Microsoft Teams réservé Exemple de vidéo Description ci-dessus Image d’aperçu.