Contrôles enrichis d’entrée et de sortie par défaut pour une intégration de messagerie instantanée personnalisée

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture

    • Les contrôles enrichis d’entrée et de sortie doivent être mappés à votre intégration de messagerie instantanée personnalisée dans la table Configurations d’adaptateur personnalisé [sys_cs_custom_adapter_config]. Si une implémentation de transformateur sortant est manquante dans un contrôle enrichi, l’utilisateur final ne reçoit pas de réponse et l’expérience de messagerie instantanée risque de ne pas être satisfaisante.

    Les contrôles enrichis par défaut suivants sont mappés aux contrôles enrichis d’entrée et de sortie. Le uiType paramètre fait référence à un contrôle de rubrique utilisé pour créer des conversations dans Concepteur d'agent virtuel.

    Tableau 1. Contrôles enrichis d’entrée et de sortie par défaut
    Contrôle enrichi Description
    ActionRichControl Ce composant gère les différents événements et actions qui se produisent dans une conversation. Certaines actions peuvent ne pas s’appliquer à tous les canaux. Par exemple, StartSpinnerActionMsg est ignoré dans SMS.

    ServiceNow® Agent virtuel Produit les types suivants de messages d’action via ce cadre de travail. L’interface de messagerie instantanée personnalisée ne reconnaît que certains types de messages d’action.

    • Message d’action séparateur ||actionMsg instanceof
    • SystemActionMsg ||actionMsg instanceof
    • Message TopicFinishedActionMsg ||actionMsg instanceof
    • SwitchToVirtualAgentActionMsg ||actionMsg instanceof
    • SwitchConversationActionMsg ||actionMsg instanceof
    • ChatSubHeaderActionMsg ||actionMsg instanceof
    • StartSpinnerActionMsg ||msg d’action instance de EndSpinnerActionMsg
    • S’abonner à SupportQueue ||actionMsg instanceof
    • S’abonner à ChatPresence ||actionMsg instanceof
    • SwitchToLiveAgentActionMsg ||actionMsg instanceof

    ActionRichControl enveloppe ces messages à l’intérieur de l’élément actionMsg . Ainsi, un seul transformateur sortant pour ActionRichControl peut gérer tous ces messages. Un transformateur entrant n’est pas nécessaire pour ce composant.
    agentInfo paramètre Si le contrôle enrichi est envoyé à partir d’un agent actif, l’attribut agentInfo est ajouté au contrôle enrichi.
    Exemple :
    {
     uiType: "someType",
     group: "someGroup"
     agentInfo: { sentFromAgent: true }  // please note that this object may contain more info in subsequent releases.
     ...
}
    Sélecteur par défaut Mappe vers les contrôles Sélecteur de fichier, Sélecteur de rubrique et Booléen .
    Exemple :
    {
    uiType: "Picker/TopicPicker/Boolean",
    group: "DefaultPicker",  
    nluTextEnabled: true/false,
    promptMsg: "", // optional (needed for TopicPicker)
    label: "The question for the list",   // always filled
    itemType: "Picture/List"  // needed to user key to expect picture attached
    options: [
        {
            label: "display label prompt",
            value: "the value required to satisfy the question",
            description: "a description of value_1 item"
	    attachment: "www.foo",
            enabled: true/false
        }, 
	...
    ]
}

    Le paramètre facultatif order vous permet de spécifier l’ordre dans lequel les rubriques promues doivent s’afficher. Par exemple :

    "options": [
    {
      label: "Check IT Ticket Status",
      value: "55720b465bf0201024f11fc40a81c72d",
      order: 100,
      enabled: true
    },
    {
      label: "Live Agent Support",
      value: "ce2ee85053130010cf8cddeeff7b12bf",
      order: 200,
      enabled: true
    },
    {
      label: "Open IT Ticket 2",
      value: "2a46cffbc7602010v088bbf603c260a7",
      order: 300,
      enabled: true
    }
]
    Texte par défaut Mappe vers les contrôles Texte d’entrée, Texte de sortie et Chargement de fichier.
    Exemple :
    {
    uiType: "InputText/OutputText/FileUpload/Picture",
    group: "DefaultText", 
    required: true/false,
    nluTextEnabled: true/false,
    itemType: "file/image/inputtext/outputtext",
    maskType: "SECURE/SENSITIVE/NONE"  // null except for InputText/OutputText
    label: "The Question?"        
}
    Date par défaut Mappe aux contrôles Date et Heure .
    {
    uiType: "Date/DateTime/Time",
    group: "DefaultDate", 
    required: true/false,
    nluTextEnabled: true/false,   
    label: "The Question?"
     
}
    Lien de sortie par défaut Mappage pour lier les contrôles de réponse .
    Exemple :
    {
    uiType: "OutputLink",
    group: "DefaultOutputLink",
    label: "link label",
    header: "link header",
    type: "link",
    value: {
        action: "www.foo",
    }	
}
     
}
    DefaultOutputImage Mappe vers les contrôles de réponse d’image .
    Exemple :
    {
    uiType: "OutputImage",
    group: "DefaultOutputImage",
    value: "www.foo"
}
    Carte de sortie par défaut Mappe vers les contrôles de réponse de carte .
    Exemple :
    {
    uiType: "OutputCard",
    group: "DefaultOutputCard",
    templateName: "Card",
    data: "some json data string"
}
    DefaultOutputHtml Mappe vers les contrôles de réponse HTML .
    Exemple :
    {
    uiType: "OutputHtml",
    group: "DefaultOutputHtml",
    style: "inline",
    height: 100,
    width: 100,
    value: "<div>html</div>"
}
    Table de sortie par défaut Mappe aux contrôles de réponse de table .
    Exemple :
    {
    uiType: "OutputTable",
    group: "DefaultOutputTable",
    label: "Table Title",
    headers: ["Column 1", "Column 2"],
    navigationBtnLabel: "See next",
    data: [
        ["foo1", "foo2"],
        ["bar1", "bar2"]
    ]
}
    DefaultGroupedPartsOutputControl Mappe vers les contrôles à réponses multiples .
    Exemple :
    {
    uiType: "GroupedPartsOutputControl",
    group: "DefaultGroupedPartsOutputControl"
    groupPartType: "Link",
    header: "header message",
    values: [
	{
	    action: "www.foo",
	    description: "description",
	    label: "link_1 label",
	    context: "ITSM"
	},
	...
    ]
}
    DefaultMultiPartOutput Mappe vers les contrôles à réponses multiples .
    Exemple :
    {
    uiType: "MultiPartOutput",
    group: "DefaultMultiPartOutput"
    navigationBtnLabel: "Go next",
    content: {
        uiType: "OutputHtml",
        style: "inline",
        type: "html",
        height: 100,
        width: 100,
        value: "<div>html</div>"
     }
}
    DefaultCustomControl Mappe vers des contrôles personnalisés.
    Exemple :
    {
    uiType: "CustomControl",
    group: "DefaultCustomControl",
    name: "The name of the Custom Control (sys_cs_custom_control.name)",
    required: true/false,
    uxComponentDefinitionSysId: "seismicComponentId" // or null if not
    isInput: true/false, // whether to wait for a response value or if just output
    serializedControlData: "User defined JSON from generateControlData function";    
}