Vonage-Spoke

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer

    • Verwalten Sie die Kommunikation über Anrufe, SMS und WhatsApp mithilfe des Kontos Vonage in Ihrer Instanz ServiceNow.

    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 v1.1.3 ist die neueste Version.

    Unterstützte Versionen

    Diese Spoke wurde für Vonage für die folgenden Versionen erstellt, ist jedoch möglicherweise mit späteren Versionen kompatibel:
    • Messages-API, Version v0.1
    • Sprach-API, Version v1

    Spoke-Anforderungen

    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_inputs)
    Hinweis:
    Einige dieser Plugins sind lizenzierbare Funktionen und erfordern entsprechende Lizenzen, wenn sie außerhalb der Spoke-Implementierung verwendet werden.

    Spoke-Unterabläufe

    Die Vonage-Spoke bietet Beispiel-Subflows, um die Automatisierung von Vonage -Aufgaben zu demonstrieren. Um einen Beispiel-Unterablauf anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Verfügbare Beispiel-Unterabläufe umfassen Folgendes:

    Subflow Beschreibung
    Vonage SMS-Webhook Verarbeitet die SMS-Anforderungen von Vonage.
    Vonage Sprach-Webhook Verarbeitet die Sprachanforderungen von Vonage.
    Vonage WhatsApp Webhook Verarbeitet die WhatsApp -Anforderungen von Vonage.
    Um den Standard-Subflow anzupassen, müssen Sie eine Kopie des Beispiel-Subflows erstellen und den Subflow gemäß Ihren Anforderungen anpassen. Beim Anpassen von Subflows müssen Sie sicherstellen, dass die Subflows so konfiguriert sind, dass Endlosschleifen vermieden werden.

    Spoke-Aktionen

    Die Vonage-Spoke bietet Aktionen zum Automatisieren von Vonage -Aufgaben, wenn Events in Ihrer ServiceNow -Instanz auftreten. Folgende Aktionen sind verfügbar:

    Kategorie Aktion Beschreibung
    Account-Verwaltung Account-Saldo abrufen Ruft den aktuellen Saldo des Vonage -Kontos ab.
    Anrufverwaltung DTMF-Ton in Anruf abspielen Spielt DTMF-Töne (Dual-Tone Multi-Frequency) in einem aktiven Anruf ab
    Aufzeichnung an Datensatz ServiceNow anhängen Hängt eine Anrufaufzeichnung an den Zieldatensatz ServiceNow an.
    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 eine WhatsApp Nummer.
    Standort senden Sendet geografische Koordinaten eines Standorts an eine WhatsApp -Nummer.
    Mediennachricht senden Sendet eine Mediennachricht an eine WhatsApp Nummer.
    Textnachricht senden Sendet eine Textnachricht an eine WhatsApp Nummer.
    Textnachricht mithilfe einer Vorlage senden Sendet eine Textnachricht mithilfe der Vorlage an eine WhatsApp -Nummer.

    Spoke-Modul

    Bidirektionale Webhooks können so eingerichtet werden, dass sie über die erforderlichen Events benachrichtigt werden. Die Weiterleitungsrichtlinie definiert Bedingungen, die erfüllt sein müssen, um die Instanz ServiceNow zu benachrichtigen. Diese Bedingungen basieren auf den Events in Vonage, über die Sie benachrichtigt werden möchten. Wenn die Bedingungen erfüllt sind, löst die Routing-Richtlinie den zugehörigen Subflow aus, der wiederum die Vonage -Aufgaben automatisiert. Standardmäßig ist die Spoke-Anwendung Vonage verfügbar und verfügt über die folgenden Module:
    • Vonage Webhook-Registrierungen
    • Vonage WebHook-Routing-Richtlinien
    Verwenden Sie das Modul Vonage Webhook-Registrierungen, um ein Token zuzuweisen und den API-Pfad bereitzustellen. Sie müssen hier eine Rückruf-URL generieren und diese URL in Vonageangeben. Standard-Routing-Richtlinien werden als Referenz im Modul Vonage WebHook-Routing-Richtlinien bereitgestellt. Passen Sie diese Weiterleitungsrichtlinien gemäß Ihren Anforderungen an. Die Routing-Richtlinie unterstützt die folgenden Felder:
    • Stichwörter
    • Anrufrichtung
    • Anrufstatus
    • Ereignistyp
    • Von
    • SMS-Status
    • SMS-Text
    • Zweck
    • 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.

    Zusammen mit der Spoke Vonage sind zwei Aliasse für Verbindungen und Anmeldeinformationen verfügbar:
    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 WhatsAppverwalten.

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