Richten Sie ein Vonage-Spoke

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 5 Minuten Lesedauer

    • Integrieren Sie Ihr ServiceNow Instanz mit Vonage Instanz zum Aktivieren der Kommunikation zwischen ihnen. Mit dieser Integration ist Ihr ServiceNow Instanz kann Aktionen auf automatisieren Vonage Instanz, während Vonage Instanz kann Nutzlasten an senden ServiceNow Instanz.

    Vorbereitungen

    • Fordern Sie an IntegrationHub Abonnement.
    • Aktivieren Sie Vonage-Spoke Plugin auf Ihrem ServiceNow Instanz.
    • Erforderliche Rolle: admin.
    • Vonage-Entwicklerinstanz-Account.

    Konfigurieren Sie die Vonage-Entwicklerinstanz

    Generieren Sie wichtige Anmeldeinformationen, z. B. API-Schlüssel, Geheimnisse und Signaturgeheimnisse, um Ihren einzurichten Vonage Entwicklerinstanz. Ihr ServiceNow Die Instanz verwendet diese Anmeldeinformationen im Verbindungsdatensatz, um eine Verbindung mit herzustellen Vonage Entwicklerinstanz.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Zugriff auf Vonage Entwickler-Account.

    Prozedur

    1. Melden Sie sich bei https://developer.vonage.com/en/home an.
    2. Auf der Vonage Developer Center-Seite wählen Sie mein Dashboard aus.Meine Dashboard-Seite.
    3. Auf der Vonage API-Dashboard-Seite verwenden Sie den Standard-API-Schlüssel und das API-Geheimnis, oder erstellen Sie Ihren anwenderdefinierten API-Schlüssel und das API-Geheimnis.
      1. Um den Standard-API-Schlüssel und das API-Geheimnis zu verwenden, kopieren Sie den Standard-API-Schlüssel und die geheimen API-Werte.Schaltfläche „Kopieren“ für API-Schlüssel und API-Geheimnis.
      2. Um einen anwenderdefinierten API-Schlüssel und ein API-Geheimnis zu generieren, wählen Sie im linken Bereich API-Einstellungen aus.Link zu API-Einstellungen.
      3. Wählen Sie Aus Fordern Sie weitere API-Schlüssel an .
      4. Füllen Sie das Formular aus, und übermitteln Sie es.
      5. Wählen Sie Aus Erstellen Sie ein neues Geheimnis .
      6. Geben Sie im Fenster Neues Geheimnis hinzufügen Ihr anwenderdefiniertes Geheimnis ein.
      7. Wählen Sie Speichern.
    4. Kopieren Sie das Signaturgeheimnis aus dem Feld Signaturgeheimnis.

    Konfigurieren Sie den Verbindungsdatensatz für den Vonage-Alias für Verbindungen und Anmeldeinformationen

    Konfigurieren Sie einen Verbindungsdatensatz, der Ihren ermöglicht ServiceNow Instanz, mit der eine Verbindung hergestellt werden soll Vonage Führen Sie eine Instanz aus, und automatisieren Sie verschiedene Aktionen auf dem Vonage Instanz. Erstellen Sie beispielsweise einen Flow für Workflow-Studio Das hat Ihre Vonage Kontosaldo.

    Vorbereitungen

    Erforderliche Rolle: Administrator
    Hinweis:
    Stellen Sie sicher, dass Sie sich im befinden Vonage-Spoke Umfang.

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Flow Designeran.
    2. Wählen Sie Verbindungen.
    3. Geben Sie im Feld alle Verbindungen durchsuchen ein Vonage .Feld „alle Verbindungen durchsuchen“.
    4. Wählen Sie auf der Vonage-Karte aus Details Anzeigen .
    5. Wählen Sie Konfigurieren.
    6. Füllen Sie das Formular aus.
      Tabelle : 1. Verbindung erstellen
      Feld Beschreibung
      Verbindungsname Der standardmäßige und schreibgeschützte Name des Verbindungsdatensatzes. Um dem Verbindungsdatensatz einen anwenderdefinierten Namen anzugeben, erstellen Sie einen Verbindungsdatensatz, indem Sie auswählen Verbindung Hinzufügen .
      Verbindungs-URL Die URL für die Verbindung mit der Vonage-API.
      Nachrichten-API-Version Die Version der APIs, die der Verbindungsdatensatz für die Verwendung der SMS-Funktion in der Vonage-Instanz anfordert.
      Sprach-API-Version Die Version der APIs, die der Verbindungsdatensatz für die Verwendung der Sprachfunktion in der Vonage-Instanz anfordert.
      Anmeldeinformationsname Name des Anmeldeinformationsdatensatzes. Der Standardname der bs-Vonage-Anmeldeinformationen, die Sie aktualisieren können.
      Anwendungsname Name des Accounts, den Sie auf der Seite „Einstellungen“ des Vonage-Entwickler-Accounts eingegeben haben.Feld „Account-Name“ in Vonage-Instanz.
      API-Schlüssel API-Schlüssel, den Sie in der Vonage-Entwicklerinstanz erworben haben.
      Geheimer API-Schlüssel API-Geheimnis, das Sie in der Vonage-Entwicklerinstanz erworben haben.
      Signaturgeheimnis Geheimer Signaturschlüssel, den Sie in der Vonage-Entwicklerinstanz erworben haben.
    7. Wählen Sie Aus Verbindung Erstellen .

    Konfigurieren Sie den Verbindungsdatensatz für den primären Vonage-Alias

    Konfigurieren Sie einen Verbindungsdatensatz, der Ihren ermöglicht ServiceNow Instanz, mit der eine Verbindung hergestellt werden soll Vonage Führen Sie eine Instanz aus, und automatisieren Sie verschiedene Aktionen auf dem Vonage Instanz. Erstellen Sie beispielsweise einen Flow für Workflow-Studio Das hat Ihre Vonage Kontosaldo.

    Vorbereitungen

    Erforderliche Rolle: Administrator
    Hinweis:
    Stellen Sie sicher, dass Sie sich im befinden Vonage-Spoke Umfang.

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Flow Designeran.
    2. Wählen Sie Verbindungen.
    3. Geben Sie im Feld alle Verbindungen durchsuchen ein Vonage .Feld „alle Verbindungen durchsuchen“.
    4. Wählen Sie auf der Karte VonagePrimary die Option aus Details Anzeigen .
    5. Wählen Sie Konfigurieren.
    6. Füllen Sie das Formular aus.
      Tabelle : 2. Verbindung erstellen
      Feld Beschreibung
      Verbindungsname Der standardmäßige und schreibgeschützte Name des Verbindungsdatensatzes. Um dem Verbindungsdatensatz einen anwenderdefinierten Namen anzugeben, erstellen Sie einen Verbindungsdatensatz, indem Sie auswählen Verbindung Hinzufügen .
      Verbindungs-URL Die URL für die Verbindung mit der Vonage-API. Geben Sie https://rest.nexmo.com ein.
      API-Schlüssel API-Schlüssel, den Sie in der Vonage-Entwicklerinstanz erworben haben.
      Geheimer API-Schlüssel API-Geheimnis, das Sie in der Vonage-Entwicklerinstanz erworben haben.
    7. Wählen Sie Aus Verbindung Erstellen .

    Erstellen Sie einen Webhook, um Daten von Vonage zu erhalten

    Richten Sie Webhooks für SMS ein, damit die Vonage API-Plattform Daten an Ihre ServiceNow-Instanz senden kann. Wenn beispielsweise ein Flow in Ihrer ServiceNow-Instanz eine API-Anforderung für Anrufdetails an die Vonage-API sendet, die Anforderung jedoch anfänglich fehlschlägt, stellt der Webhook sicher, dass die Vonage-API die Daten später sendet.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Vonage-Spoke > Vonage-Webhook-Registrierungenan.
    2. Wählen Sie Neu.
    3. Füllen Sie die Felder im Formular aus.
      Tabelle : 3. Formular „Vonage-Webhook-Registrierung“
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Webhook-Datensatzes.
      Beschreibung Beschreibung des Webhook-Datensatzes.
      Ereignistyp Typ des Ereignisses, für das der Webhook eingerichtet ist. Wählen Sie Aus SMS .
      Geheimer Schlüssel Geheimer Schlüssel zur Authentifizierung der Webhook-Anforderungen. Geben Sie Ihren anwenderdefinierten geheimen Schlüssel ein.
    4. Rechtsklicken Sie auf die Formularüberschrift und wählen Sie Speichern.
    5. Wählen Sie Aus Rückruf-URL .
      Das System zeigt die Webhook-Rückruf-URL an.
    6. Kopieren Sie die Webhook-Rückruf-URL, und zeichnen Sie sie auf.
    7. Melden Sie sich bei https://developer.vonage.com/en/home an.
    8. Wählen Sie im linken Bereich unter Build and Manage (Erstellen und Verwalten) Anwendungen aus.Anwendungslink unter „Build & Manage“.
    9. Wählen Sie auf der Seite „Ihre Anwendungen“ das Menüsymbol ( Menüsymbol.) Für Ihre Anwendung.Meine Anwendung.
    10. Wählen Sie Bearbeiten.
    11. Geben Sie unter der Überschrift Nachrichten die Rückruf-URL in die Felder eingehende URL und Status-URL ein.Nachrichteneinstellungen.
    12. Wählen Sie im linken Bereich API-Einstellungen aus.
    13. Stellen Sie auf der Seite „Einstellungen“ unter der Überschrift „SMS-Einstellungen“ sicher, dass Sie ausgewählt haben SMS-API .
    14. Füllen Sie die Werte aus.
      Feld Wert
      DLR-Webhooks (Delivery Beleg) Webhook-Rückruf-URL
      Webhooks für eingehende SMS Webhook-Rückruf-URL
    15. Wählen Sie Änderungen speichern.
      SMS-Einstellungen für die Anwendung werden gespeichert.

    Passen Sie Webhooks und Weiterleitungsrichtlinien an

    Passen Sie die Webhook-Weiterleitungsrichtlinie und den Subflow entsprechend Ihren Anforderungen an.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > Flow Designer > Designeran.
    2. Klicken Sie Auf Subflows .
    3. Erstellen Sie eine Kopie des erforderlichen Standard-Subflows.
    4. Passen Sie den Subflow entsprechend Ihren Anforderungen an, und veröffentlichen Sie ihn.
      Siehe Subflows werden erstellt Für weitere Informationen zum Erstellen und Verwenden von Subflows und Vonage-Spoke Informationen zu den Feldern, die von der Standard-Weiterleitungsrichtlinie und den Subflows unterstützt werden.
    5. Navigieren zu Vonage-Spoke > Vonage-Webhook-Weiterleitungsrichtliniean.
    6. Klicken Sie auf Neu.
    7. Füllen Sie im Formular die Felder aus.
      Tabelle : 4. Formular „Entscheidung“
      Feld Beschreibung
      Bezeichnung Eindeutige Bezeichnung zur Identifizierung der Weiterleitungsrichtlinie.
      Standardantwort Option zum Festlegen, ob dies die Standardantwort ist. Die Standardantwort gilt, wenn die Bedingungen nicht erfüllt sind.
      1. Klicken Sie auf das Suchsymbol ( Suchsymbol).
      2. Wählen Sie den erforderlichen Subflow aus der Liste Dokument aus.
        Hinweis:
        Stellen Sie sicher, dass Tabellenname Ist Flow [sys_Hub_Flow] .
      Bedingung Bedingungen, die erfüllt werden müssen, wenn die erforderlichen Ereignisse in auftreten Vonage . Unterstützt Vonage Felder sind:
      • Stichwörter
      • Anrufrichtung
      • Anrufstatus
      • Ereignistyp
      • Von
      • SMS-Status
      • SMS-Text
      • An
      • WhatsApp Nachrichtenstatus
      • WhatsApp Text
      • Zugehörige Felder anzeigen
      Antwort Subflow, der ausgelöst werden muss, wenn die angegebenen Bedingungen erfüllt sind.
    8. Klicken Sie auf Absenden.
      Hinweis:
      Diese Weiterleitungsrichtlinien werden in den Entscheidungstabellen gespeichert. Anwender werden davor gewarnt, Daten in diesen Tabellen direkt zu aktualisieren oder zu ändern.