Spoke Vonage

Demander des applications dans l'App Store

Visitez le site Web ServiceNow Store 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.

Abonnement à Hub 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 v1.1.4 est la dernière version.

Versions prises en charge

Ce spoke a été conçu Vonage pour ces versions, mais peut être compatible avec les versions ultérieures :

Version de l’API de messages v0.1
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 de l’API Vonage . Pour plus d’informations, consultez la page Authentification sur le site de documentation du développeur d’API Vonage .
Enregistrez et enregistrez la valeur du secret de signature. Vous pouvez accéder à cette valeur dans les paramètres du compte dans le tableau de bord de l’API Vonage. Pour plus d’informations, consultez la page Authentification sur le site de documentation du développeur d’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 Flow Designer : 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 à partir 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.

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 l’enregistrement à ServiceNow l’enregistrement	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.
	Obtenir 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 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 Gestion	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 averti 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 dont Vonage vous souhaitez ê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 selon 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
État SMS
SMS
Vers
WhatsApp État du message
WhatsApp SMS
Afficher les champs connexes

Exigences en matière d'alias de connexion et d'informations d'identification

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.

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 les SMS, le numéro et le 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.