Contrôle de la réponse du bot de carte

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 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 du contenu enrichi, tel qu’une vidéo ou une image.

    Une carte peut contenir des informations d’enregistrement, une image ou du contenu vidéo YouTube dans un 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 d’une table sélectionnée. Le contenu de l’enregistrement comprend 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 en ligne si le canal est pris en charge. L’image est affichée avec un titre, une description et un lien hypertexte vers le contenu pertinent.

      Dans la version, seules les Zurich 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 les conversations. Le contrôle de réponse du bot vidéo inclut 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 cartes, envisagez de mettre à jour vos conversations pour utiliser le contrôle de réponse de l’agent de cartes. 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 du contenu riche tel qu’une vidéo.

    Propriétés du contrôle de la réponse du bot de carte

    Propriété Description
    Nom du nœud Nom qui identifie cette carte Nœud de contrôle de réponse bot 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 la version, seules les Zurich 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 du 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, un maximum de quatre champs est affiché sur la carte. Si vous avez plus de quatre champs, les champs restants sont affichés 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 affiche 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 : indiquez 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, celle-ci est téléchargée sur le serveur et 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 chargée, le lien URL est inclus dans la feuille Propriétés de laréponse .

      Le lien vers une image chargée est affiché 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 de titre : URL vers n’importe quel contenu pertinent.
    • Description : décrivez la carte, notamment le sujet abordé dans la vidéo.
    • ID de la vidéo YouTube : identificateur unique de la vidéo utilisée dans la carte. Cet identificateur 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 affiché ci-dessous, l’identificateur de la vidéo est FVgtjdEOa5M.

      Dans la 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

    Instruction de condition sans 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 du bot 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 Versions 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 Sortie de carte d’image non disponible.

    Les applications Facebook ne prennent plus en charge les modèles de listes verticales. La mise en page des cartes 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’image uniquement.
    LINE Prise en charge partielle Enregistrements et cartes d’image uniquement.
    WhatsApp Prise en charge partielle Enregistrements et cartes d’image 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 autres que l’é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 chat vocal 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 la réponse Sortie de carte
    Figure 1. Propriétés de base du contrôle de réponse du bot de carte
    Les propriétés de base comprennent 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 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 d’une conversation, affichant l’heure de conversation et de création dans l’en-tête Microsoft Teams . Les champs affichés comprennent Consommateur, SysID, Type d’appareil et Date et heure de création.

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

    La disposition de la réponse de la carte pour les images peut varier selon les canaux.
    Propriétés de la 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 de l’image et le texte alt de l’image.

    Figure 4. Sortie de carte d’image d’interface utilisateur Web
    Carte sur laquelle on peut lire : « N’oubliez pas que nous retournons bientôt au bureau ! » dans l’en-tête. Elle comprend le calendrier de l’utilisateur, le jour de retour et un lien d’image pour plus d’informations.
    Figure 5. Microsoft Teams Carte d’image d’interface utilisateur
    Microsoft Teams carte d’image, affichant le titre d’en-tête Paysage et la ligne d’espace réservé Description du paysage.

    Exemple de réponse du bot de carte pour une petite image

    La disposition de la réponse de la carte pour les images peut varier selon les canaux.

    Propriétés de la 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, la description, le lien de l’image et le texte alt de l’image.
    Figure 6. Sortie de carte d’image d’interface utilisateur Web
    L’utilisateur demande : « Quand annonçons-nous les résultats ? » Une carte est renvoyée avec un en-tête indiquant : « Save the date - Q1 Earnings Call ».

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

    La façon dont la réponse du bot de carte affiche les vidéos peut varier selon les canaux. Par exemple, l’affichage que vous voyez dans Slack les messages peut être différent de celui que vous voyez 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’affichage. Pour plus d’informations sur les canaux, consultez la documentation du canal que vous utilisez.

    Propriétés de la 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 de titre, la description et l’ID de la vidéo YouTube.
    Figure 7. Sortie de réponse du bot de carte avec vidéo sur le widget de messagerie instantanée
    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 du bot de carte avec vidéo activée Microsoft Teams
    Microsoft Teams carte vidéo, affichant le titre d’en-tête Exemple vidéo et la ligne d’espace réservé Description de l’exemple vidéo.