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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 du 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 messagerie instantanée.

    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 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 s’affiche avec un titre, une description et un lien hypertexte vers le contenu pertinent.

      Dans cette Washington DC version, seules les vidéos YouTube sont prises en charge.

      Conseil :
      Vous pouvez également utiliser le contrôle de réponse de l’agent vidéo pour inclure des vidéos YouTube dans les conversations. Le contrôle de réponse du bot 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 précédemment créé des conversations qui utilisent le contrôle de réponse du bot 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 du contenu riche tel qu’une vidéo.

    Propriétés du contrôle de la 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 Washington DC version, seules les 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 indiquées dans 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 montre la disposition de la carte image. Chaque zone du modèle est numérotée.
    Mapper les données aux champs sur la carte Champs qui correspondent aux nombres affiché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 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 feuillePropriétés de ré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 affiché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, comme le sujet abordé par la vidéo.
    • ID de 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 indiqué ci-dessous, l’identificateur vidéo est FVgtjdEOa5M.

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

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

    Déclaration 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 des canaux

    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 Conversational Integration with Slack Version 2.0.0 et versions 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 image n’est pas disponible.

    Les applications Facebook ne prennent plus en charge les modèles de listes verticales. La mise en page de la carte utilise un modèle de carrousel horizontal à faire défiler à 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 image uniquement.
    LINE Prise en charge partielle Enregistrements et cartes image uniquement.
    WhatsApp Prise en charge partielle Enregistrements et cartes 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 périphériques sans écran, le titre de la carte est lu. Pour plus de détails, voir Affiner Agent virtuel les paramètres et les rubriques pour une meilleure Alexa expérience de chat vocal.

    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, renseigne cet objet à l’aide d’une requête qui doit renvoyer un résultat unique, 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 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 indiquant l’incident et le numéro d’incident dans l’en-tête. Les champs affichés sont Catégorie, Brève description et État.

    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 de l’image et le texte alternatif de l’image.
    Figure 3. 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 jour de retour du calendrier de l’utilisateur et un lien d’image vers d’autres informations.

    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 de l’image et le texte alternatif de l’image.
    Figure 4. Sortie de carte d’image d’interface utilisateur Web
    L’utilisateur demande : « Quand est-ce qu’on annonce les gains ? » Une carte est retournée avec un en-tête sur lequel on peut lire : « Réservez la date - Appel sur les résultats du 1er trimestre ».

    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 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 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 5. Sortie de réponse du bot 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.