---
sourceDocument: Interfaces conversationnelles Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/conversational-interfaces
Release :
- yokohama
ft:locale :
- fr-FR
ft:publication_title :
- Interfaces conversationnelles Yokohama
ft:clusterId :
- convint
bundleId :
- convint
workflow :
- Platform
---
# Agent virtuel Fonctionnalités d'API disponibles dans la version 2.0.x du Store
# Agent virtuel Fonctionnalités d'API disponibles dans la version 2.0.x du Store {#ariaid-title1}
* Rversion finale: Yokohama
*
* Mis à jour 30 janv. 2025
*
*  12 minutes de lecture
Agent virtuel La version 2.0.x de l'API permet d'accéder à d'autres fonctionnalités identiques à celles disponibles dans Agent virtuel et Messagerie instantanée d'agent, y compris la prise en charge des contrôles enrichis et les 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 YesNoou ) pour faciliter la localisation.
Pour plus d'informations sur la localisation de rubriques, reportez-vous à .[Localisation de Agent virtuel conversations](https://servicenow-prod.fluidtopics.net/m7oehSbmiyqU_Y4Cso3TpQ "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 plus d'informations sur les contrôles personnalisés, reportez-vous à la section [Personnalisation à l'aide de Agent virtuel contrôles personnalisés](https://servicenow-prod.fluidtopics.net/TVcrEKwgP689s_af1hM5dg "Les contrôles personnalisés sont des composants que ServiceNow les développeurs peuvent créer pour être utilisés dans des rubriques ou des Agent virtuel blocs de rubriques. Ces commandes incluent des curseurs ou des lecteurs vidéo. Des commandes personnalisées complètent celles fournies dans Concepteur d'agent virtuel.").
Contrôles de réponse du bot de table
: Les rubriques qui utilisent des contrôles de réponse de bot de table sont désormais prises en charge. Pour plus d'informations, consultez [Contrôle de réponse du bot de table](https://servicenow-prod.fluidtopics.net/zTAm7HnH9UBKF_pSDjClcA "Utilisez le contrôle de réponse de bot de table dans une Agent virtuel rubrique pour afficher une réponse de bot sous forme de table.").
Tous les enregistrements sont renvoyés par l'API Agent virtuel en une seule fois. Agent virtuel attendra une réponse du client API pour envoyer le contrôle suivant. Utilisez cette paginationBreak propriété pour afficher les enregistrements en blocs à l'utilisateur. Par exemple, s'il paginationBreak est défini 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 bot 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 du bot HTML
: Les rubriques qui utilisent des contrôles de réponse HTML bot sont désormais prises en charge. Pour plus d'informations, consultez [Contrôle de réponse du bot HTML](https://servicenow-prod.fluidtopics.net/ifvfD~NjnR~5GSX41gUfeA "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 de bot 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 de bot à 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 bot multi-réponses](https://servicenow-prod.fluidtopics.net/1cXsMhwsfAEbdqfSVpH1gg "Utilisez le contrôle de réponse de bot à réponses multiples dans une Agent virtuel rubrique pour afficher séquentiellement deux sorties ou plus. Les sorties peuvent être un texte, une image, un lien ou 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 d'agent à réponses multiples :
{
"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 de texte enrichi
: Les rubriques qui utilisent du texte enrichi sont désormais prises en charge. Le texte enrichi comprend le texte en gras ou en italique, les liens hypertextes, les listes à puces et les emojis.
## Fonctionnalités supplémentaires Messagerie instantanée d'agent {#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 cela, activez les noms et les avatars des agents dans les paramètres de Messagerie instantanée d'agent.
Un exemple de charge utile de message pourrait ressembler à ceci :
{
"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, voir [Configurer la Messagerie instantanée d'agent](https://servicenow-prod.fluidtopics.net/ZyXyIDwylRNUIKo96FWCdA "Configurez Messagerie instantanée d'agent pour permettre aux agents actifs de discuter avec les clients et de gérer diverses fonctionnalités de conversation pour les agents et les utilisateurs finaux. Par le biais de Messagerie instantanée d'agent, les agents interagissent avec les utilisateurs finaux, créent des enregistrements d’incidents ou de tickets, ou transfèrent les conversations de messagerie instantanée à un autre agent ou à une autre 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 en attente de messagerie instantanée dans les paramètres de Messagerie instantanée d'agent. La spinnerType valeur est définie sur wait_time. Si l'état d'attente de messagerie instantanée en direct est défini sur Aucun, la spinnerType valeur est .none
Agent virtuel L'API envoie l'exemple JSON suivant dans le body paramètre de la charge utile.
{
"uiType":"ActionMsg",
"actionType":"StartSpinner",
"spinnerType":"wait_time",
"message":"Routing you to a live agent...",
"waitTime":"8 Seconds"
}
Pour plus d'informations, voir [Configurer la Messagerie instantanée d'agent](https://servicenow-prod.fluidtopics.net/ZyXyIDwylRNUIKo96FWCdA "Configurez Messagerie instantanée d'agent pour permettre aux agents actifs de discuter avec les clients et de gérer diverses fonctionnalités de conversation pour les agents et les utilisateurs finaux. Par le biais de Messagerie instantanée d'agent, les agents interagissent avec les utilisateurs finaux, créent des enregistrements d’incidents ou de tickets, ou transfèrent les conversations de messagerie instantanée à un autre agent ou à une autre file d’attente.").
Envoyer l'historique de la messagerie instantanée du bot primaire à Agent virtuel
: Le bot principal peut transmettre l'historique des conversations instantanées à un agent actif afin que l'agent puisse voir le contexte de la conversation.
Agent virtuel convertit l'historique des messages 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 principal doit envoyer l'historique des messages dans la première demande. Dans toute autre demande postérieure à la première demande, la charge utile de l'historique des messages sera ignorée.
* Seuls les messages texte sont pris en charge.
* Le bot principal peut transmettre n'importe quelle URL comme valeur dans le message texte, mais l'agent actif ne peut l'afficher que dans le cadre de l'image. L'agent actif ne peut pas 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 du bot primaire {#va-api-features-v2__section_xcn_f41_kqb}
L'API Agent virtuel prend désormais en charge les demandes suivantes du bot principal.
Paramètres système et variables de contexte
: Le bot principal peut transmettre des paramètres système et des variables de contexte en entrée, et Agent virtuel respectera ces paramètres. Les paramètres système tels que liveagent_devicetype, liveagent_requester_session_language, topicliveagent_topiclive_agent_onlyet 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/UqnswTAdVTxPoiyCPhN6AA "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/Aox7m3fL6zThpxq14y93uA "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 à une enquête avant 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 les agents actifs. Vous pouvez également définir des variables pour capturer les informations contextuelles transmises dans les Agent virtuel scripts de rubriques à 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.
* Format date/heure 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 par défaut est l'heure UTC. Par exemple, 2021-02-16 20:13:13.
{#va-api-features-v2__ul_vjl_qjb_kqb}
## Prise en charge du saut de nœud {#va-api-features-v2__section_b13_zry_3qb}
Agent virtuel L'API prend en charge l'omission d'un nœud s'il est conçu pour le faire dans la rubrique. Par exemple, dans , vous Concepteur d'agent virtuel pouvez désigner un contrôle d'entrée utilisateur comme pouvant être ignoré dans le AvancéeMasquer 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 pouvant être ignoré, reportez-vous à la section [Concepteur d'agent virtuel Contrôles de l'entrée de l'utilisateur](https://servicenow-prod.fluidtopics.net/nHYSLXOxxAFDXRVq~4qr4g "Utilisez l’ensemble des contrôles d’entrée fournis par Concepteur d'agent virtuel pour inviter et capturer des informations à partir de l’utilisateur dans une conversation.").
Si un nœud est marqué comme ignorable, le bot présentera cette option à l'utilisateur. Si l'utilisateur l'ignore, le bot principal 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 la 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 meilleure fonctionnalité de négociation 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 la négociation synchrone](https://servicenow-prod.fluidtopics.net/GS3jNcMNPTVR9NEjEWwGPg#va-api-features-v3__synchronous_support_enhancements).
Lorsque cette option est activée, Agent virtuel elle fournit des réponses au bot principal de manière synchrone. Si vous souhaitez activer la communication avec Agent virtuel en mode synchrone, vous devez désactiver manuellement les fonctionnalités suivantes pour que la 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 : [téléchargement de fichiers](https://servicenow-prod.fluidtopics.net/nHYSLXOxxAFDXRVq~4qr4g "Utilisez l’ensemble des contrôles d’entrée fournis par Concepteur d'agent virtuel pour inviter et capturer des informations à partir de l’utilisateur dans une conversation."), bloc [Utilitaire d'action](https://servicenow-prod.fluidtopics.net/QwowBijhuL0igcscYXtP1g "Utilisez l’utilitaire 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 et](https://servicenow-prod.fluidtopics.net/QE7x9BsslveihYTLmMp_fA "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 des conversations avec des bots. Par exemple, certains blocs de rubriques vous permettent de vérifier la disponibilité de l’agent ou de générer des Recherche IA résultats.") pause.
Pour désactiver ces fonctionnalités et activer la prise en charge synchrone, procédez comme suit :
1. Exclure le canal bot vers bot de Messagerie instantanée d'agent.
1. Accédez à Tout, puis saisissez 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 à 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 saisissez 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 la désactiver.
5. Décochez la case Indicateur de frappe de support pour le désactiver.
6. Cochez la case 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=yokohama&pubname=yokohama-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 lorsque cette option est activée en mode asynchrone :
* Simple : notifications par texte uniquement. Les notifications simples sont envoyées dès qu'elles arrivent.
* 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 : donne à 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/Y0oE1fi9GV3yoqGMIRLaiQ "Envoyez ServiceNow des 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 à passer en revue 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 d'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 saisissez sys_cs_channel.list dans le filtre de navigation.
2. Ouvrez l'enregistrement bot à bot.Si vous y êtes invité, activez la modification dans 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 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 la rubrique ou le nom de l'intention de rubrique. Il est recommandé d'envoyer uniquement l'ID ou le nom de la rubrique. Actuellement, si l'un ou l'autre est incorrect ou si le bot est 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 rubriques de mots clés : 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 passer directement à 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 sont affichés 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 typage 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 saisie de l'utilisateur à un agent actif, le client doit envoyer l'action TYPING. Lorsque l'utilisateur a fini de saisir, 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 frappe, procédez comme suit.
1. Accédez à Tout, puis saisissez sys_cs_channel.list dans le filtre de navigation.
2. Sélectionnez l'enregistrement bot à bot.
3. Cochez la case Indicateur de frappe de support .
4. Cliquez sur Mettre à jour.
{#va-api-features-v2__ol_nrn_tsd_gqb}