> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/de/business-dienstleistungen/zoom-contact-center/expert-insights/integrate-engagement-data.md).

# Engagement-Daten integrieren

Verfasst von Justin Steinberg

### Überblick

Zoom Contact Center generiert während jeder Kundeninteraktion wertvolle Interaktionsdaten, darunter Anrufaufzeichnungen, Transkripte, Agentennotizen und Abschlussgründe. Lesen Sie weiter, um zu erfahren, wie Sie Interaktionsdaten in externen Systemen (z. B. CRM- und anderen führenden Systemen) speichern können, um eine einheitliche Kundenansicht zu erstellen, ein effektives Agenten-Coaching zu aktivieren oder bei der Verwendung von Zoom Contact Center Anforderungen an die Einhaltung zu erfüllen.

Wir erläutern die verschiedenen Integration-Methoden, damit Sie den besten Ansatz dafür wählen können, wie Ihre Agenten effizienter arbeiten können.

Die beste Methode hängt in erster Linie von einem entscheidenden Faktor ab: **die Anwendung, in der die Agents ihre Interaktionen bearbeiten**. Die beiden Optionen, die wir besprechen werden, sind:

1. Agents, die den sofort einsatzbereiten ZCC CRM CTI Connector innerhalb des CRM verwenden.
2. Agents, die in der Zoom Workplace App arbeiten und für die eine maßgeschneiderte Lösung mit ZCC-APIs und Webhooks erforderlich ist.

***

### CRM-CTI-Connector-Integration ohne zusätzlichen Konfigurationsaufwand

Dies ist die unkomplizierteste Methode. Wenn Ihre Agents einen ZCC CRM CTI Connector verwenden, können die meisten Engagement-Daten automatisch zwischen der Zoom-Plattform und dem entsprechenden CRM synchronisiert werden.

#### <mark style="color:blau;">So funktioniert es</mark>

Der CTI-Connector bettet die ZCC-Agentenoberfläche direkt in das CRM ein. Wenn eine Interaktion endet, werden Daten wie Aufzeichnungen, Transkripte, Notizen und Abschlussergebnisse automatisch in Zoom gespeichert und mit dem entsprechenden Datensatz (z. B. einem Ticket oder Kontakt) in Ihrem CRM verknüpft.

#### <mark style="color:blau;">Einrichtungsvoraussetzungen</mark>

Die Funktionalität, die eine Synchronisierung von Daten zwischen Zoom und dem CRM ermöglicht, ist standardmäßig verfügbar, erfordert jedoch eine Aktivierung im ZCC Admin-Portal.

Führen Sie die folgenden Schritte aus:

{% stepper %}
{% step %}
**Im ZCC Admin-Portal aktivieren**

Melden Sie sich als Administrator beim Zoom Admin-Portal an. Im [Administratorcenter](https://zoom.com/account), gehen Sie zu CX-Management → Contact Center → Integrationen → [Anwendungen](https://zoom.com/cci/index/admin#/admin-integrations).

Suchen Sie die relevante CRM-Integration und aktivieren Sie die entsprechenden Einstellungen, um die Datenspeicherung in Ihrem CRM zuzulassen.
{% endstep %}

{% step %}
**CRM-Berechtigungen**

Prüfen Sie die [Anleitungen zur Einrichtung der CRM-Integration](https://support.zoom.com/) um zu überprüfen, ob Ihr CRM-Integrationsbenutzer über die erforderlichen Schreibberechtigungen für alle relevanten Objekte verfügt.
{% endstep %}
{% endstepper %}

#### <mark style="color:blau;">Unterstützte CRM-Plattformen</mark>

Diese Funktion ist über den ZCC CRM CTI Connector verfügbar, wenn Agenten die folgenden CRMs verwenden:

* Salesforce
* Zendesk
* ServiceNow
* Microsoft Dynamics
* HubSpot

Bei den CRM-CTI-Konnektoren ist keine spezielle Konfiguration erforderlich. Die Integration speichert die Interaktionsdaten standardmäßig im CRM.

***

### Benutzerdefinierte Integration über APIs

Wenn Ihre Agenten die native Zoom Workplace-App oder ZCC Smart Embed verwenden, benötigen Sie eine benutzerdefinierte Lösung zur Übertragung von Interaktionsdaten. Die wichtigste Möglichkeit hierfür sind die APIs von Zoom Contact Center.

Es gibt zwei Hauptansätze, um über die API auf Engagement-Daten zuzugreifen:

* **Abfrageintervall:** Fragen Sie regelmäßig die Zoom API ab, um zu prüfen, ob neue Engagement-Daten verfügbar sind.
* **Webhooks:** Erhalten Sie eine Echtzeit-Benachrichtigung von Zoom, sobald ein Transkript bereitsteht.

Es gibt auch einen dritten Ansatz, **Flow Events-Integration**, das für bestimmte Datentypen funktioniert.

#### <mark style="color:blau;">Abfragen der Zoom Contact Center APIs</mark>

Um Engagement-Daten herunterzuladen, müssen Sie die entsprechenden ZCC-API-Endpunkte abfragen. Beachten Sie, dass verschiedene Datentypen aus unterschiedlichen APIs stammen. Daher müssen Sie wahrscheinlich für jeden relevanten Endpunkt eine Abfragelogik einrichten.

Viele APIs für Interaktionen in Reports V2 (CX Analysen) unterstützen jetzt die Filterung nach Endzeit mit `end_time_from` und `end_time_to`. Verwenden Sie diese Parameter nach Möglichkeit, damit Ihre Abrufvorgänge Interaktionen anhand ihres tatsächlichen Endzeitpunkts abrufen. So lassen sich fehlende Datensätze vermeiden, da die vollständigen Interaktionsdaten (einschließlich der Daten aus Report V2) erst am Ende der Interaktion finalisiert werden.

| Um diese Daten abzurufen …                                     | Rufen Sie diese API ab …                                                                                                                                                                                                                                                                                                                                                        | Mit diesem Feld … | Hinweise:                                                                           |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ----------------------------------------------------------------------------------- |
| <p>Aufzeichnungsmediendatei</p><p>(Sprach- und Videokanal)</p> | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/recordings/get/contact_center/recordings">Aufzeichnungen auflisten</a> oder</p><p>Interaktionsaufzeichnungen auflisten</p>                                                                                                                                                                                  | `download_url`    | Für die Warteschlange muss die Anrufaufzeichnung aktiviert sein.                    |
| <p>Aufzeichnungstranskript</p><p>(Sprach- und Videokanal)</p>  | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/recordings/GET/contact_center/recordings">Aufzeichnungen auflisten</a> oder</p><p>Interaktionsaufzeichnungen auflisten</p>                                                                                                                                                                                  | `transcript_url`  | Erfordert eine Anrufaufzeichnung mit aktivierter Transkription.                     |
| <p>Transkript</p><p>(Messaging-Kanal)</p>                      | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Ein Engagement abrufen</a> oder</p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/reports-v2-cx-analytics/get/contact_center/analytics/log/historical/engagement">Historische Engagement-Protokolldaten auflisten</a></p>   | `transcript_url`  | Für Messaging-Kanäle ist das Transkript standardmäßig aktiviert.                    |
| <p>Dispositionen</p><p>(Alle Kanäle)</p>                       | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Ein Engagement abrufen</a> oder</p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/reports-v2-cx-analytics/get/contact_center/analytics/log/historical/engagement">Historische Engagement-Protokolldaten auflisten</a></p>   | `dispositions`    | Ein Array mit Disposition-Objekten.                                                 |
| <p>Notizen</p><p>(Alle Kanäle)</p>                             | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Ein Engagement abrufen</a> oder</p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/reports-v2-cx-analytics/get/contact_center/analytics/log/historical/engagement">Historische Engagement-Protokolldaten auflisten</a></p>   | `notes`           | Ein Array mit Notizobjekten.                                                        |
| <p>Mailbox-Mediendatei</p><p><br><br></p>                      | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/messages">Nachrichten im Posteingang eines Kontos auflisten</a> <strong>oder</strong></p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/{inboxId}/messages">Die Nachrichten eines Posteingangs auflisten</a></p> | `download_url`    | Für Sprachnachrichten, die in einem Contact Center-Posteingang hinterlassen wurden. |
| Mailbox-Transkript                                             | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/messages">Nachrichten im Posteingang eines Kontos auflisten</a> <strong>oder</strong></p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/{inboxId}/messages">Die Nachrichten eines Posteingangs auflisten</a></p> | `transcript_url`  | Erfordert, dass die Transkription für den Posteingang aktiviert ist.                |

{% hint style="danger" %}
**Warnung**

Die Download-URLs (`download_url`, `transcript_url`, `playback_url`, und so weiter), die von diesen Zoom-APIs bereitgestellt werden, sind **keine** öffentlichen Links. Sie sind für den programmgesteuerten Zugriff vorgesehen und erfordern eine API-Authentifizierung (z. B. ein Access-Token im Authorization-Header), um die zugehörige Datei herunterzuladen.

Das bedeutet:

* Du kannst diese URLs nicht direkt in einem CRM speichern, damit ein Benutzer darauf klicken kann. Ein Benutzer, der im Browser auf den Link klickt, ist nicht authentifiziert, und der Download schlägt fehl.
* Richtig ist, dass dein Backend-Dienst die URL verwendet, um die Datei abzurufen. Dein Dienst kann die Datei dann in deinem eigenen System speichern (z. B. in Amazon S3, Azure Blob Storage oder im Dateispeicher deines CRM) und deinen Benutzern von dort aus einen sicheren Link bereitstellen.
  {% endhint %}

{% hint style="warning" %}
**Achtung**

**Verzögerungen bei der Verarbeitung – Sprach- und Videoaufzeichnungen:**

Diese Daten sind nicht unmittelbar nach dem Ende eines Anrufs verfügbar. Die Audiodaten müssen zuerst verarbeitet und hochgeladen werden. Bei langen Anrufen kann das mehrere Minuten dauern. Damit du keine Aufzeichnungen verpasst, setze den `query_date_type` Parameter auf `recording_end_time` beim Abfragen der API zum Auflisten von Aufzeichnungen. Dabei werden Daten basierend darauf abgerufen, wann die Verarbeitung abgeschlossen wurde, nicht darauf, wann der Anruf beendet wurde.

Verwenden Sie für engagementzentrierte Abstimmungsjobs in Reports V2 (CX Analysen) überlappende Zeitfenster mit `end_time_from` und `end_time_to` um einen Sicherheitspuffer für verzögerte Verarbeitung und vorübergehende Zustellungsprobleme bereitzustellen.
{% endhint %}

Weitere Informationen zu den Zoom Contact Center APIs finden Sie unter [Contact Center APIs](https://developers.zoom.us/docs/api/contact-center/) Dokumentation.

#### <mark style="color:blau;">Webhooks für Ereignisse in Echtzeit verwenden</mark>

Für einen direkteren, ereignisgesteuerten Ansatz können Sie ZCC-Webhooks abonnieren. Dies ist die effizienteste Methode für eine Integration nahezu in Echtzeit.

**So funktioniert es**

1. Abonnieren Sie die entsprechenden Ereignisse im Zoom App Marketplace.
2. Wenn ein Event eintritt, sendet Zoom eine Benachrichtigung an deine Webhook-URL (oder an deine WebSocket-Verbindung).
3. Die Event-Nutzlast enthält die benötigten Daten entweder direkt oder als URL/ID für einen nachfolgenden API-Aufruf.

**Gängige Webhook-Ereignisse für Engagement-Daten**

* **Daten zum Ende der Interaktion bereit:** contact\_center.cx\_engagement\_end\_data\_ready (signalisiert, dass die Daten des Engagement-Endberichts V2 zum Abrufen bereitstehen)
* **Sprach-/Videoaufzeichnung:** contact\_center.recording\_completed (stellt eine `download_url`)
* **Sprach-/Video-Transkript:** contact\_center.recording\_Transkript\_completed (stellt ein `transcript_url`)
* **Messaging-Transkript:** contact\_center.engagement\_messaging\_transcript\_completed (stellt eine `Transkript_url`)
* **Hinweise:** contact\_center.engagement\_note\_added (stellt eine `Notiz` Feld mit den Notizdaten)
* **Disposition:** contact\_center.engagement\_disposition\_added (stellt eine `disposition_name` Feld mit den Disposition-Daten)

**Empfohlenes Muster: Abruf auslösen, sobald die Engagement-Daten bereitstehen**

Wenn Sie erhalten `contact_center.cx_engagement_end_data_ready`, betrachten Sie dies als Signal dafür, dass die Daten des Engagement-Endberichts V2 für dieses Engagement vollständig sind. Rufen Sie zu diesem Zeitpunkt die Historical Engagement-Logdaten-API und alle anderen relevanten APIs auf, um den endgültigen Datensatz zu erfassen. Verwenden Sie in diesem Event `engagement_id` als Suchschlüssel und rufen Sie dann die vollständigen Engagement-Artefakte von den erforderlichen Endpunkten ab.

{% hint style="warning" %}
**Achtung**

* **Mehrere Events beachten:** Das `note_added` und `disposition_added` -Event kann bei einem einzelnen Vorgang mehrmals ausgelöst werden (z. B. wenn ein Agent mehrere Notizen speichert oder ein Anruf weitergeleitet wird). Ihre Anwendungslogik muss damit umgehen können.
* **Redundanz einplanen:** Die Zustellung von Events ist nicht immer zu 100 % gewährleistet (z. B. kann Ihr Endpunkt oder Ihre WebSocket-Verbindung vorübergehend ausfallen).
* **Backup-Strategie:** Wir empfehlen, ein Abgleichskript auszuführen, das Polling-APIs verwendet, mit `end_time_from` und `end_time_to` Windows, um verpasste Ereignisse zu erfassen und Datenlücken zu schließen.
  {% endhint %}

Weitere Informationen zu Zoom Contact Center Webhook-/WebSocket-Ereignissen finden Sie unter [Contact Center-Webhooks](https://developers.zoom.us/docs/api/contact-center/events/) Dokumentation.

#### <mark style="color:blau;">Integration von Flow-Ereignissen</mark>

Für bestimmte Datentypen können Sie Daten direkt aus dem ZCC Flow-Editor mithilfe eines JavaScript-Event-Skripts an ein externes System übertragen.

**Unterstützte Daten und Einschränkungen:**

* **Disposition:** Kann bei allen Typen eingehender Engagement-Kanäle über den `global_system.Engagement.Disposition` Variable.
* **Transkript:** Nur für Eingehende Messaging-Interaktionen zugänglich (z. B. Web-Chat), bei denen Folgendes verwendet wird `global_system.Engagement.Transkript` Variable.
* **Mehrere Abläufe:** Wenn Sie in Ihrer Konfiguration mit mehreren Flows arbeiten, insbesondere wenn ein Flow die `RouteTo` Widget, das eine Verbindung zu einem anderen Flow herstellt. Es ist wichtig, sicherzustellen, dass in allen Flows identische Event Scripts und Trigger korrekt konfiguriert sind.

Diese Methode ist besonders leistungsstark in einem Messaging-Flow, in dem Sie Transkript und Disposition in einem einzelnen Event kombinieren können.

**Konfigurationsschritte**

Führen Sie die folgenden Schritte aus, um Ihren Flow zu konfigurieren:

{% stepper %}
{% step %}
**Event Script hinzufügen**

Klicken Sie in Ihrem ZCC-Flow (z. B. einem Web-Chat-Flow) auf das Start-Widget.

Suchen Sie nach „Event Scripts“ und fügen Sie ein Event Script für Ereignisse wie „Engagement Closed“ und/oder „Disposition Saved“ hinzu.

<div align="left"><figure><img src="https://590569539-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-608a0caccf5697f0cda911a59ba832b2f5cf3fd6%2Fimage.png?alt=media" alt="Flow screen showing a welcome message and events."><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Eigenes JavaScript hinzufügen**

Das folgende Beispiel ruft sowohl die Disposition als auch das Transkript ab und sendet beides gemeinsam an eine externe API.

```javascript
async function main () { 
  try {
    // Das Disposition-Objekt aus seiner Variablen abrufen
    const disposition_data = var_get()['global_system.Engagement.disposition'];
    
    // Das vollständige Transkriptobjekt abrufen
    const transcript_data = await req.get(var_get()['global_system.Engagement.transcript']);

    // Bereiten Sie eine Nutzlast mit allen Daten vor, die Sie senden möchten
    const payload_to_send = {
      disposition: disposition_data.data.result,
      Transkript: transcript_data.data.result.transcript
    };

    // Ziel für Ihre Daten festlegen
    const external_api_url = '<replace-with-your-api-Endpunkt>';
    
    // Senden Sie die zusammengeführten Daten an Ihr externes System
  	const response = await req.post(external_api_url, payload_to_send);
    
    // Die Antwort des externen Systems zur Fehlerbehebung protokollieren
    log.debug("External API response: " + JSON.stringify(response.data));
    
  } catch (error) {
    log.debug("An error occurred in the Transkript Event script: " + error);
  }
}
```

{% endstep %}
{% endstepper %}

***

### Zusammenfassung und Empfehlungen

Wählen Sie die Integrationsmethode, die am besten zu Ihrem Agenten-Workflow und Ihren technischen Ressourcen passt.

| Wenn Ihre Agents ... verwenden                                   | Dann ist Ihre beste Option ...                                      | Wichtige Überlegungen:                                                                                                                                                                                                                                                                                  |
| ---------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Der ZCC-CTI-Connector in einem unterstützten CRM                 | Die integrierte Integration                                         | <ul><li>Der einfachste Weg</li><li>Keine Programmierung erforderlich</li><li>Die Synchronisierung von Interaktionsdaten ist integriert</li></ul>                                                                                                                                                        |
| Die Zoom Workplace App oder Smart Embed                          | API-Webhooks plus Abgleich durch Polling mit Filterung nach Endzeit | <ul><li>Verwenden <code>Kontakt\_center.cx\_engagement\_end\_data\_ready</code> als Ihr Abrufauslöser</li><li>Gleichen Sie anschließend mit <code>end\_time\_from</code>/<code>end\_time\_to</code> Windows</li><li>Steigert die Effizienz und reduziert gleichzeitig verpasste Interaktionen</li></ul> |
| Ein Flow für eingehendes Messaging (und Daten übertragen müssen) | Flow-Event-Skripte                                                  | <ul><li>Nischenlösung, aber leistungsstark</li><li>Erfordert JavaScript</li><li>Eignet sich am besten zum Senden von Messaging-Transkripten und Dispositions</li></ul>                                                                                                                                  |

Wenn Sie diese unterschiedlichen Wege verstehen, können Sie eine robuste und zuverlässige Integration entwickeln, die Ihnen einen vollständigen Überblick über Ihre Kundeninteraktionen bietet. Durch die Kombination von ereignisgesteuertem Abruf und Abgleich mit Endzeitfilter können Sie unnötige API-Aufrufe reduzieren und gleichzeitig die Vollständigkeit verbessern.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/de/business-dienstleistungen/zoom-contact-center/expert-insights/integrate-engagement-data.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
