--- sourceDocument: Xanadu: Integrationen mit Anwendungen erstellen sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/integrate-applications Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu: Integrationen mit Anwendungen erstellen ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Vonage-Spoke # Vonage-Spoke {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer Verwalten Sie die Kommunikation über Anrufe, SMS und WhatsApp, indem Sie den Account Vonage in Ihrer Instanz von ServiceNow verwenden. ## Apps im Store anfordern {#vonage-spoke__section_sz5_jv3_z3b} Besuchen Sie die [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home)-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum [ServiceNow Store-Versionsverlauf](https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html).{#vonage-spoke__inline-send-to-store} ## IntegrationHub-Abonnement {#vonage-spoke__section_rsf_yvb_l3b} Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter [Gesetzliche Zeitpläne − IntegrationHub − Übersicht](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf). ## Spoke-Version {#vonage-spoke__section_mxx_ndy_bsb} Vonage-Spoke v1.1.3 ist die neueste Version.{#vonage-spoke__vonagespk-vr} ## Unterstützte Versionen {#vonage-spoke__section_sv2_1n2_pmb} Diese Spoke wurde für Vonage für diese Versionen erstellt, ist jedoch möglicherweise mit späteren Versionen kompatibel: * Nachrichten-API, Version v0.1 * Sprach-API-Version v1 {#vonage-spoke__ul_usd_grf_pmb} ## Spoke-Anforderungen {#vonage-spoke__section_vv2_1n2_pmb} * Administratorzugriff auf den Account Vonage und das [Vonage-API-Dashboard](https://dashboard.nexmo.com/). * Notieren Sie die Werte des API-Schlüssels und des API-Geheimnisses. Sie können auf diese Werte im API-Dashboard Vonage zugreifen. Weitere Informationen finden Sie auf der Seite „ [Authentifizierung](https://developer.nexmo.com/concepts/guides/authentication) " auf der Dokumentationswebsite für [Vonage-API-Entwickler](https://developer.nexmo.com/documentation).{#vonage-spoke__vonage-api-key} * Notieren Sie den Wert des Signaturgeheimnisses, und speichern Sie ihn. Sie können auf diesen Wert in den [Kontoeinstellungen im Vonage-API-Dashboard](https://dashboard.nexmo.com/settings)zugreifen. Weitere Informationen finden Sie auf der Seite „ [Authentifizierung](https://developer.nexmo.com/concepts/guides/authentication) " auf der Dokumentationswebsite für [Vonage-API-Entwickler](https://developer.nexmo.com/documentation). {#vonage-spoke__ul_wv2_1n2_pmb} ## Spoke-Abhängigkeiten {#vonage-spoke__section_xv2_1n2_pmb} Wenn Sie Probleme beim Installieren der App haben, stellen Sie sicher, dass die folgenden abhängigen Plugins installiert sind: * ServiceNow IntegrationHub-Aktionsschritt -- REST (com.glide.hub.action_step.rest) * ServiceNow IntegrationHub-Laufzeit (com.glide.hub.integration.runtime) * Komplexes Objekt (com.glide.cobject) * ServiceNow Flow Designer -- Dynamische Eingaben (com.glide.hub.dynamic_inputs) {#vonage-spoke__ul_yv2_1n2_pmb} Hinweis: Einige dieser Plugins sind lizenzierbare Funktionen und erfordern entsprechende Lizenzen, wenn sie außerhalb der Spoke-Implementierung verwendet werden. ## Spoke-Unterabläufe {#vonage-spoke__section_uxx_tgf_kfb} Die Vonage-Spoke bietet Beispiel-Subflows, um die Automatisierung von Vonage -Aufgaben zu demonstrieren. Um einen Beispiel-Unterablauf anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Verfügbare Beispiel-Unterabläufe umfassen Folgendes: {#vonage-spoke__table_hbd_qty_qfb__entry__2} | Subflow | Beschreibung | |-|-| | Vonage SMS-Webhook | Verarbeitet die SMS-Anforderungen von Vonage. | | Vonage Sprach-Webhook | Verarbeitet die Sprachanforderungen von Vonage. | | Vonage WhatsApp Webhook | Verarbeitet die WhatsApp -Anforderungen von Vonage. | [ ] {#vonage-spoke__table_hbd_qty_qfb}Um den Standard-Subflow anzupassen, müssen Sie eine Kopie des Beispiel-Subflows erstellen und den Subflow entsprechend Ihren Anforderungen anpassen. Beim Anpassen von Subflows müssen Sie sicherstellen, dass die Subflows so konfiguriert sind, dass Endlosschleifen vermieden werden. ## Spoke-Aktionen {#vonage-spoke__section_b43_3h2_hfb} Die Vonage-Spoke bietet Aktionen zum Automatisieren von Vonage -Aufgaben, wenn in Ihrer Instanz von ServiceNow \] Ereignisse auftreten. Folgende Aktionen sind verfügbar: {#vonage-spoke__table_u1p_kh2_hfb__entry__3}{#vonage-spoke__vonage}{#vonage-spoke__whatsapp} | Kategorie | Aktion | Beschreibung | |-|-|-| | Account-Verwaltung | Account-Saldo abrufen | Ruft den aktuellen Saldo des Vonage -Accounts ab. | | Anrufverwaltung | DTMF-Ton in Anruf abspielen | Gibt DTMF-Töne (Dual-Tone Multi-Frequency) in einem aktiven Anruf wieder | | Anrufverwaltung | Aufzeichnung an Datensatz ServiceNow anhängen | Hängt eine Anrufaufzeichnung an den Zieldatensatz ServiceNow an. | | Anrufverwaltung | Ausgehenden Anruf erstellen | Erstellt einen ausgehenden Anruf an eine Telefonnummer. | | Anrufverwaltung | NCCO generieren | Erstellt ein Nexmo-Anrufsteuerungsobjekt (Nexmo Call Control Object, NCCO), das in der Aktion Ausgehenden Anruf erstellen verwendet wird. | | Anrufverwaltung | Anrufdetails abrufen | Ruft die Details des angegebenen Anrufs ab. | | Anrufverwaltung | Anrufe suchen | Ruft Details angegebener Anrufe ab. | | Anrufverwaltung | Audio in Anruf wiedergeben | Spielt eine Audiodatei in einem aktiven Anruf ab. | | Anrufverwaltung | Text-zu-Sprache in Anruf wiedergeben | Gibt Text-zu-Sprache in einem aktiven Anruf wieder. | | Anrufverwaltung | Audio-Wiedergabe in einem Anruf stoppen | Stoppt die Wiedergabe einer Audiodatei in einem aktiven Anruf. | | Anrufverwaltung | Text-zu-Sprache in Anruf anhalten | Stoppt Text-zu-Sprache in einem aktiven Anruf. | | Anrufverwaltung | Anruf aktualisieren | Aktualisiert den Status eines aktiven Anrufs. | | Nummernverwaltung | Nach eigenen Nummern suchen | Ruft alle eingehenden Nummern ab, die dem Vonage-Konto zugeordnet sind. | | SMS-Verwaltung | SMS senden | Sendet eine SMS (Short Message Service) an eine Telefonnummer. | | WhatsApp -Verwaltung | Kontakte senden | Sendet Kontakte an eine WhatsApp -Nummer. | | WhatsApp -Verwaltung | Standort senden | Sendet geografische Koordinaten eines Standorts an eine WhatsApp -Nummer. | | WhatsApp -Verwaltung | Mediennachricht senden | Sendet eine Mediennachricht an eine Nummer WhatsApp. | | WhatsApp -Verwaltung | Textnachricht senden | Sendet eine Textnachricht an eine Nummer WhatsApp. | | WhatsApp -Verwaltung | Textnachricht mithilfe einer Vorlage senden | Sendet eine Textnachricht mithilfe der Vorlage an eine WhatsApp -Nummer. | [ ] {#vonage-spoke__table_u1p_kh2_hfb} ## Spoke-Modul {#vonage-spoke__section_w2k_lyx_qlb} Bidirektionale Webhooks können so eingerichtet werden, dass sie über die erforderlichen Ereignisse benachrichtigt werden. Die Weiterleitungsrichtlinie definiert Bedingungen, die erfüllt sein müssen, um die Instanz ServiceNow zu benachrichtigen. Diese Bedingungen basieren auf den Ereignissen in Vonage, über die Sie benachrichtigt werden möchten. Wenn die Bedingungen erfüllt sind, löst die Weiterleitungsrichtlinie den zugehörigen Subflow aus, der wiederum die Aufgaben Vonage automatisiert. Standardmäßig ist die Spoke-Anwendung Vonage verfügbar und verfügt über die folgenden Module: * Vonage Webhook-Registrierungen * Vonage WebHook-Weiterleitungsrichtlinien {#vonage-spoke__ul_qzt_2h4_z3b} Verwenden Sie das Modul Vonage Webhook-Registrierungen, um ein Token zuzuweisen und den API-Pfad anzugeben. Sie müssen hier eine Rückruf-URL generieren und diese URL in Vonageangeben. Standardroutingrichtlinien werden als Referenz im Modul Vonage WebHook Routing Policies (WebHook-Routing-Richtlinien) bereitgestellt. Passen Sie diese Weiterleitungsrichtlinien an Ihre Anforderungen an. Die Weiterleitungsrichtlinie unterstützt diese Felder: * Stichwörter * Anrufrichtung * Anrufstatus * Ereignistyp * Von * SMS-Status * SMS-Text * An * WhatsApp Nachrichtenstatus * WhatsApp Text * Zugehörige Felder anzeigen {#vonage-spoke__supp-fields-vonage} ## Alias-Anforderungen für Verbindungen und Anmeldeinformationen {#vonage-spoke__section_ibn_pj2_hfb} IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren. Weitere Informationen finden Sie unter [Connections and Credentials](https://www.servicenow.com/docs/access?context=r-credentials&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). Zwei Aliasse für Verbindungen und Anmeldeinformationen sind zusammen mit der Spoke Vonage verfügbar:{#vonage-spoke__table_gtq_d52_pmb__entry__2} | Vonage Alias | Beschreibung | |-|-| | VonagePrimary | Erforderlich für die Aktionen zum Verwalten von SMS, Nummer und Account. | | Vonage | Erforderlich für die Aktionen zum Verwalten von Anrufen und WhatsApp. | [ ] {#vonage-spoke__table_gtq_d52_pmb} Informationen zum Einrichten der Spoke finden Sie unter [Richten Sie die Vonage-Spokeein](https://servicenow-prod.fluidtopics.net/kxoV6d_DmX_eg4BtvH7MgA#setup-vonage-spoke "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.").