Richten Sie die Vonage-Spokeein

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

    • Integrieren Sie Ihre Instanz ServiceNow mit der Instanz Vonage, um die Kommunikation zwischen ihnen zu ermöglichen. Mit dieser Integration kann Ihre Instanz ServiceNow Aktionen in der Instanz Vonage automatisieren, während die Instanz Vonage Nutzlasten an Ihre Instanz ServiceNow senden kann.

    Vorbereitungen

    • Fordern Sie ein IntegrationHub -Abonnement an.
    • Aktivieren Sie das Vonage-Spoke- Plugin in Ihrer Instanz ServiceNow.
    • Erforderliche Rolle: admin.
    • Vonage-Entwicklerinstanz-Account.

    Konfigurieren Sie die Vonage-Entwicklerinstanz

    Generieren Sie wichtige Anmeldeinformationen wie API-Schlüssel, Geheimnisse und Signaturgeheimnisse, um Ihre Vonage -Entwicklerinstanz einzurichten. Ihre Instanz ServiceNow verwendet diese Anmeldeinformationen im Verbindungsdatensatz, um eine Verbindung zur Entwicklerinstanz Vonage herzustellen.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Zugriff auf ein Vonage -Entwicklerkonto.

    Prozedur

    1. Melden Sie sich bei https://developer.vonage.com/en/home an.
    2. Wählen Sie auf der Seite Vonage Developer Center Mein Dashboard aus.Seite „Mein Dashboard“.
    3. Verwenden Sie auf der Seite „API-Dashboard Vonage “ 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 die Werte für den Standard-API-Schlüssel und das API-Geheimnis.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.Link zu API-Einstellungen.
      3. Wählen Sie Weitere API-Schlüssel anfordern aus.
      4. Füllen Sie das Formular aus, und übermitteln Sie es.
      5. Wählen Sie Neues Geheimnis erstellen aus.
      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 es Ihrer Instanz ServiceNow ermöglicht, eine Verbindung zu der Instanz Vonage herzustellen und verschiedene Aktionen in der Instanz Vonage zu automatisieren. Erstellen Sie beispielsweise einen Flow für Workflow-Studio, der den Saldo Ihres Vonage -Kontos abruft.

    Vorbereitungen

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

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Flow Designer.
    2. Wählen Sie Verbindungen aus.
    3. Geben Sie im Feld Alle Verbindungen durchsuchen den Wert Vonageein.Feld „Alle Verbindungen durchsuchen“.
    4. Wählen Sie auf der Karte Vonage 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 zu geben, erstellen Sie einen Verbindungsdatensatz, indem Sie Verbindung hinzufügenwählen.
      Verbindungs-URL Die URL zum Herstellen einer Verbindung mit der Vonage-API.
      Nachrichten-API-Version Die Version von APIs, die der Verbindungsdatensatz für die Verwendung der SMS-Funktion in der Vonage-Instanz anfordert.
      Sprach-API-Version Die Version von APIs, die der Verbindungsdatensatz für die Verwendung der Sprachfunktion in der Vonage-Instanz anfordert.
      Anmeldeinformationsname Name des Anmeldeinformationsdatensatzes. Der Standardname für die BS-Anmeldeinformationen für Vonage, den Sie aktualisieren können.
      Applikationsname Name des Accounts, den Sie auf der Seite „Einstellungen“ des Vonage-Entwickleraccounts eingegeben haben.Feld „Accountname“ 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 Verbindung erstellen aus.

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

    Konfigurieren Sie einen Verbindungsdatensatz, der es Ihrer Instanz ServiceNow ermöglicht, eine Verbindung zu der Instanz Vonage herzustellen und verschiedene Aktionen in der Instanz Vonage zu automatisieren. Erstellen Sie beispielsweise einen Flow für Workflow-Studio, der den Saldo Ihres Vonage -Kontos abruft.

    Vorbereitungen

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

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Flow Designer.
    2. Wählen Sie Verbindungen aus.
    3. Geben Sie im Feld Alle Verbindungen durchsuchen den Wert Vonageein.Feld „Alle Verbindungen durchsuchen“.
    4. Wählen Sie auf der Karte VonagePrimary 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 zu geben, erstellen Sie einen Verbindungsdatensatz, indem Sie Verbindung hinzufügenauswählen.
      Verbindungs-URL Die URL zum Herstellen einer 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 Verbindung erstellen aus.

    Erstellen Sie einen Webhook, um Daten von Vonage zu empfangen

    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 zunächst 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-Registrierungen.
    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 wird. Wählen Sie SMSaus.
      Geheimer Schlüssel Geheimer Schlüssel zum Authentifizieren 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 Rückruf-URLaus.
      Das System zeigt die Webhook-Callback-URL an.
    6. Kopieren Sie die Webhook-Callback-URL, und erfassen Sie sie.
    7. Melden Sie sich bei https://developer.vonage.com/en/home an.
    8. Wählen Sie im linken Bereich unter Erstellen und verwalten Anwendungen.Link für Anwendungen unter Erstellen und verwalten.
    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 in den Feldern Eingehende URL und Status-URL die Rückruf-URL ein.Nachrichteneinstellungen.
    12. Wählen Sie im linken Bereich API-Einstellungen.
    13. Stellen Sie auf der Seite „Einstellungen“ unter „SMS-Einstellungen“ sicher, dass Sie SMS-APIausgewählt haben.
    14. Füllen Sie die Werte aus.
      Feld Wert
      Webhooks für Zustellungsbelege (Delivery Receipts, DLR). Webhook-Rückruf-URL
      Webhooks für eingehende SMS Webhook-Rückruf-URL
    15. Wählen Sie Änderungen speichern.
      Die SMS-Einstellungen für die Anwendung werden gespeichert.

    Passen Sie Webhooks und Weiterleitungsrichtlinien an

    Passen Sie die Webhook-Routing-Richtlinie und den Subflow an Ihre Anforderungen an.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > Flow Designer > Designer.
    2. Klicken Sie auf Subflows.
    3. Erstellen Sie eine Kopie des erforderlichen Standard-Subflows.
    4. Passen Sie den Subflow an Ihre Anforderungen an, und veröffentlichen Sie ihn.
      Unter Subflows erstellen finden Sie weitere Informationen zum Erstellen und Verwenden von Subflows und Vonage-Spoke für Informationen zu den Feldern, die von der Standardweiterleitungsrichtlinie und den Subflows unterstützt werden.
    5. Navigieren zu Vonage-Spoke > Vonage-WebHook-Weiterleitungsrichtlinie.
    6. Klicken Sie auf Neu.
    7. Füllen Sie die Felder des Formulars aus.
      Tabelle : 4. Formular „Entscheidung“
      Feld Beschreibung
      Bezeichnung Eindeutige Bezeichnung zur Identifizierung der Weiterleitungsrichtlinie.
      Standardantwort Option zum Angeben, ob dies die Standardantwort ist. Die Standardantwort ist anwendbar, wenn die Bedingungen nicht erfüllt sind.
      1. Klicken Sie auf das Suchsymbol ( Suchsymbol).
      2. Wählen Sie den gewünschten Subflow aus der Dokumentliste aus.
        Hinweis:
        Stellen Sie sicher, dass der TabellennameFlow [sys_hub_flow]lautet.
      Bedingung Bedingungen, die erfüllt werden müssen, wenn die erforderlichen Ereignisse in Vonageauftreten. Die unterstützten Felder Vonage 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. Benutzer werden davor gewarnt, Daten in diesen Tabellen direkt zu aktualisieren oder zu ändern.