Vonage-Spoke

Apps im Store anfordern

Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.

IntegrationHub-Abonnement

Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.

Spoke-Version

Vonage-Spoke V 1.1.5 Ist die neueste Version.

Unterstützte Versionen

Diese Spoke wurde für erstellt Vonage Für diese Versionen, kann jedoch mit späteren Versionen kompatibel sein:

Nachrichten-API Version v0.1
Sprach-API Version v1

Spoke-Anforderungen

Administratorzugriff auf Vonage Account und Vonage-API-Dashboard .
Zeichnen Sie die Werte von auf API-Schlüssel Und API-Geheimnis . Sie können über auf diese Werte zugreifen Vonage API-Dashboard. Weitere Informationen finden Sie unter Authentifizierung Seite in Vonage-API-Entwickler Dokumentationswebsite.
Zeichnen Sie den Wert von auf, und speichern Sie ihn Signaturgeheimnis . Sie können auf diesen Wert in zugreifen Account-Einstellungen im Vonage API-Dashboard . Weitere Informationen finden Sie unter Authentifizierung Seite in Vonage-API-Entwickler Dokumentationswebsite.

Spoke-Abhängigkeiten

Wenn Sie Probleme beim Installieren der App haben, stellen Sie sicher, dass die folgenden abhängigen Plugins installiert sind:

ServiceNow IntegrationHub-Aktionsschritt – REST (com.Glide.Hub.action_STEP.Rest)
ServiceNow IntegrationHub-Laufzeit (com.glide.hub.integration.runtime)
Komplexes Objekt (com.Glide.cobject)
ServiceNow Flow Designer – dynamische Eingaben (com.Glide.Hub.Dynamic_input)

Hinweis:

Einige dieser Plugins sind lizenzierbare Funktionen und erfordern entsprechende Lizenzen, wenn sie außerhalb der Spoke-Implementierung verwendet werden.

Spoke-Subflows

Die Vonage-Spoke Stellt Beispielsubflows zur Demonstration der Automatisierung bereit Vonage Aufgaben. Um einen Beispiel-Subflow anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Verfügbare Beispiel-Subflows:


Subflow	Beschreibung
Vonage SMS-Webhook	Verarbeitet die SMS-Anforderungen von Vonage .
Vonage Sprachwebhook	Verarbeitet die Sprachanforderungen von Vonage .
Vonage WhatsApp Webhook	Verarbeitet WhatsApp Anforderungen von Vonage .

Um den Standard-Subflow anzupassen, müssen Sie eine Kopie des Beispiel-Subflows erstellen und den Subflow entsprechend Ihren Anforderungen anpassen. Beim Anpassen von Subflows müssen Sie sicherstellen, dass die Subflows so konfiguriert sind, dass unendliche Schleifen vermieden werden.

Spoke-Aktionen

Die Vonage-Spoke Stellt Aktionen zur Automatisierung bereit Vonage Aufgaben, wenn Ereignisse in auftreten ServiceNow Instanz. Folgende Aktionen sind verfügbar:


Kategorie	Aktion	Beschreibung
Account-Verwaltung	Account-Saldo abrufen	Ruft den aktuellen Saldo von ab Vonage Account.
Anrufverwaltung	DTMF-Ton in Anruf abspielen	Gibt DTMF-Töne (Dual-tone Multifrequency) in einem aktiven Anruf wieder
	Aufzeichnung An Anhängen ServiceNow Datensatz	Hängt eine Anrufaufzeichnung an das Ziel an ServiceNow Datensatz.
	Ausgehenden Anruf erstellen	Erstellt einen ausgehenden Anruf an eine Telefonnummer.
	NCCO generieren	Erstellt ein Nexmo-Anrufsteuerungsobjekt (Nexmo Call Control Object, NCCO), das in der Aktion Ausgehenden Anruf erstellen verwendet wird.
	Anrufdetails abrufen	Ruft die Details des angegebenen Anrufs ab.
	Anrufe suchen	Ruft Details angegebener Anrufe ab.
	Audio in Anruf wiedergeben	Spielt eine Audiodatei in einem aktiven Anruf ab.
	Text-zu-Sprache in Anruf wiedergeben	Gibt Text-zu-Sprache in einem aktiven Anruf wieder.
	Audio-Wiedergabe in einem Anruf stoppen	Stoppt die Wiedergabe einer Audiodatei in einem aktiven Anruf.
	Text-zu-Sprache in Anruf anhalten	Stoppt Text-zu-Sprache in einem aktiven Anruf.
	Anruf aktualisieren	Aktualisiert den Status eines aktiven Anrufs.
Nummernverwaltung	Nach eigenen Nummern suchen	Ruft alle eingehenden Nummern ab, die dem Vonage-Konto zugeordnet sind.
SMS-Verwaltung	SMS senden	Sendet eine SMS (Short Message Service) an eine Telefonnummer.
WhatsApp Verwaltung	Kontakte senden	Sendet Kontakte an einen WhatsApp Nummer.
	Standort senden	Sendet geografische Koordinaten eines Standorts an einen WhatsApp Nummer.
	Mediennachricht senden	Sendet eine Mediennachricht an einen WhatsApp Nummer.
	Textnachricht senden	Sendet eine Textnachricht an einen WhatsApp Nummer.
	Textnachricht mithilfe einer Vorlage senden	Sendet eine Textnachricht mithilfe der Vorlage an einen WhatsApp Nummer.

Spoke-Modul

Bidirektionale Webhooks können eingerichtet werden, um über die erforderlichen Ereignisse benachrichtigt zu werden. Die Weiterleitungsrichtlinie definiert Bedingungen, die erfüllt sein müssen, um zu benachrichtigen ServiceNow Instanz. Diese Bedingungen basieren auf den Ereignissen in Vonage Über die Sie benachrichtigt werden möchten. Wenn die Bedingungen erfüllt sind, löst die Weiterleitungsrichtlinie den zugehörigen Subflow aus, wodurch wiederum automatisiert wird Vonage Aufgaben. Standardmäßig ist Vonage Die Spoke-Anwendung ist verfügbar und verfügt über die folgenden Module:

Vonage Webhook-Registrierungen
Vonage Webhook-Weiterleitungsrichtlinien

Verwenden Sie Vonage Webhook-Registrierungsmodul zum Zuweisen eines Tokens und Bereitstellen des API-Pfads. Sie müssen hier eine Rückruf-URL generieren und diese URL in angeben Vonage . Standardmäßige Weiterleitungsrichtlinien werden als Referenz in bereitgestellt Vonage Modul „Webhook-Weiterleitungsrichtlinien“. Passen Sie diese Weiterleitungsrichtlinien entsprechend Ihren Anforderungen an. Die Weiterleitungsrichtlinie unterstützt diese Felder:

Stichwörter
Anrufrichtung
Anrufstatus
Ereignistyp
Von
SMS-Status
SMS-Text
An
WhatsApp Nachrichtenstatus
WhatsApp Text
Zugehörige Felder anzeigen

Alias-Anforderungen für Verbindungen und Anmeldeinformationen

IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren. Weitere Informationen finden Sie unter Connections and Credentials.

Zwei Aliasse für Verbindungen und Anmeldeinformationen sind zusammen mit verfügbar Vonage Spoke:


Vonage Alias	Beschreibung
VonagePrimär	Erforderlich für die Aktionen, die SMS, Nummer und Account verwalten.
Vonage	Erforderlich für die Aktionen, die Anrufe und verwalten WhatsApp .

Informationen zum Einrichten der Spoke finden Sie unter Richten Sie ein Vonage-Spoke.