Richten Sie die Vonage-Spokeein

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

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

    Vorbereitungen

    • Fordern Sie ein IntegrationHub -Abonnement an.
    • Aktivieren Sie das Vonage-Speichen- Plugin in Ihrer ServiceNow -Instanz.
    • 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: admin

    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 die Option Mein Dashboard aus.Seite „Mein Dashboard“.
    3. Verwenden Sie auf der Seite Vonage „ API-Dashboard“ den Standard-API-Schlüssel und das API-Geheimnis, oder erstellen Sie einen benutzerdefinierten API-Schlüssel und ein API-Geheimnis.
      1. Um den Standard-API-Schlüssel und das API-Geheimnis zu verwenden, kopieren Sie die Werte des Standard-API-Schlüssels und des API-Geheimnisses.Schaltfläche „Kopieren“ für API-Schlüssel und API-Geheimnis.
      2. Um einen benutzerdefinierten 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 Weitere API-Schlüssel anfordern aus.
      4. Füllen Sie das Formular aus, und senden Sie es ab.
      5. Wählen Sie Neues Geheimnis erstellen aus.
      6. Geben Sie im Fenster Neues Geheimnis hinzufügen Ihr benutzerdefiniertes Geheimnis ein.
      7. Wählen Sie Speichern.
    4. Kopieren Sie aus dem Feld Signaturgeheimnis das Signaturgeheimnis.

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

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

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Flow Designer.
    2. Wählen Sie Verbindungen aus.
    3. Geben Sie im Feld Alle Verbindungen durchsuchen Vonageein.Feld „Alle Verbindungen durchsuchen“.
    4. Wählen Sie auf der Vonage-Karte Details anzeigenaus.
    5. Wählen Sie Konfigurieren aus.
    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 benutzerdefinierten Namen zu geben, erstellen Sie einen Verbindungsdatensatz, indem Sie Verbindung hinzufügenauswählen.
      Verbindungs-URL Die URL für die Verbindung mit der Vonage-API.
      Version der Nachrichten-API 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 der Vonage-Anmeldeinformationen, den Sie aktualisieren können.
      Anwendungsname Name des Accounts, den Sie auf der Seite „Einstellungen“ des Vonage-Entwickler-Accounts eingegeben haben.Feld „Account-Name“ in der Vonage-Instanz
      API-Schlüssel API-Schlüssel, den Sie in der Vonage-Entwicklerinstanz erhalten haben.
      Geheimer API-Schlüssel Geheimer API-Schlüssel, den Sie in der Vonage-Entwicklerinstanz erhalten haben.
      Signaturgeheimnis Geheimer Signaturschlüssel, den Sie in der Vonage-Entwicklerinstanz erhalten 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 ServiceNow -Instanz ermöglicht, eine Verbindung mit der Vonage -Instanz herzustellen und verschiedene Aktionen in der Vonage -Instanz zu automatisieren. Erstellen Sie beispielsweise einen Flow für Flow Designer, der den Kontostand Ihres Vonage abruft.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Flow Designer.
    2. Wählen Sie Verbindungen aus.
    3. Geben Sie im Feld Alle Verbindungen durchsuchen Vonageein.Feld „Alle Verbindungen durchsuchen“.
    4. Wählen Sie auf der Karte VonagePrimary die Option Detailsanzeigen aus.
    5. Wählen Sie Konfigurieren aus.
    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 benutzerdefinierten Namen zu geben, erstellen Sie einen Verbindungsdatensatz, indem Sie Verbindung hinzufügenauswählen.
      Verbindungs-URL Die URL für die Verbindung mit der Vonage-API. Geben Sie den https://rest.nexmo.comn ein.
      API-Schlüssel API-Schlüssel, den Sie in der Vonage-Entwicklerinstanz erhalten haben.
      Geheimer API-Schlüssel Geheimer API-Schlüssel, den Sie in der Vonage-Entwicklerinstanz erhalten haben.
    7. Wählen Sie Verbindung erstellen aus.

    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 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. Vonage-Webhook-Registrierungsformular
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Webhook-Datensatzes.
      Beschreibung Beschreibung des Webhook-Datensatzes
      Ereignistyp Typ des Events, für das der Webhook eingerichtet wird Wählen Sie SMSaus.
      Geheimer Schlüssel Geheimer Schlüssel zur Authentifizierung der Webhook-Anforderungen. Geben Sie Ihren benutzerdefinierten geheimen Schlüssel ein.
    4. Rechtsklicken Sie auf die Formularüberschrift und wählen Sie Speichern.
    5. Wählen Sie Rückruf-URL aus.
      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 Erstellen und verwalten die Option Anwendungen aus.Link zu Anwendungen unter Erstellen und verwalten.
    9. Wählen Sie auf der Seite „Ihre Anwendungen“ das Menüsymbol ( Menüsymbol) für Ihre Anwendung aus.Meine Anwendung.
    10. Wählen Sie Bearbeiten aus.
    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 SMS-APIausgewählt haben.
    14. Füllen Sie die Werte aus.
      Feld Wert
      Webhooks für Zustellungsbelege (Delivery Receipts, DLR). Webhook-Callback-URL
      Webhooks für eingehende SMS Webhook-Callback-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-Routing-Richtlinie und den Subflow gemäß Ihren Anforderungen an.

    Vorbereitungen

    Erforderliche Rolle: admin

    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.
      Weitere Informationen zum Erstellen und Verwenden von Subflows finden Sie unter Subflows erstellen. Weitere Informationen zu den Feldern, die von der standardmäßigen Routing-Richtlinie und den Subflows unterstützt werden, finden Sie unter Vonage-Spoke.
    5. Navigieren zu Vonage-Spoke > Weiterleitungsrichtlinie für Vonage-Webhooks.
    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 Routing-Richtlinie.
      Standardantwort Option, um anzugeben, 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 Dokumentliste aus.
        Hinweis:
        Stellen Sie sicher, dass der TabellennameFlow [sys_hub_flow] lautet.
      Bedingung Bedingungen, die erfüllt sein müssen, wenn die erforderlichen Ereignisse in Vonageauftreten. Die unterstützten Vonage Felder sind:
      • Stichwörter
      • Anrufrichtung
      • Anrufstatus
      • Ereignistyp
      • Von
      • SMS-Status
      • SMS-Text
      • Zweck
      • 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.