Configurer le spoke Vonage

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 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

    • Demandez un Centre d'intégration abonnement.
    • Activez le module d’extension de spoke Vonage sur votre ServiceNow instance.
    • Rôle requis : admin.
    • Compte d’instance de développeur Vonage.

    Configurer l’instance de développeur Vonage

    Générez les informations d’identification essentielles, telles que les clés API, les secrets et les secrets 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 : admin

    Accès à un Vonage compte développeur.

    Procédure

    1. Connectez-vous à https://developer.vonage.com/en/home.
    2. Sur la page Centre de Vonage développement, sélectionnez Mon tableau de bord.Page Mon tableau de bord.
    3. Sur la page Tableau de bord des Vonage API, 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 et le secret API par défaut, copiez la clé API par défaut et les valeurs secrètes API.Bouton Copier pour la clé API et le secret API.
      2. Pour générer une clé API et un secret API personnalisés, sélectionnez Paramètres d’API dans le panneau de gauche.Lien vers les 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.
    4. Dans le champ Secret de signature, copiez le secret de signature.

    Configurer l’enregistrement de connexion pour l’alias de connexion et d’informations d’identification Vonage

    Configurez un enregistrement de connexion qui permet à votre ServiceNow instance de se connecter à l’instance et d’automatiser Vonage diverses actions sur l’instance Vonage . Par exemple, créez un flux qui Studio de workflow récupère le solde de votre Vonage compte.

    Avant de commencer

    Rôle requis : admin
    Remarque :
    Assurez-vous d’être dans le périmètre du spoke Vonage .

    Procédure

    1. Accédez à la Tous > Automatisation des processus > Concepteur de flux.
    2. Sélectionnez Connexions.
    3. Dans le champ Rechercher toutes les connexions, saisissez Vonage.Champ Rechercher toutes les connexions.
    4. Sur la carte Vonage, sélectionnez Afficher les détails.
    5. Sélectionnez Configurer.
    6. Remplissez le formulaire.
      Tableau 1. Créer une connexion
      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 La version des API que l’enregistrement de connexion demande pour l’utilisation de la fonctionnalité SMS dans l’instance Vonage.
      Version de l’API vocale La version des API demandées par l’enregistrement de connexion pour l’utilisation de la fonctionnalité Voice dans l’instance Vonage.
      Nom des informations d'identification Nom de l’enregistrement d’informations d’identification. Le nom par défaut est l’identifiant Vonage que vous pouvez mettre à jour.
      Nom de l'application Nom du compte que vous aviez saisi dans la page Paramètres du compte de développeur Vonage.Champ Nom de compte sur l’instance 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.
    7. Sélectionnez Créer une connexion.

    Configurer l’enregistrement de connexion pour l’alias primaire Vonage

    Configurez un enregistrement de connexion qui permet à votre ServiceNow instance de se connecter à l’instance et d’automatiser Vonage diverses actions sur l’instance Vonage . Par exemple, créez un flux qui Studio de workflow récupère le solde de votre Vonage compte.

    Avant de commencer

    Rôle requis : admin
    Remarque :
    Assurez-vous d’être dans le périmètre du spoke Vonage .

    Procédure

    1. Accédez à la Tous > Automatisation des processus > Concepteur de flux.
    2. Sélectionnez Connexions.
    3. Dans le champ Rechercher toutes les connexions, saisissez Vonage.Champ Rechercher toutes les connexions.
    4. Sur la carte VonagePrincipal, sélectionnez Afficher les détails.
    5. Sélectionnez Configurer.
    6. Remplissez le formulaire.
      Tableau 2. Créer une connexion
      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.
    7. Sélectionnez Créer une connexion.

    Créer un webhook pour recevoir des données de Vonage

    Configurez des webhooks pour SMS afin de permettre à la plateforme 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 les détails de l’appel à l’API Vonage, mais que la demande échoue initialement, le webhook s’assure que l’API Vonage envoie les données ultérieurement.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tous > Spoke Vonage > Registres webhook Vonage.
    2. Sélectionnez Nouveau.
    3. Renseignez ces champs du formulaire.
      Tableau 3. Formulaire du registre Webhook Vonage
      Champ Description
      Nom Nom permettant d’identifier l’enregistrement webhook de façon unique.
      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 de webhook. Saisissez votre clé secrète personnalisée.
    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 Construire et gérer, sélectionnez Applications.Lien Applications sous Build & Manage.
    9. Sur la page Vos applications, sélectionnez l’icône de menu ( icône Menu.) de votre application.Mon application.
    10. Sélectionnez Modifier.
    11. Sous l’en-tête Messages, entrez l’URL de rappel dans les champs URL entrante et URL d’état.Paramètres des messages.
    12. Sur le panneau de gauche, sélectionnez Paramètres d’API.
    13. Sur la page Paramètres, sous l’en-tête Paramètres SMS, assurez-vous d’avoir sélectionné API SMS.
    14. Renseignez les valeurs.
      Champ Valeur
      Webhooks de reçus de remise (DLR) URL de rappel webhook
      Webhooks SMS entrants URL de rappel webhook
    15. Sélectionnez Enregistrer les modifications.
      Les paramètres SMS de l’application sont enregistrés.

    Personnaliser les webhooks et les politiques d’acheminement

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

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Concepteur de flux > Concepteur.
    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.
      Consultez Création de flux secondaires pour plus d’informations sur la création et l’utilisation de flux secondaires et Spoke Vonage pour plus d’informations sur les champs pris en charge par la politique d’acheminement et les flux secondaires par défaut.
    5. Accédez à la Spoke Vonage > Politique d’acheminement du webhook Vonage.
    6. Cliquez sur Nouveau.
    7. Remplissez les champs du formulaire.
      Tableau 4. Formulaire Décision
      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 Documents.
        Remarque :
        Assurez-vous que le nom de la table est Flux [sys_hub_flow].
      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
      • Statut de l'appel
      • Type d'événement
      • De
      • Statut SMS
      • SMS
      • À
      • WhatsApp État du message
      • WhatsApp SMS
      • Afficher les champs connexes
      Réponse Flux secondaire qui doit être déclenché lorsque les conditions spécifiées sont remplies
    8. Cliquez sur Envoyer.
      Remarque :
      Ces politiques d’acheminement sont enregistrées dans les tables de décision. Les utilisateurs sont avertis de ne pas mettre à jour ou modifier directement les données de ces tables.