Vonage Spoke

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.

Pour personnaliser le flux secondaire par défaut, vous devez créer une copie de l’exemple de flux secondaire et personnaliser le flux secondaire selon vos besoins. Lors de la personnalisation des flux secondaires, vous devez vous assurer que les flux secondaires sont configurés pour éviter les boucles infinies.

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 :


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.

Pour plus d’informations sur la configuration des déclencheurs pour le spoke Vonage, consultez Configurer le déclencheur pour le spoke Vonage.

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.