Vonage-Spoke

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer

    • Verwalten Sie die Kommunikation über Anrufe, SMS und WhatsApp-, indem Sie den Account Vonage in Ihrer Instanz von ServiceNow verwenden.

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

    Unterstützte Versionen

    Diese Spoke wurde für Vonage für diese Versionen erstellt, ist jedoch möglicherweise mit späteren Versionen kompatibel:
    • Nachrichten-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-Subflows

    Die Vonage-Spoke bietet Beispiel-Subflows, um die Automatisierung von Vonage -Aufgaben zu demonstrieren. Um einen Beispiel-Subflow anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Folgende Beispiel-Subflows sind verfügbar:

    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 entsprechend 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 in Ihrer Instanz von ServiceNow Ereignisse auftreten. Folgende Aktionen sind verfügbar:

    Kategorie Aktion Beschreibung
    Account-Verwaltung Account-Saldo abrufen Ruft den aktuellen Saldo des Vonage -Accounts ab.
    Anrufverwaltung DTMF-Ton in Anruf abspielen Gibt DTMF-Töne (Dual-Tone Multi-Frequency) in einem aktiven Anruf wieder
    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 Nummer WhatsApp-.
    Textnachricht senden Sendet eine Textnachricht an eine Nummer WhatsApp-.
    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 Ereignisse benachrichtigt werden. Die Weiterleitungsrichtlinie definiert Bedingungen, die erfüllt sein müssen, um die Instanz ServiceNow zu benachrichtigen. 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 die Aufgaben Vonage automatisiert. Standardmäßig ist die Spoke-Anwendung Vonage verfügbar und verfügt über die folgenden Module:
    • Vonage Webhook-Registrierungen
    • Vonage WebHook-Weiterleitungsrichtlinien
    Verwenden Sie das Modul Vonage Webhook-Registrierungen, um ein Token zuzuweisen und den API-Pfad anzugeben. Sie müssen hier eine Rückruf-URL generieren und diese URL in Vonageangeben. Standardroutingrichtlinien werden als Referenz im Modul Vonage WebHook Routing Policies (WebHook-Routing-Richtlinien) bereitgestellt. Passen Sie diese Weiterleitungsrichtlinien an Ihre 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 der Spoke Vonage verfügbar:
    Vonage Alias Beschreibung
    VonagePrimary Erforderlich für die Aktionen zum Verwalten von SMS, Nummer und Account.
    Vonage Erforderlich für die Aktionen zum Verwalten von Anrufen und WhatsApp-.

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