--- sourceDocument: Xanadu : créer des intégrations avec des applications sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/integrate-applications Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Xanadu : créer des intégrations avec des applications ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Spoke Vonage # Spoke Vonage {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes de lecture Gérez les communications par le biais d'appels, de SMS et WhatsApp (en anglais seulement en utilisant le Vonage compte de votre ServiceNow instance. ## Demander des applications dans l'App Store {#vonage-spoke__section_sz5_jv3_z3b} Visitez le site Web [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) pour découvrir toutes les applications disponibles et pour obtenir des informations sur la procédure à suivre pour soumettre des demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les [ServiceNow Storenotes de publication relatives à l'historique des versions](https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html).{#vonage-spoke__inline-send-to-store} ## Abonnement à Hub d'intégration {#vonage-spoke__section_rsf_yvb_l3b} Ce spoke requiert un abonnement au Centre d'intégration. Pour plus d'informations, consultez [Calendriers juridiques - Vue d'ensemble du Centre d'intégration](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf). ## Version de spoke {#vonage-spoke__section_mxx_ndy_bsb} La version1.1.3 du spoke Vonage correspond à la dernière version.{#vonage-spoke__vonagespk-vr} ## Versions prises en charge {#vonage-spoke__section_sv2_1n2_pmb} Ce spoke a été conçu pour Vonage les versions suivantes, mais peut être compatible avec les versions ultérieures : * Version de l'API de messages v0.1 * Version d'API vocale v1 {#vonage-spoke__ul_usd_grf_pmb} ## Exigences relatives au spoke {#vonage-spoke__section_vv2_1n2_pmb} * Accès administrateur au compte et au [tableau de bord de l'API](https://dashboard.nexmo.com/)Vonage Vonage. * Enregistrez les valeurs de clé API et de secret API. Vous pouvez accéder à ces valeurs à partir du tableau de bord de l'API Vonage . Pour en savoir plus, consultez la page [Authentification](https://developer.nexmo.com/concepts/guides/authentication) du site de documentation de [Vonage API Developer](https://developer.nexmo.com/documentation) .{#vonage-spoke__vonage-api-key} * Enregistrez et enregistrez la valeur du secret de signature. Vous pouvez accéder à cette valeur dans les [paramètres du compte du tableau de bord de l'API Vonage](https://dashboard.nexmo.com/settings). Pour en savoir plus, consultez la page [Authentification](https://developer.nexmo.com/concepts/guides/authentication) du site de documentation de [Vonage API Developer](https://developer.nexmo.com/documentation) . {#vonage-spoke__ul_wv2_1n2_pmb} ## Dépendances des spokes {#vonage-spoke__section_xv2_1n2_pmb} Si vous rencontrez des difficultés pour installer l'application, assurez-vous que les modules d'extension dépendants suivants sont installés : * ServiceNow Étape d'action du Centre d'intégration : REST (com.glide.hub.action_step.rest) * ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime) * Objet complexe (com.glide.cobject) * ServiceNow Concepteur de flux : entrées dynamiques (com.glide.hub.dynamic_inputs) {#vonage-spoke__ul_yv2_1n2_pmb} Remarque : Certains de ces modules d'extension sont des fonctionnalités sous licence et nécessitent des licences appropriées s'ils sont utilisés en dehors de l'implémentation des spokes. ## Flux secondaires du spoke {#vonage-spoke__section_uxx_tgf_kfb} Le spoke Vonage fournit des exemples de flux secondaires pour illustrer l'automatisation des Vonage tâches. Pour personnaliser un exemple de flux secondaire, copiez-le dans un nouveau périmètre de l'application. Les exemples de flux secondaires disponibles sont les suivants : {#vonage-spoke__table_hbd_qty_qfb__entry__2} | Flux secondaire | Description | |-|-| | Vonage SMS Webhook | Traite les demandes par SMS à partir de Vonage. | | Vonage Webhook vocal | Traite les demandes vocales à partir de Vonage. | | Vonage WhatsApp (en anglais seulement Webhook (en anglais seulement) | Traite les demandes à partir de Vonage.WhatsApp (en anglais seulement | [ ] {#vonage-spoke__table_hbd_qty_qfb}Pour personnaliser le flux secondaire par défaut, vous devez créer une copie de l'échantillon de flux secondaire et personnaliser le flux secondaire selon vos besoins. Lors de la personnalisation des flux secondaires, vous devez vous assurer qu'ils sont configurés pour éviter les boucles infinies. ## Actions du spoke {#vonage-spoke__section_b43_3h2_hfb} Le spoke Vonage fournit des actions permettant d'automatiser les Vonage tâches lorsque des événements se produisent dans votre ServiceNow instance. Les actions disponibles sont les suivantes : {#vonage-spoke__table_u1p_kh2_hfb__entry__3}{#vonage-spoke__vonage}{#vonage-spoke__whatsapp} | Catégorie | Action | Description | |-|-|-| | Gestion des comptes | Obtenir un solde de compte | Récupère le solde en cours du compte Vonage . | | Gestion des appels | Lire la tonalité DTMF dans l'appel | Lit les tonalités DTMF (Dual-tone multi-frequency) dans un appel actif | | Gestion des appels | Joindre un enregistrement à l'enregistrement ServiceNow | Joint un enregistrement d'appel à l'enregistrement cible ServiceNow . | | Gestion des appels | Créer un appel sortant | Crée un appel sortant vers un numéro de téléphone. | | Gestion des appels | Générer un NCCO | Construit un objet de contrôle d'appel Nexmo (NCCO) utilisé dans l'action Créer un appel sortant. | | Gestion des appels | Obtenir les détails de l'appel | Récupère les détails de l'appel spécifié. | | Gestion des appels | Rechercher des appels | Récupère les détails des appels spécifiés. | | Gestion des appels | Lire l'audio dans l'appel | Lit un fichier audio lors d'un appel actif. | | Gestion des appels | Utiliser la synthèse vocale dans l'appel | Joue la synthèse vocale dans un appel actif. | | Gestion des appels | Arrêter de lire le son dans l'appel | Arrête la lecture d'un fichier audio lors d'un appel actif. | | Gestion des appels | Arrêter la synthèse vocale dans l'appel | Arrête la synthèse vocale dans un appel actif. | | Gestion des appels | Mettre à jour l'appel | Met à jour l'état d'un appel actif. | | Gestion des numéros | Rechercher vos propres nombres | Récupère tous les numéros entrants associés au compte Vonage. | | Gestion SMS | Envoyer SMS | Envoie un SMS à un numéro de téléphone. | | WhatsApp (en anglais seulement ) Gestion | Envoyer des contacts | Envoie des contacts à un WhatsApp (en anglais seulement numéro. | | WhatsApp (en anglais seulement ) Gestion | Envoyer l'emplacement | Envoie les coordonnées géographiques d'un emplacement à un WhatsApp (en anglais seulement nombre. | | WhatsApp (en anglais seulement ) Gestion | Envoyer un message de média | Envoie un message média à un WhatsApp (en anglais seulement numéro. | | WhatsApp (en anglais seulement ) Gestion | Envoyer un message texte | Envoie un message texte à un WhatsApp (en anglais seulement numéro. | | WhatsApp (en anglais seulement ) Gestion | Envoyer un message texte à l'aide d'un modèle | Envoie un message texte à un numéro à l'aide WhatsApp (en anglais seulement du modèle. | [ ] {#vonage-spoke__table_u1p_kh2_hfb} ## Module de spoke {#vonage-spoke__section_w2k_lyx_qlb} Des webhooks bidirectionnels peuvent être configurés pour être informé des événements requis. La politique d'acheminement définit les conditions qui doivent être remplies pour notifier l'instance ServiceNow . Ces conditions sont basées sur les événements pour Vonage lesquels vous souhaitez être notifié. Lorsque les conditions sont remplies, la politique d'acheminement déclenche le flux secondaire associé, qui automatise à son tour les Vonage tâches. Par défaut, l'application Vonage Spoke est disponible et comprend les modules suivants : * Vonage Registres Webhook * Vonage Politiques d'acheminement de WebHook {#vonage-spoke__ul_qzt_2h4_z3b} Utilisez le Vonage module Registres Webhook pour affecter un jeton et fournir le chemin d'accès de l'API. Vous devez générer une URL de rappel ici et fournir cette URL dans Vonage. Les politiques d'acheminement par défaut sont fournies à titre de référence dans le module Politiques d'acheminement WebHook Vonage . Personnalisez ces politiques d'acheminement selon vos besoins. La politique d'acheminement prend en charge les champs suivants : * Mots clés * Direction de l'appel * État de l'appel * Type d'événement * De * État SMS * SMS * À * WhatsApp (en anglais seulement État du message * WhatsApp (en anglais seulement SMS * Afficher les champs connexes {#vonage-spoke__supp-fields-vonage} ## Exigences en matière d'alias de connexion et d'informations d'identification {#vonage-spoke__section_ibn_pj2_hfb} Hub d'intégration utilise des alias pour gérer les informations de connexion et d'identification. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'environnements multiples. Si les informations de connexion ou d'identification changent, il n'est pas nécessaire de mettre à jour les actions qui utilisent la connexion. Pour en savoir plus, consultez [Connections and Credentials](https://www.servicenow.com/docs/access?context=r-credentials&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). Deux alias de connexion et d'informations d'identification sont disponibles avec le Vonage spoke :{#vonage-spoke__table_gtq_d52_pmb__entry__2} | Vonage alias | Description | |-|-| | VonagePrimaire | Requis pour les actions qui gèrent le SMS, le numéro et le compte. | | Vonage | Requis pour les actions qui gèrent les appels et WhatsApp (en anglais seulementles . | [ ] {#vonage-spoke__table_gtq_d52_pmb} Pour en savoir plus sur la configuration du spoke, consultez [Configurer le spoke Vonage](https://servicenow-prod.fluidtopics.net/ue0LYuOKBRiFd57dKhx9YA#setup-vonage-spoke "Intégrez votre ServiceNow instance à l’instance pour permettre la Vonage communication entre elles. Avec cette intégration, votre ServiceNow instance peut automatiser les actions sur l’instance Vonage , tandis que l’instance Vonage peut envoyer des charges utiles à votre ServiceNow instance.").