Richten Sie ein Vonage-Spoke

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

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

    Vorbereitungen

    • Fordern Sie an IntegrationHubAbonnement.
    • Aktivieren Sie Vonage-Spoke Plugin auf Ihrem ServiceNowInstanz.
    • Erforderliche Rolle: admin.
    • Vonage-Entwickler-Instanz-Account.

    Konfigurieren Sie die Vonage-Entwicklerinstanz

    Generieren Sie wichtige Anmeldeinformationen, z. B. API-Schlüssel, Geheimnisse und Signaturgeheimnisse, um einzurichten Vonage Entwicklerinstanz. Ihr ServiceNowDie 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 Vonage Entwicklercenter-Seite auswählen Sie mein Dashboard aus.Meine Dashboard-Seite.
    3. Auf 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 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 Ihren aktiviert ServiceNowInstanz, mit der eine Verbindung hergestellt werden soll Vonage Instanz und automatisieren Sie verschiedene Aktionen auf dem Vonage Instanz. Erstellen Sie beispielsweise einen Flow für Workflow-StudioDas hat Ihre Vonage Kontosaldo.

    Vorbereitungen

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

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Flow Designeran.
    2. Wählen Sie Verbindungen Aus.
    3. Geben Sie im Feld „alle Verbindungen durchsuchen“ ein Vonage .Durchsuchen Sie das Feld „alle Verbindungen“.
    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 bereitzustellen, 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.
      API-Geheimnis 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 aktiviert ServiceNowInstanz, mit der eine Verbindung hergestellt werden soll Vonage Instanz und automatisieren Sie verschiedene Aktionen auf dem Vonage Instanz. Erstellen Sie beispielsweise einen Flow für Workflow-StudioDas hat Ihre Vonage Kontosaldo.

    Vorbereitungen

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

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Flow Designeran.
    2. Wählen Sie Verbindungen Aus.
    3. Geben Sie im Feld „alle Verbindungen durchsuchen“ ein Vonage .Durchsuchen Sie das Feld „alle Verbindungen“.
    4. Wählen Sie auf der VonagePrimär-Karte 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 bereitzustellen, erstellen Sie einen Verbindungsdatensatz, indem Sie auswählen Verbindung Hinzufügen .
      Verbindungs-URL Die URL für die Verbindung mit der Vonage-API. Eingabetaste https://rest.nexmo.com.
      API-Schlüssel API-Schlüssel, den Sie in der Vonage-Entwicklerinstanz erworben haben.
      API-Geheimnis 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 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 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 diese Felder im Formular aus.
      Tabelle : 3. Registrierungsformular für Vonage-Webhook
      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 Rückruf-URL für den Webhook, 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 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 gemäß Ihren Anforderungen an, und veröffentlichen Sie ihn.
      Siehe Subflows werden erstellt Für weitere Informationen zum Erstellen und Verwenden von Subflows und Vonage-SpokeUm Informationen zu den Feldern zu erhalten, 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, 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 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.