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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 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ées [sys_cs_custom_adapter_config]. Si une implémentation de transformateur sortant est manquante dans un contrôle enrichi, aucune réponse n’est fournie à l’utilisateur final et celui-ci risque d’avoir une expérience de messagerie instantanée insatisfaisante.

    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 au cours d’une conversation. Certaines actions peuvent ne pas s’appliquer à tous les canaux. Par exemple, StartSpinnerActionMsg est ignoré dans les SMS.

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

    • SeparatorActionMsg ||actionMsg, instancede
    • SystemActionMsg ||actionMsg, instancede
    • TopicFinishedActionMsg ||actionMsg, instancede
    • SwitchToVirtualAgentActionMsg ||actionMsg, instancede
    • SwitchConversationActionMsg ||actionMsg, instancede
    • ChatSubHeaderActionMsg ||actionMsg, instancede
    • StartSpinnerActionMsg ||actionMsg, instance d’EndSpinnerActionMsg
    • SubscribetoSupportQueue ||actionMsg, instancede
    • SubscribeToChatPresence ||actionMsg, instancede
    • SwitchToLiveAgentActionMsg ||actionMsg, instancede

    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. Il n’y a pas besoin d’un transformateur entrant pour ce composant.
    agentInfo Paramètre Si le contrôle enrichi est envoyé par 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 aux 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 de date et d’heure .
    {
    uiType: "Date/DateTime/Time",
    group: "DefaultDate", 
    required: true/false,
    nluTextEnabled: true/false,   
    label: "The Question?"
     
}
    Lien de sortie par défaut Mappes 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",
    }	
}
     
}
    Image de sortie par défaut Mappe aux contrôles de réponse de l’image .
    Exemple :
    {
    uiType: "OutputImage",
    group: "DefaultOutputImage",
    value: "www.foo"
}
    Carte de sortie par défaut Mappe aux contrôles de réponse de carte .
    Exemple :
    {
    uiType: "OutputCard",
    group: "DefaultOutputCard",
    templateName: "Card",
    data: "some json data string"
}
    DefaultOutputHtml (en anglais seulement) Mappe aux 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 aux 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"
	},
	...
    ]
}
    Sortie en plusieurs parties par défaut Mappe aux 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 aux 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";    
}