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

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 un contrôle enrichi n’a pas d’implémentation de transformateur sortant, l’utilisateur final n’a pas reçu de réponse et l’expérience de messagerie instantanée peut 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 Génère les types de messages d’action suivants via ce cadre de travail. L’interface de messagerie instantanée personnalisée ne reconnaît que certains types de messages d’action.

    • SeparatorActionMsg ||actionMsg instanceof
    • SystemActionMsg ||actionMsg instanceof
    • Message TopicFinishedActionMsg ||actionMsg instanceof
    • SwitchToVirtualAgentActionMsg ||actionMsg instanceof
    • SwitchConversationActionMsg ||actionMsg instanceof
    • Message ChatSubHeaderActionMsg ||actionMsg instanceof
    • StartSpinnerActionMsg ||actionMsg instancede EndSpinnerActionMsg
    • SubscribetoSupportQueue ||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.
     ...
}
    DefaultPicker Mappe vers le sélecteur de fichier, le sélecteur de rubrique et les contrôles booléens .
    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
        }, 
	...
    ]
}

    Ce paramètre facultatif order vous permet de spécifier l’ordre dans lequel les rubriques mises en avant 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 de texte d’entrée, de texte de sortie et de télé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 Mappé 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 Mappages 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"
}
    DefaultOutputCard Mappés aux contrôles de réponse de la carte .
    Exemple :
    {
    uiType: "OutputCard",
    group: "DefaultOutputCard",
    templateName: "Card",
    data: "some json data string"
}
    DefaultOutputHtml (en anglais seulement) Mappe vers les contrôles de réponse HTML .
    Exemple :
    {
    uiType: "OutputHtml",
    group: "DefaultOutputHtml",
    style: "inline",
    height: 100,
    width: 100,
    value: "<div>html</div>"
}
    DefaultOutputTable Mappe vers les 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 Mappés 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";    
}