--- 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 --- # Utilisant API Agent virtuel # Utilisant API Agent virtuel {#ariaid-title1} * Rversion finale: Yokohama * * Mis à jour 30 janv. 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture Utilisez l'application ServiceNow® Agent virtuel API pour intégrer n'importe quelle interface de messagerie instantanée ou un bot à ServiceNow® Agent virtuel ou Messagerie instantanée d'agent. L'application est disponible à partir ServiceNow® Store du . ## Vue d'ensemble de la API Agent virtuel {#virtual-agent-api__section_cxx_ldc_qmb} L'API Agent virtuel est une API REST. Cette API repose sur le cadre de travail d'intégration conversationnelle de la messagerie instantanée personnalisée fourni à Agent virtuel partir de la Paris version. L'API permet ServiceNow aux développeurs, aux utilisateurs avancés et aux administrateurs de l'utiliser Agent virtuel de l'une des manières suivantes : Bot autonome : Utilisez Agent virtuel un bot autonome que vous intégrez à Enterprise ou à toute autre interface de messagerie instantanée tierce prenant en charge les interfaces conversationnelles. Vos utilisateurs finaux peuvent interagir avec et Agent virtuelMessagerie instantanée d'agent via plusieurs canaux à l'aide de cette intégration. Bot secondaire : À utiliser Agent virtuel comme bot secondaire dans un environnement qui dispose de plusieurs bots spécialisés gérés par un bot primaire. Dans ce scénario, un bot primaire gère la communication avec les bots secondaires pour le compte de l'utilisateur final. Un bot primaire peut être IBM Watson Assistant, Microsoft LUIS ou un bot primaire développé en interne. Vos bots secondaires, tels que le ServiceNow bot, peuvent gérer des types spécifiques de demandes d'utilisateurs finaux, telles que des tickets de service ou des réservations. Bot Interconnect : À utiliser Agent virtuel Bot Interconnect en tant que bot primaire dans un environnement de messagerie instantanée diversifié. Bot Interconnect crée une expérience de messagerie instantanée unifiée et donne à vos utilisateurs finaux l'accès à plusieurs canaux et à une grande variété de tâches d'entreprise disponibles à partir de ServiceNow. L'API Agent virtuel est utile pour créer des intégrations de serveur à serveur. Toutefois, pour les intégrations qui nécessitent la transformation de contrôles non pris en charge qui doivent être affichés dans votre interface de messagerie instantanée existante, envisagez d'utiliser le [cadre de travail d'intégration de la messagerie instantanée personnalisée](https://servicenow-prod.fluidtopics.net/Emxax2j4HvfWdF6uIVGNAQ "Le cadre de travail d’intégration conversationnelle de la messagerie instantanée personnalisée est un cadre de travail puissant composé d’API scriptables et de configurations permettant de l’intégrer ServiceNow Agent virtuel à n’importe quelle interface conversationnelle."). Pour en savoir plus sur des fonctionnalités telles que le format de l'URL et les paramètres de demande et de réponse pris en charge dans l'API, consultez API d'intégration Agent virtuel[de bot Agent virtuel](https://www.servicenow.com/docs/access?context=bot-api&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US). ![Lien vidéo vers l’académie Agent virtuel.]() [Améliorez vos expériences avec l'API Agent virtuel (vidéo de l'Académie Agent virtuel](https://www.youtube.com/watch?v=cyhmMyG4jKk) ) ## Fonctionnement de l'API Agent virtuel {#virtual-agent-api__section_ivs_d2r_fnb} Le diagramme suivant montre comment l'API REST traite l'entrée de l'utilisateur à partir d'une interface de messagerie instantanée tierce ou d'un bot primaire, puis génère une réponse de bot. 1. L'utilisateur fournit une entrée à un bot primaire ou à une interface de messagerie instantanée tierce. 2. Le bot envoie une demande JSON POST au point de terminaison REST entrant (via une API REST scriptée). 3. Il Now Platform authentifie et traite la demande, qui est envoyée à Agent virtuel un agent actif. 4. L'envoie Now Platform un JSON de réponse POST du point de terminaison REST sortant (via l'API REST) au bot. 5. Le bot primaire ou les interfaces de messagerie instantanée tierces affichent la réponse à l'utilisateur. {#virtual-agent-api__ol_pwf_jqc_kyb} Figure 1. Points de terminaison REST entrants et sortants dans l'API Agent virtuel Pour voir une démonstration de l'API Agent virtuel et une FAQ, consultez [Prise en main des API Agent virtuel](https://community.servicenow.com/community?id=community_article&sys_id=080e3903dbc4e4107d3e02d5ca96198c) sur le site de la communauté. ## Limitations {#virtual-agent-api__section_xqy_r1l_2qb} L'API Agent virtuel ne prend pas en charge les fonctionnalités suivantes : * Marque de messagerie instantanée via cette Agent virtuel intégration d'API {#virtual-agent-api__ul_yqy_r1l_2qb} ## Compatibilité des versions et des versions {#virtual-agent-api__section_t11_5zb_dqb} {#virtual-agent-api__table_syv_gzb_dqb__entry__2} | Version | Versions compatibles | |-|-| | 3.14.3 | Yokohama | | 3.14.2 | Xanadu | | 3.14.1 | Xanadu | | 3.10.0 | Washington DC | | 3.9.x | Vancouver | | 3.8.x | Vancouver | | 3.7.x | Utah | | 3.5.x | Tokyo | | 3.0.x | San Diego | | 2.0.x | Rome Un sous-ensemble de fonctionnalités est compatible avec Quebec. | | 1.3.0 | Quebec | | 1.0.12 | Quebec | | 1.0.9 | Paris | [Tableau 1. Agent virtuel Compatibilité des versions et versions de l'API] {#virtual-agent-api__table_syv_gzb_dqb} Remarque : L'API Agent virtuel nécessite une licence Pro similaire à celle de Agent virtuel. * **[Agent virtuel Fonctionnalités de l'API](https://servicenow-prod.fluidtopics.net/jR35NM_RQbD0Ct9jS2fBEw)** Vous pouvez utiliser l'API Agent virtuel pour intégrer un grand nombre des fonctionnalités disponibles dans Agent virtuel votre Messagerie instantanée d'agent environnement de messagerie instantanée. La prise en charge des fonctionnalités varie en fonction de votre ServiceNow version et du numéro de version de l'application Store de l'API. * **[Agent virtuel Fonctionnalités d'API disponibles dans la version 2.0.x du Store](https://servicenow-prod.fluidtopics.net/nWRZV2C3lRen6~QKaGWw~w#va-api-features-v2)** 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. * **[API Agent virtuel fonctionnalités disponibles dans la version 3.0.x du Store](https://servicenow-prod.fluidtopics.net/GS3jNcMNPTVR9NEjEWwGPg#va-api-features-v3)** API Agent virtuel La version 3.0.x donne accès à un plus grand nombre des mêmes fonctionnalités que celles disponibles dans Agent virtuel et Messagerie instantanée d'agent, y compris la possibilité de télécharger des fichiers à partir d'une URL privée et des améliorations de la négociation synchrone. * **[Installer l'API Agent virtuel](https://servicenow-prod.fluidtopics.net/9HcyItPiHN4B5cCu4Cl~TA)** Installez l'application API pour intégrer une interface de messagerie instantanée Agent virtuel ou un bot avec ServiceNow® Agent virtuel ou Messagerie instantanée d'agent. * **[Examiner le point de terminaison REST entrant et configurer l'authentification entrante](https://servicenow-prod.fluidtopics.net/3rb54pBO4DRNrJ7PQ4NuNA)** Après avoir installé l'API Agent virtuel , accédez à la ressource API REST scriptée pour examiner le point de terminaison et configurer l'authentification. * **[Configurer l'authentification des messages pour les communications entrantes](https://servicenow-prod.fluidtopics.net/Zteg9VttcFwNYa7B~4A6Eg)** Vous pouvez configurer l'authentification par message pour l'API Agent virtuel au lieu de l'authentification de base ou OAuth. L'authentification des messages implique la configuration de jetons statiques ou de hachage, la configuration de l'authentification du fournisseur et la définition de l'identité du canal. * **[Configurer le point de terminaison REST de la réponse de sortie et l'authentification sortante pour l'API Agent virtuel](https://servicenow-prod.fluidtopics.net/7jonk~ebalaqwdracvd18g)** Spécifiez l'URL du point de terminaison sortant sur laquelle les Agent virtuel réponses sont publiées. Configurez l'authentification sortante. * **[Agent virtuel Intégration bot-to-bot](https://servicenow-prod.fluidtopics.net/DaSnNg7EKLTdU6DpcJzbNA)** L'API Agent virtuel prend en charge les environnements qui utilisent plusieurs bots. Dans cette situation, un bot primaire communique avec des bots secondaires tiers, tels qu'un ServiceNow bot. * **[Fermeture des conversations inactives d'agent à agent](https://servicenow-prod.fluidtopics.net/bVRRXvbkyn3tisaujETKtw)** Dans les intégrations bot-to-bot (API Agent virtuel), les conversations abandonnées qui sont \<\< inactives \>\> pendant plus d'une heure sont automatiquement fermées par la tâche planifiée. Time Out Abandoned B2B Conversations Cette tâche s'exécute toutes les heures chaque jour. * **[Configurer les applications de plusieurs fournisseurs](https://servicenow-prod.fluidtopics.net/2a452CHQAg8_ZRnLfNaaQA)** Vous pouvez configurer plusieurs applications de fournisseurs pour prendre en charge les agents IA lorsque plusieurs bots primaires les utilisent API Agent virtuel et que vous devez les distinguer. * **[Transformer la demande et la réponse d'API d'Agent virtuel](https://servicenow-prod.fluidtopics.net/UBiy5pb5nocAwaniAAL5pg)** Vous pouvez transformer la demande et la réponse d'API d'Agent virtuel dans des formats pris en charge via les points d'extension scriptés fournis dans l'API d'Agent virtuel. * **[Activer l'expérience Now Assist dans API Agent virtuel](https://servicenow-prod.fluidtopics.net/aipV2nKPzp_VxwoIUlJAsQ)** Activez Now Assist l'expérience dans API Agent virtuel pour prendre en charge les compétences d'IA générative sur plusieurs canaux de fournisseurs.