---
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


---

# Configurer le spoke Vonage

# Configurer le spoke Vonage {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes de lecture

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.

## Avant de commencer

* Demander un Hub d'intégration abonnement.
* Activez le module d'extension de spoke Vonage sur votre ServiceNow instance.
* Rôle requis : administrateur
* Compte d'instance de développeur Vonage.
{#setup-vonage-spoke__ul_agy_qxd_rlb}

## Configurer l'instance de développeur Vonage {#ariaid-title2}

Générez les informations d'identification essentielles, telles que les clés API, les clés secrètes et les clés secrètes de signature, pour configurer votre Vonage instance de développeur. Votre ServiceNow instance utilise ces informations d'identification dans l'enregistrement de connexion pour se connecter à l'instance du Vonage développeur.

### Avant de commencer

Rôle requis : administrateur

Accès à un Vonage compte de développeur.

### Procédure

1. Connectez-vous à <https://developer.vonage.com/en/home>.
2. Sur la Vonage page Centre de développement, sélectionnez Mon tableau de bord.
3. Sur la page du tableau de bord de l'API Vonage , utilisez la clé API et le secret API par défaut ou créez votre clé API et votre secret API personnalisés.
   1. Pour utiliser la clé API par défaut et le secret API, copiez la clé API par défaut et les valeurs du secret API.
   2. Pour générer une clé API et un secret API personnalisés, dans le panneau de gauche, sélectionnez Paramètres de l'API.
   3. Sélectionnez Demander plus de clés API.
   4. Remplissez et envoyez le formulaire.
   5. Sélectionnez Créer une nouvelle clé secrète.
   6. Dans la fenêtre Ajouter un nouveau secret, saisissez votre secret personnalisé.
   7. Sélectionnez Enregistrer.
   {#configure-vonage-developer-instance__substeps_zsv_zq1_5yb}
4. Dans le champ Clé secrète de signature, copiez la clé secrète de signature.

## Configurer l'enregistrement de connexion pour l'alias de connexion et d'informations d'identification Vonage {#ariaid-title3}

Configurez un enregistrement de connexion qui permet à votre instance de se connecter à l'instance ServiceNowVonage et d'automatiser diverses actions sur l'instance Vonage . Par exemple, créez un flux qui permet d'obtenir Studio de workflow le solde de votre Vonage compte.

### Avant de commencer

Rôle requis : administrateur  
Remarque :  
Assurez-vous que vous êtes dans le périmètre du spoke Vonage .

### Procédure

1. Accédez à la ToutAutomatisation des processusConcepteur de flux.
2. Sélectionnez Connexions.
3. Dans le champ Rechercher toutes les connexions, saisissez <kbd class="ph userinput">Vonage</kbd>.
4. Sur la carte Vonage, sélectionnez Afficher les détails.
5. Sélectionnez Configurer.
6. Remplissez le formulaire.  
   {#configure-connection-record-for-vonage-alias__table_vpl_zd3_5yb__entry__2}

   | Champ | Description |
   |-|-|
   | Nom de la connexion | Nom par défaut et en lecture seule de l'enregistrement de connexion. Pour fournir un nom personnalisé à l'enregistrement de connexion, créez un enregistrement de connexion en sélectionnant Ajouter une connexion. |
   | URL de connexion | L'URL pour se connecter à l'API Vonage. |
   | Version de l'API de messages | Version des API demandées par l'enregistrement de connexion pour l'utilisation de la fonctionnalité SMS dans l'instance Vonage. |
   | Version de l'API vocale | Version des API demandées par l'enregistrement de connexion pour l'utilisation de la fonctionnalité Fonctions vocales dans l'instance Vonage. |
   | Nom des informations d'identification | Nom de l'enregistrement d'informations d'identification. Le nom par défaut des informations d'identification Vonage que vous pouvez mettre à jour. |
   | Nom d'application | Nom du compte que vous avez renseigné dans la page Paramètres du compte développeur Vonage. |
   | Clé API | Clé API que vous avez acquise dans l'instance de développeur Vonage. |
   | Secret API | Clé secrète API que vous avez acquise dans l'instance de développeur Vonage. |
   | Signature Secret | Clé secrète de signature que vous avez acquise dans l'instance de développeur Vonage. |
   [Tableau 1. Créer une connexion]

   {#configure-connection-record-for-vonage-alias__table_vpl_zd3_5yb}
7. Sélectionnez Créer une connexion.

## Configurer l'enregistrement de connexion pour Vonage Alias primaire {#ariaid-title4}

Configurez un enregistrement de connexion qui permet à votre instance de se connecter à l'instance ServiceNowVonage et d'automatiser diverses actions sur l'instance Vonage . Par exemple, créez un flux qui permet d'obtenir Studio de workflow le solde de votre Vonage compte.

### Avant de commencer

Rôle requis : administrateur  
Remarque :  
Assurez-vous que vous êtes dans le périmètre du spoke Vonage .

### Procédure

1. Accédez à la ToutAutomatisation des processusConcepteur de flux.
2. Sélectionnez Connexions.
3. Dans le champ Rechercher toutes les connexions, saisissez <kbd class="ph userinput">Vonage</kbd>.
4. Sur la carte VonagePrincipal, sélectionnez Afficher les détails.
5. Sélectionnez Configurer.
6. Remplissez le formulaire.  
   {#configure-connection-record-for-vonage-primary-alias__table_vpl_zd3_5yb__entry__2}

   | Champ | Description |
   |-|-|
   | Nom de la connexion | Nom par défaut et en lecture seule de l'enregistrement de connexion. Pour fournir un nom personnalisé à l'enregistrement de connexion, créez un enregistrement de connexion en sélectionnant Ajouter une connexion. |
   | URL de connexion | L'URL pour se connecter à l'API Vonage. Entrez <https://rest.nexmo.com>. |
   | Clé API | Clé API que vous avez acquise dans l'instance de développeur Vonage. |
   | Secret API | Clé secrète API que vous avez acquise dans l'instance de développeur Vonage. |
   [Tableau 2. Créer une connexion]

   {#configure-connection-record-for-vonage-primary-alias__table_vpl_zd3_5yb}
7. Sélectionnez Créer une connexion.
{#configure-connection-record-for-vonage-primary-alias__steps_hft_jxd_vyb}

## Créer un webhook pour recevoir des données de Vonage {#ariaid-title5}

Configurez des webhooks pour les SMS afin de permettre à la plateforme d'API Vonage d'envoyer des données à votre instance ServiceNow. Par exemple, si un flux de votre instance ServiceNow envoie une demande d'API pour obtenir les détails de l'appel à l'API Vonage, mais que la demande échoue initialement, le webhook garantit que l'API Vonage envoie les données ultérieurement.

### Avant de commencer

Rôle requis : admin.

### Procédure

1. Accédez à la ToutSpoke VonageRegistres Webhook Vonage.
2. Sélectionnez Nouveau.
3. Renseignez ces champs du formulaire.  
   {#create-sms-webhook__table_smp_4jf_pmb__entry__2}

   | Champ | Description |
   |-|-|
   | Nom | Nom permettant d'identifier de façon unique l'enregistrement webhook. |
   | Description | Description de l'enregistrement webhook. |
   | Type d'événement | Type d'événement pour lequel le webhook est configuré. Sélectionnez SMS. |
   | Clé secrète | Clé secrète pour authentifier les demandes webhook. Saisissez votre clé secrète personnalisée. |
   [Tableau 3. Formulaire Registre Webhook Vonage]

   {#create-sms-webhook__table_smp_4jf_pmb}
4. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis sélectionnez Enregistrer.
5. Sélectionnez URL de rappel.  
   Le système affiche l'URL de rappel webhook.
6. Copiez et enregistrez l'URL de rappel webhook.
7. Connectez-vous à <https://developer.vonage.com/en/home>.
8. Dans le panneau de gauche, sous Créer et gérer, sélectionnez Applications.
9. Sur la page Vos applications, sélectionnez l'icône de menu ( ![icône Menu)]()de votre application.
10. Sélectionnez Modifier.
11. Sous l'en-tête Messages, saisissez l'URL de rappel dans les champs URL entrante et URL d'état.
12. Sur le panneau de gauche, sélectionnez Paramètres de l'API.
13. Sur la page Paramètres, sous l'en-tête Paramètres SMS, assurez-vous d'avoir sélectionné l'API SMS.
14. Renseignez les valeurs.  
    {#create-sms-webhook__table_r5h_wkf_pmb__entry__2}

    | Champ | Valeur |
    |-|-|
    | Webhooks des accusés de réception (DLR) | URL de rappel webhook |
    | Webhooks SMS entrants | URL de rappel webhook |
    [ ]

    {#create-sms-webhook__table_r5h_wkf_pmb}
15. Sélectionnez Enregistrer les modifications.  
    Les paramètres SMS de l'application sont enregistrés.

## Personnaliser les webhooks et les politiques d'acheminement {#ariaid-title6}

Personnalisez la politique d'acheminement du webhook et le flux secondaire selon vos besoins.

### Avant de commencer

Rôle requis : administrateur

### Procédure

1. Accédez à la ToutConcepteur de fluxConcepteur.
2. Cliquez sur Flux secondaires.
3. Créez une copie du flux secondaire par défaut requis.
4. Personnalisez le flux secondaire selon vos besoins et publiez-le.  
   Pour plus d'informations sur la création et l'utilisation de flux secondaires, consultez [Création de flux secondaires](https://www.servicenow.com/docs/access?context=subflows&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US) et [Spoke Vonage](https://servicenow-prod.fluidtopics.net/cel7WcmzZD4tSnocw~T28Q "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.") sur les champs pris en charge par la politique d'acheminement et les flux secondaires par défaut.
5. Accédez à la Spoke VonagePolitique d'acheminement du webhook Vonage.
6. Cliquez sur Nouveau.
7. Renseignez les champs du formulaire.  
   {#cust-routing-vonage__table_awj_xgv_z3b__entry__2}

   | Champ | Description |
   |-|-|
   | Étiquette | Étiquette unique pour identifier la politique d'acheminement. |
   | Réponse par défaut | Option permettant de spécifier s'il s'agit de la réponse par défaut. La réponse par défaut s'applique lorsque les conditions ne sont pas remplies. 1. Cliquez sur l'icône de recherche ( ![icône de recherche]()). 2. Sélectionnez le flux secondaire requis dans la liste Document. Remarque : Assurez-vous que le nom de la table est <kbd class="ph userinput">Flux [sys_hub_flow].</kbd> {#cust-routing-vonage__ol_sdf_ftb_1jb} |
   | Condition | Conditions à remplir lorsque les événements requis se produisent dans Vonage. Les champs pris en charge Vonage sont les 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 {#cust-routing-vonage__ul_yks_qpf_pmb} |
   | Réponse | Flux secondaire qui doit être déclenché lorsque les conditions spécifiées sont remplies. |
   [Tableau 4. Formulaire Décision]

   {#cust-routing-vonage__table_awj_xgv_z3b}
8. Cliquez sur Envoyer.  
   Remarque :  
   Ces politiques d'acheminement sont enregistrées dans les tables de décision. Les utilisateurs sont mis en garde contre la mise à jour ou la modification directe des données de ces tables.
{#cust-routing-vonage__steps_vjr_z4f_pmb}