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.4 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 ServiceNowInstanz. Folgende Aktionen sind verfügbar:


Kategorie	Aktion	Beschreibung
Account-Verwaltung	Kontosaldo Abrufen	Ruft den aktuellen Saldo von ab Vonage Account.
Anrufverwaltung	DTMF-Ton in Anruf wiedergeben	Gibt DTMF-Töne (Dual-tone Multifrequency) in einem aktiven Anruf wieder
	Aufzeichnung An Anhängen ServiceNowDatensatz	Hängt eine Anrufaufzeichnung an das Ziel an ServiceNowDatensatz.
	Erstellen Sie Einen Ausgehenden Anruf	Erstellt einen ausgehenden Anruf an eine Telefonnummer.
	Generieren Sie NCCO	Erstellt ein Nexmo-Anrufsteuerungsobjekt (Call Control Objects, NCCO), das in der Aktion „ausgehenden Anruf erstellen“ verwendet wird.
	Ruft Anrufdetails Ab	Ruft die Details des angegebenen Anrufs ab.
	Anrufe suchen	Ruft Details der angegebenen Anrufe ab.
	Audio in Anruf wiedergeben	Gibt eine Audiodatei in einem aktiven Anruf wieder.
	Geben Sie Text-zu-Sprache in Anruf ab	Gibt Text-zu-Sprache in einem aktiven Anruf wieder.
	Audiowiedergabe in Anruf beenden	Stoppt die Wiedergabe einer Audiodatei in einem aktiven Anruf.
	Text-zu-Sprache im Anruf anhalten	Stoppt Text-to-Speech in einem aktiven Anruf.
	Anruf Aktualisieren	Aktualisiert den Status eines aktiven Anrufs.
Nummernverwaltung	Suchen Sie nach Ihren eigenen Nummern	Ruft alle eingehenden Nummern ab, die dem Vonage-Account zugeordnet sind.
SMS-Verwaltung	SMS senden	Sendet eine SMS (Kurzwahlservice) an eine Telefonnummer.
WhatsApp Verwaltung	Kontakte Senden	Sendet Kontakte an 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 Mit Vorlage Senden	Sendet eine Textnachricht mithilfe der Vorlage an einen WhatsApp Nummer.

Spoke-Modul

Bidirektionale Webhooks können so eingerichtet werden, dass sie über die erforderlichen Ereignisse benachrichtigt werden. Die Weiterleitungsrichtlinie definiert Bedingungen, die erfüllt sein müssen, um zu benachrichtigen ServiceNowInstanz. 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, der wiederum automatisiert Vonage Aufgaben. Standardmäßig ist Vonage Spoke-Anwendung ist verfügbar und verfügt über die folgenden Module:

Vonage Webhook-Registrierungen
Vonage Webhook-Weiterleitungsrichtlinien

Verwenden Sie Vonage Webhook registriert Modul, um ein Token zuzuweisen und den API-Pfad anzugeben. Sie müssen hier eine Rückruf-URL generieren und diese URL in angeben Vonage . Standardmäßige Weiterleitungsrichtlinien werden als Referenz in bereitgestellt Vonage Webhook-Weiterleitungsrichtlinienmodul. 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. Durch die Verwendung eines Alias müssen bei der Verwendung mehrerer Umgebungen nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfiguriert werden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie keine Aktionen aktualisieren, die die Verbindung verwenden. 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.