Vonage Spoke
Gérez les communications par téléphone, SMS et WhatsApp à l’aide du Vonage compte de votre ServiceNow instance.
Demander des applications dans l'App Store
Visitez le ServiceNow Store pour afficher toutes les applications disponibles et pour obtenir des informations sur la soumission de demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les ServiceNow Store notes de publication relatives à l'historique des versions.
Abonnement à Centre d'intégration
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.
Version de spoke
Vonage spoke v2.0.0 est la dernière version.
Versions prises en charge
Ce spoke a été conçu pour Vonage ces versions, mais peut être compatible avec les versions ultérieures :
- Version de l’API de messages v1
- Version v1 de l’API vocale
Exigences relatives au spoke
- Accès administrateur au compte et au tableau de bord de l’APIVonage Vonage.
- Enregistrez les valeurs de clé API et de secret API. Vous pouvez accéder à ces valeurs à partir du tableau de bord des Vonage API. Pour plus d’informations, consultez la page Authentification du site de documentation du développeur API Vonage .
- Enregistrez et enregistrez la valeur du secret de signature. Vous pouvez accéder à cette valeur dans les paramètres de compte du tableau de bord des API Vonage. Pour plus d’informations, consultez la page Authentification du site de documentation du développeur API Vonage .
Dépendances des spokes
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 Moteur d’exécution du Centre d’intégration (com.glide.hub.integration.runtime)
- Objet complexe (com.glide.cobject)
- ServiceNow Concepteur de flux : entrées dynamiques (com.glide.hub.dynamic_inputs)
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
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. Exemples de flux secondaires disponibles :
| Flux secondaire | Description |
|---|---|
| Vonage SMS Webhook | Traite les demandes SMS de Vonage. |
| Vonage Webhook vocal | Traite les demandes vocales de Vonage. |
| Vonage WhatsApp Webhook | Traite les WhatsApp demandes de Vonage. |
Déclencheurs de spokes
Utilisez des déclencheurs dans le spoke Vonage pour vous abonner aux événements requis. Le point de terminaison active les webhooks pour se connecter à votre instance ServiceNow. Vous pouvez configurer les flux pour qu’ils s’exécutent uniquement lorsque les conditions de déclenchement spécifiées sont remplies. Les événements pris en charge sont les suivants :
Pour plus d’informations sur la configuration des déclencheurs pour le spoke Vonage, consultez Configurer le déclencheur pour le spoke Vonage.
| Catégorie | Déclencheur | Description |
|---|---|---|
| Gestion des appels | Sonnerie vocale | Le déclencheur est lancé lorsqu’un appel est effectué à partir de Vonage et que le numéro est en sonnerie. |
| A reçu une réponse vocale | Le déclencheur est lancé lorsqu’un appel est effectué à partir de Vonage et que l’appel est répondu. | |
| Fonctions vocales terminées | Le déclencheur est lancé lorsqu’un appel est effectué à partir de Vonage et que l’appel est terminé. | |
| Gestion SMS | SMS remis | Le déclencheur est lancé lorsqu’un SMS est envoyé depuis Vonage à un numéro. |
| Échec du SMS | Le déclencheur est lancé lorsqu’un SMS est envoyé à partir de Vonage et qu’il échoue. | |
| SMS accepté | Le déclencheur est lancé lorsqu’un message a été accepté pour remise, mais qu’il n’a pas encore été remis. |
Actions du spoke
Le spoke Vonage fournit des actions pour automatiser Vonage les tâches lorsque des événements se produisent dans votre ServiceNow instance. Les actions disponibles sont les suivantes :
| 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 |
| Joindre un enregistrement à l’enregistrement ServiceNow | Joint un enregistrement d’appel à l’enregistrement cible ServiceNow . | |
| Créer un appel sortant | Crée un appel sortant vers un numéro de téléphone. | |
| Générer un NCCO | Construit un objet de contrôle d’appel Nexmo (NCCO) utilisé dans l’action Créer un appel sortant. | |
| Générer un NCCO de connexion | Génère un objet de contrôle d’appel Nexmo (NCCO) qui définit comment connecter un appel sortant à des points de terminaison tels qu’un numéro de téléphone ou WebSocket. | |
| Générer une notification NCCO | Génère un objet de contrôle d’appel Nexmo (NCCO) qui définit une action de notification pour un appel sortant. | |
| Générer un NCCO de transfert | Génère un objet de contrôle d’appel Nexmo (NCCO) qui définit le mode de transfert d’un appel actif. | |
| Rechercher les détails de l’appel | Récupère les détails de l’appel spécifié. | |
| Rechercher des appels | Récupère les détails des appels spécifiés. | |
| Lire l’audio dans l’appel | Lit un fichier audio lors d’un appel actif. | |
| Utiliser la synthèse vocale dans l’appel | Joue la synthèse vocale dans un appel actif. | |
| Arrêter de lire le son dans l’appel | Arrête la lecture d’un fichier audio lors d’un appel actif. | |
| Arrêter la synthèse vocale dans l’appel | Arrête la synthèse vocale dans un appel actif. | |
| Mettre à jour l’appel | Met à jour l’état d’un appel actif. | |
| Gestion des numéros | Rechercher des numéros | Récupère tous les numéros entrants associés au compte Vonage. |
| Gestion RCS Remarque : Si vous effectuez une mise à niveau à partir d’une version antérieure du spoke, assurez-vous de générer un nouveau jeton JWT dans votre enregistrement d’informations d’identification existant avant d’utiliser ces actions de catégorie. |
Envoyer un message de carte RCS | Envoie un message de carte RCS (Rich Communication Services) à un numéro de téléphone spécifié. |
| Envoyer un message de média RCS | Envoie un message média RCS (Rich Communication Services) à un numéro de téléphone spécifié. | |
| Envoyer un message texte RCS | Envoie un message texte RCS (Rich Communication Services) à un numéro de téléphone spécifié. | |
| Gestion SMS | Envoyer SMS | Envoie un SMS à un numéro de téléphone. |
| WhatsApp Gestion Remarque : Si vous effectuez une mise à niveau à partir d’une version antérieure du spoke, assurez-vous de générer un nouveau jeton JWT dans votre enregistrement d’informations d’identification existant avant d’utiliser ces actions de catégorie. |
Envoyer des contacts | Envoie des contacts à un WhatsApp numéro. |
| Envoyer l’emplacement | Envoie les coordonnées géographiques d’un emplacement à un WhatsApp numéro. | |
| Envoyer un message de média | Envoie un message média à un WhatsApp numéro. | |
| Envoyer un message texte | Envoie un message texte à un WhatsApp numéro. | |
| Envoyer un message texte à l’aide d’un modèle | Envoie un message texte à l’aide du modèle à un WhatsApp numéro. |
Module de spoke
Des webhooks bidirectionnels peuvent être configurés pour être avertis 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 Vonage dont vous voulez être notifié. Lorsque les conditions sont remplies, la politique d’acheminement déclenche le flux secondaire associé, qui à son tour automatise les Vonage tâches. Par défaut, l’application Vonage Spoke est disponible et comporte les modules suivants :
- Vonage Registres Webhook
- Vonage Politiques d’acheminement de WebHook
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 Vonage WebHook. Personnalisez ces politiques d’acheminement en fonction de vos besoins. La politique d’acheminement prend en charge ces champs :
- Mots clés
- Direction de l’appel
- État de l'appel
- Type d'événement
- De
- Statut SMS
- SMS
- À
- WhatsApp État du message
- WhatsApp Text (Texte)
- Afficher les champs connexes
Exigences en matière d'alias de connexion et d'informations d'identification
Centre 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.
Deux alias de connexion et d’informations d’identification sont disponibles avec le Vonage spoke :
| Vonage alias | Description |
|---|---|
| VonagePrimaire | Requis pour les actions qui gèrent SMS, numéro et compte. |
| Vonage | Requis pour les actions qui gèrent les appels et WhatsApp. |
Pour en savoir plus sur la configuration du spoke, consultez Configurer le spoke Vonage.