---
sourceDocument: Zürich-Daten und Automatisierung
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/zurich/integrate-applications

 Release :

    - zurich

ft:locale :

    - de-DE

ft:publication_title :

    - Zürich-Daten und Automatisierung

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Richten Sie ein Vonage-Spoke

# Richten Sie ein Vonage-Spoke {#ariaid-title1}

* Freigeben Version: Zurich
* 
* Aktualisiert 31. Juli 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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.
{#setup-vonage-spoke__ul_agy_qxd_rlb}

## Konfigurieren Sie die Vonage-Entwicklerinstanz {#ariaid-title2}

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.
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.
   2. Um einen anwenderdefinierten API-Schlüssel und ein API-Geheimnis zu generieren, wählen Sie im linken Bereich API-Einstellungen aus.
   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.
   {#configure-vonage-developer-instance__substeps_zsv_zq1_5yb}
4. Kopieren Sie das Signaturgeheimnis aus dem Feld Signaturgeheimnis.

## Konfigurieren Sie den Verbindungsdatensatz für den Vonage-Alias für Verbindungen und Anmeldeinformationen {#ariaid-title3}

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 AlleProzessautomatisierungFlow Designeran.
2. Wählen Sie Verbindungen.
3. Geben Sie im Feld alle Verbindungen durchsuchen ein <kbd class="ph userinput">Vonage </kbd>.
4. Wählen Sie auf der Vonage-Karte aus Details Anzeigen .
5. Wählen Sie Konfigurieren.
6. Füllen Sie das Formular aus.  
   {#configure-connection-record-for-vonage-alias__table_vpl_zd3_5yb__entry__2}

   | 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. |
   | 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. |
   [Tabelle : 1. Verbindung erstellen]

   {#configure-connection-record-for-vonage-alias__table_vpl_zd3_5yb}
7. Wählen Sie Aus Verbindung Erstellen .

## Konfigurieren Sie den Verbindungsdatensatz für den primären Vonage-Alias {#ariaid-title4}

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 AlleProzessautomatisierungFlow Designeran.
2. Wählen Sie Verbindungen.
3. Geben Sie im Feld alle Verbindungen durchsuchen ein <kbd class="ph userinput">Vonage </kbd>.
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.  
   {#configure-connection-record-for-vonage-primary-alias__table_vpl_zd3_5yb__entry__2}

   | 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. |
   [Tabelle : 2. Verbindung erstellen]

   {#configure-connection-record-for-vonage-primary-alias__table_vpl_zd3_5yb}
7. Wählen Sie Aus Verbindung Erstellen .
{#configure-connection-record-for-vonage-primary-alias__steps_hft_jxd_vyb}

## Erstellen Sie einen Webhook, um Daten von Vonage zu erhalten {#ariaid-title5}

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 AlleVonage-SpokeVonage-Webhook-Registrierungenan.
2. Wählen Sie Neu.
3. Füllen Sie die Felder im Formular aus.  
   {#create-sms-webhook__table_smp_4jf_pmb__entry__2}

   | 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. |
   [Tabelle : 3. Formular „Vonage-Webhook-Registrierung"]

   {#create-sms-webhook__table_smp_4jf_pmb}
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.
9. Wählen Sie auf der Seite „Ihre Anwendungen" das Menüsymbol ( ![Menüsymbol.]()) Für Ihre 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.
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.  
    {#create-sms-webhook__table_r5h_wkf_pmb__entry__2}

    | Feld | Wert |
    |-|-|
    | DLR-Webhooks (Delivery Beleg) | Webhook-Rückruf-URL |
    | Webhooks für eingehende SMS | Webhook-Rückruf-URL |
    [ ]

    {#create-sms-webhook__table_r5h_wkf_pmb}
15. Wählen Sie Änderungen speichern.  
    SMS-Einstellungen für die Anwendung werden gespeichert.

## Passen Sie Webhooks und Weiterleitungsrichtlinien an {#ariaid-title6}

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

### Vorbereitungen

Erforderliche Rolle: Administrator

### Prozedur

1. Navigieren zu AlleFlow DesignerDesigneran.
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](https://www.servicenow.com/docs/access?context=subflows&version=zurich&pubname=zurich-build-workflows&ft:locale=en-US)Für weitere Informationen zum Erstellen und Verwenden von Subflows und [Vonage-Spoke](https://www.servicenow.com/docs/FOmoWAOG4SXLU_TPRqK3nQ "Verwalten Sie die Kommunikation über Anrufe, SMS und WhatsApp Mithilfe von Vonage Account von Ihrem ServiceNow Instanz.") 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.  
   {#cust-routing-vonage__table_awj_xgv_z3b__entry__2}

   | 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 <kbd class="ph userinput">Flow [sys_Hub_Flow] </kbd>. {#cust-routing-vonage__ol_sdf_ftb_1jb} |
   | 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 {#cust-routing-vonage__ul_yks_qpf_pmb} |
   | Antwort | Subflow, der ausgelöst werden muss, wenn die angegebenen Bedingungen erfüllt sind. |
   [Tabelle : 4. Formular „Entscheidung"]

   {#cust-routing-vonage__table_awj_xgv_z3b}
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.
{#cust-routing-vonage__steps_vjr_z4f_pmb}