---
sourceDocument: Interfaces conversationnelles Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/conversational-interfaces
Release :
- xanadu
ft:locale :
- fr-FR
ft:publication_title :
- Interfaces conversationnelles Xanadu
ft:clusterId :
- convint
bundleId :
- convint
workflow :
- Platform
---
# Agent virtuel Fonctionnalités de l'API disponibles dans la version Store 2.0.x
# Agent virtuel Fonctionnalités de l'API disponibles dans la version Store 2.0.x {#ariaid-title1}
* Rversion finale: Xanadu
*
* Mis à jour 1 août 2024
*
*  12 minutes de lecture
Agent virtuelLa version 2.0.x de l'API permet d'accéder à un plus grand nombre des mêmes fonctionnalités que celles disponibles dans et Messagerie instantanée d'agent, y compris une prise en Agent virtuel charge approfondie du contrôle et des notifications.
## Prise en charge de contrôles enrichis supplémentaires {#va-api-features-v2__section_bcd_4k1_kqb}
Agent virtuel L'API prend désormais en charge les contrôles enrichis suivants.
Contrôles booléens
: Les contrôles booléens renvoient des réponses sous forme de chaînes (soit Yes ou No) pour faciliter la localisation.
Pour en savoir plus sur la localisation de rubriques, reportez-vous à [Localisation des Agent virtuel conversations](https://servicenow-prod.fluidtopics.net/x87Pv3doLqg4A0j57jTMIA "La ServiceNow plateforme propose plusieurs méthodes pour localiser les Agent virtuel conversations, en fonction de vos besoins. Utilisez le Infrastructure de localisation pour gérer tous les aspects du processus de traduction, que vous utilisiez la traduction automatique, un fournisseur tiers ou les deux.").
Agent virtuel L'API envoie l'exemple JSON suivant pour un contrôle booléen :
{
"requestId": "asd2423-wrr434-weruyt-1234567",
"clientSessionId": "",
"nowSessionId": "",
"message": {
"text": "7a36412253a13010ff59ddeeff7b12fb",
"typed": false,
"clientMessageId": "ABC-123"
},
"userId": "beth.anglin",
"body": [
{
"uiType": "Boolean",
"group": "DefaultPicker",
"required": true,
"nluTextEnabled": false,
"label": "Sample Response for boolean control",
"options": [
{
"label": "Yes"
},
{
"label": "No"
}
]
}
],
"score": 1
}
Contrôles personnalisés
: Les rubriques qui utilisent des contrôles personnalisés sont désormais prises en charge. Pour en savoir plus sur les contrôles personnalisés, reportez-vous à la section [Personnalisation Agent virtuel avec des contrôles personnalisés](https://servicenow-prod.fluidtopics.net/_xs6Y7d~dMROxnYwA5pMKQ "Les contrôles personnalisés sont des composants que ServiceNow les développeurs peuvent créer pour les utiliser dans Agent virtuel des rubriques ou des blocs de rubriques. Ces commandes incluent les curseurs ou les lecteurs vidéo. Les contrôles personnalisés complètent les contrôles fournis dans Concepteur d'agent virtuel.").
Contrôles de réponse d'agents de table
: Les rubriques qui utilisent des contrôles de réponse de l'agent de table sont désormais prises en charge. Pour plus d'informations, consultez [Contrôle de réponse d'agent de table](https://servicenow-prod.fluidtopics.net/CciC~7a5PhQGu~796s6UNQ "Utilisez le contrôle de réponse de l’agent Table dans une Agent virtuel rubrique pour afficher une réponse de l’agent sous forme de table.").
Tous les enregistrements sont renvoyés par l'API Agent virtuel en même temps. Agent virtuel attendra une réponse du client d'API pour envoyer le contrôle suivant. Utilisez la propriété pour afficher les paginationBreak enregistrements par blocs à l'utilisateur. Par exemple, si paginationBreak la valeur est définie sur 10, l'utilisateur verra 10 enregistrements à la fois. Lorsque le client est prêt à passer au contrôle suivant, il doit envoyer DONE.
Agent virtuel L'API envoie l'exemple JSON suivant pour un contrôle de réponse de l'agent de table :
{
"requestId": "asd2423-wrr434-weruyt-1234567",
"clientSessionId": "",
"nowSessionId": "",
"message": {
"text": "Yes",
"typed": false,
"clientMessageId": "ABC-123"
},
"userId": "beth.anglin",
"body": [
{
"uiType": "OutputTable",
"group": "DefaultOutputTable",
"label": "Sample Table Rich control",
"headers": [
"Number",
"Short description"
],
"data": [
[
"INC0000005",
"CPU load high for over 10 minutes"
],
[
"INC0000015",
"I can't launch my VPN client since the last software update"
],
[
"INC0000025",
"Need to add more memory to laptop"
],
[
"INC0000035",
"Reset my password"
],
[
"INC0000055",
"SAP Sales app is not accessible"
],
[
"INC0009005",
"Email server is down."
]
],
"paginationBreak": 10,
"totalSearchResultsCount": 6,
"navigationBtnLabel": "Click for more"
}
],
"score": 1
}
Contrôles de réponse des agents HTML
: Les rubriques qui utilisent des contrôles de réponse d'agent HTML sont désormais prises en charge. Pour plus d'informations, consultez [Contrôle de réponse de l'agent HTML](https://servicenow-prod.fluidtopics.net/_19FZlvUzWtfc5ig654w8g "Utilisez le contrôle de réponse de l’agent HTML pour afficher du texte HTML statique dans la réponse de l’agent Agent virtuel .").
Agent virtuel L'API envoie l'exemple JSON suivant pour un contrôle de réponse d'agent HTML :
{
"requestId": "asd2423-wrr434-weruyt-1234567",
"clientSessionId": "",
"nowSessionId": "",
"message": {
"text": "Yes",
"typed": false,
"clientMessageId": "ABC-123"
},
"userId": "beth.anglin",
"body": [
{
"uiType": "OutputHtml",
"group": "DefaultOutputHtml",
"style": "inline",
"height": 100,
"width": 100,
"value": " Sample Response for Html control ",
"imageUrl": null,
"imageHeight": 0,
"imageWidth": 0,
"links": null
},
{
"uiType": "InputText",
"group": "DefaultText",
"required": true,
"nluTextEnabled": false,
"label": "some text",
"maskType": "NONE"
}
],
"score": 1
}
Contrôles de réponse d'agents à réponses multiples
: Les rubriques qui utilisent des contrôles de réponse bot à réponse multiple sont désormais prises en charge. Pour plus d'informations, consultez [Contrôle de réponse de l'agent à réponse multiple](https://servicenow-prod.fluidtopics.net/zq94OS~NXua9KE1jtr6vTg "Utilisez le contrôle de réponse bot multi-réponse dans une Agent virtuel rubrique pour afficher séquentiellement deux sorties ou plus. Les sorties peuvent être du texte, des images, des liens ou du HTML. Les utilisateurs peuvent passer d’une sortie à l’autre via un bouton de navigation fourni.").
Agent virtuel L'API envoie l'exemple JSON suivant pour un contrôle de réponse bot à réponse multiple :
{
"requestId": "asd2423-wrr434-weruyt-1234567",
"clientSessionId": "",
"nowSessionId": "",
"message": {
"text": "Done",
"typed": false,
"clientMessageId": "ABC-123"
},
"userId": "beth.anglin",
"body": [
{
"uiType": "MultiPartOutput",
"group": "DefaultMultiPartOutput",
"navigationBtnLabel": "Click for more",
"content": {
"uiType": "OutputText",
"value": "Text response from multiflow control example",
"maskType": "NONE"
}
}
],
"score": 1
}
Prise en charge du texte enrichi
: Les rubriques qui utilisent du texte enrichi sont désormais prises en charge. Le texte enrichi comprend du texte en gras ou en italique, des liens hypertexte, des listes à puces et des emojis.
## Fonctionnalités Messagerie instantanée d'agent supplémentaires {#va-api-features-v2__section_tbg_mg1_kqb}
L'API Agent virtuel prend désormais en charge les fonctionnalités suivantes lors du transfert vers Messagerie instantanée d'agent.
Transmettre le nom et l'avatar de l'agent
: Lorsque le bot principal transfère une messagerie instantanée à un agent actif, Agent virtuel il peut envoyer le nom et l'avatar de l'agent au bot principal. Pour activer cette option, activez les noms et avatars des agents dans les paramètres de la Messagerie instantanée d'agent.
Voici un exemple de charge utile de message :
{
"requestId":"f42f3550-5b44-4cde-aa52-9b6756b3131c",
"clientSessionId":"U94CSJLEN",
"message":{
"text":"Live Agent support.",
"typed":true
},
"userId":"U94CSJLEN",
"body":[
{
"uiType":"OutputText",
"group":"DefaultText",
"agentInfo":{
"sentFromAgent":true,
"agentName":"Beth Anglin",
"agentAvatar":"ee4eebf30a0004d963b5c5ac0d734dc4.iix?t=small"
},
"value":"Thank you for contacting support. I am looking into your question now and will be with you shortly."
}
],
"agentChat":true,
"score":1
}
Pour plus d'informations, consultez [Configurer la Messagerie instantanée d'agent](https://servicenow-prod.fluidtopics.net/lqo6KquMloDL86wlwq1ofA "Configurez Messagerie instantanée d'agent pour permettre aux agents en direct de discuter avec les clients et de gérer diverses fonctionnalités de conversation pour les agents et les utilisateurs finaux. Par l’intermédiaire Messagerie instantanée d'agentde , les agents interagissent avec les utilisateurs finaux, créent des enregistrements d’incidents ou de tickets ou transfèrent des messageries instantanées à un autre agent ou à une file d’attente.").
Temps d'attente de l'agent actif
: Lors du transfert vers un agent actif, le bot principal peut recevoir le temps d'attente et l'afficher à l'utilisateur. Pour activer cette option, sélectionnez Temps d'attente dans le champ État d'attente du chat en direct dans les paramètres de Messagerie instantanée d'agent. La spinnerType valeur est définie sur wait_time. Si l'état en attente de messagerie instantanée est défini sur Aucun, la spinnerType valeur est none.
Agent virtuel L'API envoie l'exemple JSON suivant dans le paramètre de la body charge utile.
{
"uiType":"ActionMsg",
"actionType":"StartSpinner",
"spinnerType":"wait_time",
"message":"Routing you to a live agent...",
"waitTime":"8 Seconds"
}
Pour plus d'informations, consultez [Configurer la Messagerie instantanée d'agent](https://servicenow-prod.fluidtopics.net/lqo6KquMloDL86wlwq1ofA "Configurez Messagerie instantanée d'agent pour permettre aux agents en direct de discuter avec les clients et de gérer diverses fonctionnalités de conversation pour les agents et les utilisateurs finaux. Par l’intermédiaire Messagerie instantanée d'agentde , les agents interagissent avec les utilisateurs finaux, créent des enregistrements d’incidents ou de tickets ou transfèrent des messageries instantanées à un autre agent ou à une file d’attente.").
Envoyer l'historique de la messagerie instantanée depuis le bot primaire vers Agent virtuel
: Le bot principal peut transmettre l'historique de la messagerie instantanée à un agent actif afin que l'agent puisse voir le contexte de la conversation.
Agent virtuel convertit l'historique du message en HTML, puis en image.
* L'image convertie est envoyée à l'agent actif en tant que premier message de la messagerie instantanée.
* Le bot primaire doit envoyer l'historique des messages lors de la première demande. Dans toute autre demande postérieure à la première demande, la charge utile de l'historique des messages est ignorée.
* Seuls les messages texte sont pris en charge.
* Le bot principal peut transmettre n'importe quelle URL sous forme de valeur dans le message texte, mais l'agent actif ne peut l'afficher que dans le cadre de l'image. L'agent actif ne sera pas en mesure de cliquer sur le lien.
{#va-api-features-v2__ul_thk_p31_kqb}
Exemple de charge utile du message :
{
"value": "Help me with password reset",
"displayName": "able",
"type": "text"
"isBotMessage": false,
}
Remarque :
Dans l'exemple précédent, type est sensible à la casse et doit avoir une valeur de text.
## Demandes enrichies à partir du bot principal {#va-api-features-v2__section_xcn_f41_kqb}
L'API Agent virtuel prend désormais en charge les requêtes suivantes provenant du bot principal.
Paramètres système et variables contextuelles
: Le bot principal peut transmettre des paramètres système et des variables contextuelles en tant qu'entrée, et Agent virtuel respectera ces paramètres. Les paramètres système tels que liveagent_devicetype, liveagent_requester_session_language, , live_agent_onlytopicliveagent_topic, et liveagent_devicetimezone sont pris en charge. Les variables de contexte personnalisées et Messagerie instantanée d'agent les variables de contexte sont également prises en charge.
Exemple de charge utile du message :
{
"requestId": "f42f3550-5b44-4cde-aa52-xxxxxxxxxx",
"clientSessionId": "xxxxxxxxxx",
"token": "abcd",
"message": {
"text": "Test",
"typed": true
},
"contextVariables": {
"requester_session_language": "es"
},
"userId": ""abel.tuter",
"emailId": "abel.tuter@example.com"
}
Pour plus d'informations, consultez [Variables de contexte de chat d'agent actif](https://servicenow-prod.fluidtopics.net/Nm6UilDVMDAPf~IfpxTDZA "Utilisez des variables de contexte de messagerie instantanée pour transmettre certaines informations de la rubrique à partager avec un agent actif ou pour contrôler la façon dont les conversations de bot sont acheminées vers des agents actifs. Agent virtuel inclut des variables par défaut, et vous pouvez en définir de nouvelles.") et [Configurer des variables de contexte pour le stockage des informations relatives à la messagerie instantanée](https://servicenow-prod.fluidtopics.net/0dsiq_JJS69erYVCHBMthQ "Spécifiez des variables de contexte de messagerie instantanée, également appelées Agent actif variables de messagerie instantanée, pour stocker des informations relatives à la messagerie instantanée, telles que les réponses d’enquête préalables à la messagerie instantanée. Ces variables contiennent des informations contextuelles qui peuvent être utilisées pour déterminer l’intention de la rubrique ou contrôler la façon dont les messageries instantanées sont acheminées vers des agents actifs. Vous pouvez également définir des variables pour capturer les informations contextuelles transmises dans Agent virtuel les scripts de rubriques afin de les partager avec des agents actifs.").
Fuseau horaire de l'utilisateur
: Définissez le fuseau horaire de l'utilisateur en le transmettant dans la charge utile de la demande. Une fois défini, ce paramètre de fuseau horaire est conservé jusqu'à ce qu'il soit réinitialisé.
Exemple de charge utile du message :
{
"requestId": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxxxxxx",
"clientSessionId": "xxxxxxxx-xxxx",
"token": "xxxxx",
"action" : "SET_USER_TIMEZONE",
"userId": "able.tuter",
"emailId": "abel.tuter@example.com",
"timezone":"Asia/Kolkata"
}
Lors de l'utilisation de cette fonctionnalité, tenez compte des points suivants :
* La conversation doit être ouverte (actuelle) afin de convertir la date et l'heure dans le fuseau horaire de l'utilisateur.
* Le bot principal doit envoyer la date et l'heure dans l'un des formats suivants :
* Nom du fuseau horaire. Par exemple, Asia/Kolkata ou America/New_York.
* Date/Heure : format 24 heures. Par exemple : YYYY-MM-DD HH:MM:SS
{#va-api-features-v2__ul_wjl_qjb_kqb}
* L'API Agent virtuel utilise le fuseau horaire spécifié par le bot principal, même si le fuseau horaire qu'elle définit diffère de la valeur stockée dans la table \[sys_user\].
* Pour définir le fuseau horaire de l'utilisateur, envoyez l'action SET_TIMEZONE . Si le nom du fuseau horaire n'est pas valide, la valeur du fuseau horaire est UTC par défaut. Par exemple, 2021-02-16 20:13:13.
{#va-api-features-v2__ul_vjl_qjb_kqb}
## Prise en charge de l'omission de nœud {#va-api-features-v2__section_b13_zry_3qb}
Agent virtuel L'API prend en charge l'omission d'un nœud si elle est conçue pour le faire dans la rubrique. Par exemple, dans Concepteur d'agent virtuel, vous pouvez désigner un contrôle d'entrée utilisateur comme pouvant être ignoré dans le AvancésMasquer ou ignorer ce nœud zone de la feuille de propriétés.
Figure 1. Condition ou script qui permet à l'utilisateur d'ignorer le nœud
Pour plus d'informations sur la définition d'un nœud comme ignorable, reportez-vous à la section [Concepteur d'agent virtuel Contrôles d'entrée de l'utilisateur](https://servicenow-prod.fluidtopics.net/~pjfky8e8M52i7e7b5aDiQ "Utilisez l’ensemble des contrôles d’entrée fournis par Concepteur d'agent virtuel pour inviter et capturer des informations de l’utilisateur dans une conversation.").
Si un nœud est marqué comme pouvant être ignoré, le bot présentera cette option à l'utilisateur. Si l'utilisateur l'ignore, le bot primaire doit transmettre la commande skip comme illustré dans l'exemple suivant.
{
"requestId": "f42f3550-5b44-4cde-aa52-9b6756b3131c",
"clientSessionId": "835607",
"token": "snow",
"message": {
"text": "_skip_",
"typed": false
},
"emailId": "beth.anglin@example.com",
"userId": "beth.anglin"
}
## Prise en charge de l'établissement de liaison synchrone {#va-api-features-v2__synchronous_support}
Remarque :
Ces exigences s'appliquent à la version 2.0.x de l'API Agent virtuel . Pour une plus grande fonctionnalité d'établissement de liaison synchrone, effectuez une mise à niveau vers la version 3.0.x, qui prend en charge le transfert d'agent actif et d'autres améliorations. Pour plus de détails, voir [Améliorations de l'établissement de liaison synchrone](https://servicenow-prod.fluidtopics.net/aGPPxm~HYWnmeRK4_jDiWQ#va-api-features-v3__synchronous_support_enhancements).
Lorsqu'elle est activée, Agent virtuel elle fournit des réponses au bot primaire de manière synchrone. Si vous souhaitez activer la communication en Agent virtuel mode synchrone, vous devez désactiver manuellement les fonctionnalités suivantes pour que l'établissement de liaison fonctionne :
* Messagerie instantanée d'agent
* Notifications
* Indicateurs de frappe
{#va-api-features-v2__ul_p3g_33j_gqb}
Remarque :
Les rubriques qui utilisent les fonctionnalités suivantes ne sont pas prises en charge en mode synchrone : [chargement de fichier](https://servicenow-prod.fluidtopics.net/~pjfky8e8M52i7e7b5aDiQ "Utilisez l’ensemble des contrôles d’entrée fournis par Concepteur d'agent virtuel pour inviter et capturer des informations de l’utilisateur dans une conversation."), , et bloc [Utilitaire d'action](https://servicenow-prod.fluidtopics.net/HPAqwx005C_D8yhx_rBBSA "Utilisez l’utilitaire d’action d’une Agent virtuel rubrique pour sélectionner les propriétés d’action de flux que le nœud doit créer. L’utilitaire Action s’intègre Agent virtuel au ServiceNow Studio de workflow produit.")de [rubriques Pause](https://servicenow-prod.fluidtopics.net/OsSfFWvTQxVXpPtpkp5W3g "Agent virtuel Fournit des blocs de rubriques prédéfinis que les auteurs de rubriques ou les administrateurs peuvent utiliser pour exécuter des fonctions ou des tâches spécifiques liées à la plateforme dans les conversations de bot. Par exemple, certains blocs de rubriques vous permettent de vérifier la disponibilité des agents ou de générer des Recherche IA résultats.").
Pour désactiver ces fonctionnalités et activer l'assistance synchrone, procédez comme suit :
1. Exclure le canal bot à bot de .Messagerie instantanée d'agent
1. Accédez à Tous, puis entrez sys_properties.list dans le filtre.
2. Sélectionnez la com.glide.cs.exclude.liveagent.support propriété système pour l'ouvrir.
3. Ajouter Bot To Bot au champ Valeur .
Figure 2. Exclure le canal bot vers bot de Messagerie instantanée d'agent
4. Cliquez sur Mettre à jour.
{#va-api-features-v2__ol_fv2_jr4_kqb}
2. Accédez à Tout, puis entrez sys_cs_channel.list dans le filtre de navigation.
3. Sélectionnez l'enregistrement bot à bot.
4. Décochez la case Activer les notifications pour le désactiver.
5. Décochez la case Indicateur de prise en charge de la saisie pour le désactiver.
6. Sélectionnez la case à cocher Synchrone .
Figure 3. Canal bot à bot avec prise en charge synchrone activée
Remarque :
Si le champ Synchrone n'est pas visible, vous pouvez [configurer la mise en page du formulaire](https://www.servicenow.com/docs/access?context=configure-form-layout&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) pour l'afficher.
7. Cliquez sur Mettre à jour.
{#va-api-features-v2__ol_icm_x3j_gqb}
## Prise en charge des notifications {#va-api-features-v2__section_u3d_gcs_2qb}
Utilisez Agent virtuel l'API pour envoyer les types de notifications suivants dans le canal bot à bot lorsqu'il est activé en mode asynchrone :
* Simple : notifications sous forme de texte uniquement. Des notifications simples sont délivrées dès leur arrivée.
* Carte d'image : image téléchargée sur le serveur ou spécifiée avec une URL.
* Carte d'enregistrement : colonnes spécifiées à partir d'un enregistrement dans une table.
* Actionnable : fournit à l'utilisateur la possibilité d'effectuer certaines actions. Les notifications exploitables sont mises en file d'attente. L'utilisateur peut les récupérer sur demande en envoyant la Show Notification commande.
{#va-api-features-v2__ul_rrg_2ks_2qb}
Pour plus d'informations, consultez [Configuration des Agent virtuel notifications](https://servicenow-prod.fluidtopics.net/f7_JdE~XZ4deN0QHS_3kzg "Envoyez des ServiceNow notifications directement aux utilisateurs via le chatbot sur les Agent virtuel canaux de messagerie pris en charge. Les notifications peuvent être de simples messages d’information à examiner ou des messages exploitables avec des boutons que les utilisateurs peuvent sélectionner pour effectuer certaines actions.").
Agent virtuel L'API envoie l'exemple JSON suivant pour une notification simple :
{
"requestId": "asd2423-wrr434-weruyt-1234567",
"clientSessionId": "",
"nowSessionId": "",
"message": {
"text": "Done",
"typed": false,
"clientMessageId": "ABC-123"
},
"userId": "beth.anglin",
"body": [
{
"uiType": "OutputCard",
"group": "DefaultOutputCard",
"templateName": "Notification",
"data": "{\"sys_id\":null,\"recordDisplayValue\":null,\"messageHeading\":\"[Heading]A notification has arrived. You can continue the conversation after viewing the notification.\",\"imageUrl\":null,\"tableLabel\":null,\"enableLink\":false,\"message\":\"[message]A notification has arrived. You can continue the conversation after viewing the notification.\",\"fields\":[],\"table_name\":null,\"url\":\"http://192.168.1.9:8080/null.do?sys_id=null\"}"
}
],
"completed": true,
"score": 1
}
Agent virtuel L'API envoie l'exemple JSON suivant pour une notification de carte à image :
{
"requestId": "asd2423-wrr434-weruyt-1234567",
"clientSessionId": "",
"nowSessionId": "",
"message": {
"text": "Done",
"typed": false,
"clientMessageId": "ABC-123"
},
"userId": "beth.anglin",
"body": [
{
"uiType": "OutputCard",
"group": "DefaultOutputCard",
"templateName": "Notification",
"data": "{\"sys_id\":null,\"recordDisplayValue\":null,\"messageHeading\":\"[Heading]A notification has arrived. You can continue the conversation after viewing the notification.\",\"imageUrl\":\"http://xxxxxx.service-now.com/2b2d0d2653a13010ff59ddeeff7b120d.iix\",\"tableLabel\":null,\"enableLink\":false,\"message\":\"[message]A notification has arrived. You can continue the conversation after viewing the notification.\",\"fields\":[],\"table_name\":null,\"url\":\"http://192.168.1.9:8080/null.do?sys_id=null\"}"
}
],
"completed": true,
"score": 1
}
Agent virtuel L'API envoie l'exemple JSON suivant pour une notification de carte d'enregistrement :
{
"requestId": "asd2423-wrr434-weruyt-1234567",
"clientSessionId": "",
"nowSessionId": "",
"message": {
"text": "Done",
"typed": false,
"clientMessageId": "ABC-123"
},
"userId": "beth.anglin",
"body": [
{
"uiType": "OutputCard",
"group": "DefaultOutputCard",
"templateName": "Notification",
"data": "{\"sys_id\":\"552c48888c033300964f4932b03eb092\",\"recordDisplayValue\":\"INC0010112\",\"messageHeading\":\"[Heading]A notification has arrived. You can continue the conversation after viewing the notification.\",\"imageUrl\":null,\"tableLabel\":\"Incident\",\"enableLink\":true,\"message\":\"[message]A notification has arrived. You can continue the conversation after viewing the notification.\",\"fields\":[{\"fieldLabel\":\"Number\",\"fieldValue\":\"INC0010112\"},{\"fieldLabel\":\"Short description\",\"fieldValue\":\"Assessment : ATF Assessor\"}],\"table_name\":\"incident\",\"url\":\"http://192.168.1.9:8080/incident.do?sys_id=552c48888c033300964f4932b03eb092\"}"
}
],
"completed": true,
"score": 1
}
Les notifications pour le canal bot à bot sont désactivées par défaut. Pour les activer, procédez comme suit :
1. Accédez à Tout, puis entrez sys_cs_channel.list dans le filtre de navigation.
2. Ouvrez l'enregistrement bot vers bot.Si vous y êtes invité, activez la modification de l'enregistrement.
3. Cochez la case Activer les notifications .
4. Cliquez sur Mettre à jour.
{#va-api-features-v2__ol_mx2_5ps_2qb}
Les administrateurs peuvent limiter le nombre de destinataires par notification en modifiant la com.glide.cs.per_notification_user_limit propriété. La valeur par défaut est 1 000.
## Changement de rubrique à l'aide du nom de la rubrique {#va-api-features-v2__section_h3z_v2l_2qb}
En plus d'utiliser l'ID de rubrique ou l'ID d'intention de rubrique pour changer de rubrique, vous pouvez utiliser le nom de la rubrique ou de l'intention de rubrique. Il est recommandé d'envoyer uniquement l'ID ou le nom de la rubrique. Actuellement, si l'une ou l'autre est incorrecte ou si le bot se trouve déjà dans la rubrique spécifiée, Agent virtuel n'envoie aucune réponse. L'utilisation dépend du mode que vous utilisez, comme suit :
* Découverte de rubrique NLU : utilisez le nom ou l'ID de l'intention de la rubrique.
* Découverte de rubrique par mot clé : utilisez le nom ou l'ID de la rubrique.
{#va-api-features-v2__ul_j1k_pgl_2qb}
Le bot principal peut envoyer l'action SWITCH avec le nom de la rubrique pour basculer directement vers une rubrique particulière.
Exemple de charge utile du message :
{
"requestId": "xxxx-xxxx-xxxx-xxxx",
"clientSessionId": "xxx-xxx-xxx-xxx",
"action":"SWITCH",
"topic":{
"name": "Topic Name"
},
"userId": "beth"
}
## Prise en charge de l'indicateur de frappe {#va-api-features-v2__section_mfv_mrd_gqb}
Vous pouvez activer les indicateurs de saisie pour les utilisateurs et les agents actifs. Actuellement, les indicateurs de saisie s'affichent comme suit :
* Affiché à l'agent lorsque l'utilisateur tape
* Affiché à l'utilisateur lorsque le bot prépare une réponse
{#va-api-features-v2__ul_zld_llb_kqb}
Lorsque l'indicateur de saisie est activé, Agent virtuel l'API envoie les actions StartTypingIndicator et EndTypingIndicator dans la charge utile de la réponse. Par exemple :
{
"uiType":"ActionMsg",
"actionType":"StartTypingIndicator"
}
Pour envoyer l'indicateur de frappe de l'utilisateur à un agent actif, le client doit envoyer l'action TYPING. Lorsque l'utilisateur a fini de taper, le client doit envoyer l'actionVIEWING. Par exemple:
{
"requestId": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxxxxxx",
"clientSessionId": "xxxxxxxx-xxxx",
"action": "TYPING/VIEWING",
"userId": "able.tuter",
"emailId": "abel.tuter@example.com",
"timezone":"Asia/Kolkata"
}
Pour activer les indicateurs de saisie, procédez comme suit.
1. Accédez à Tout, puis entrez sys_cs_channel.list dans le filtre de navigation.
2. Sélectionnez l'enregistrement bot à bot.
3. Cochez la case Indicateur de prise en charge de la saisie .
4. Cliquez sur Mettre à jour.
{#va-api-features-v2__ol_nrn_tsd_gqb}