> 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/sv/business-tjanster/zoom-contact-center/expert-insights/integrate-engagement-data.md).

# Integrera engagemangsdata

Skriven av Justin Steinberg

### Översikt

Zoom kontaktcenter genererar värdefulla engagemangsdata under varje kundinteraktion, inklusive samtalsinspelningar, transkriptioner, anteckningar från agenter och dispositioner. Fortsätt läsa för att lära dig hur du lagrar engagemangsdata i externa system (till exempel CRM och andra system för spela in) för att skapa en enhetlig kundvy, aktivera effektiv agentcoachning eller uppfylla efterlevnadskrav när du använder Zoom kontaktcenter.

Vi delar upp de olika integreringarna för att hjälpa dig välja det bästa tillvägagångssättet utifrån hur dina agenter kan arbeta mer effektivt.

Den bästa metoden beror framför allt på en avgörande faktor: **applikationen där agenterna hanterar sina interaktioner**. De två alternativen som vi ska diskutera är:

1. Agenter som använder det färdiga ZCC CRM CTI-anslutningsprogrammet i CRM-systemet.
2. Agenter som arbetar i Zoom Workplace-appen, vilket kräver en anpassad lösning med ZCC API:er och webhooks.

***

### Standardintegreringar med CRM CTI-anslutningsprogrammet

Detta är den mest okomplicerade metoden. Om dina agenter använder ett ZCC CRM CTI-anslutningsprogram kan de flesta engagemangsdata synkroniseras automatiskt mellan Zoom-plattformen och det lämpliga CRM-systemet.

#### <mark style="color:blå;">Hur det fungerar</mark>

CTI-anslutningsprogrammet bäddar in ZCC-agentgränssnittet direkt i CRM-systemet. När ett engagemang avslutas sparas data som inspelningar, transkriptioner, anteckningar och dispositioner automatiskt i Zoom och länkas till den relevanta posten (till exempel ett ärende eller en kontakt) i ditt CRM.

#### <mark style="color:blå;">Installationskrav</mark>

Funktionalitet som tillåter synkronisering av data mellan Zoom och CRM finns "out of the box", men kräver aktivering i ZCC adminportal.

Slutför följande steg:

{% stepper %}
{% step %}
**Aktivera i ZCC adminportal**

Logga in på Zooms adminportal som administratör. I [admincentret](https://zoom.com/account), gå till CX-hantering → Kontaktcenter → Integreringar → [Applikationer](https://zoom.com/cci/index/admin#/admin-integrations).

Hitta de relevanta CRM integreringar och aktivera de lämpliga inställningarna för att tillåta datalagring i ditt CRM.
{% endstep %}

{% step %}
**CRM-behörigheter**

Läs och följ [installationsguiderna för CRM-integreringar](https://support.zoom.com/) för att kontrollera att användaren för dina CRM-integreringar har nödvändiga skrivbehörigheter för alla relevanta objekt.
{% endstep %}
{% endstepper %}

#### <mark style="color:blå;">Stödda CRM-plattformar</mark>

Den här funktionaliteten är tillgänglig via ZCC CRM CTI-anslutningsprogrammet när agenter använder följande CRM-system:

* Salesforce
* Zendesk
* ServiceNow
* Microsoft Dynamics
* HubSpot

Med CRM CTI-anslutningsprogrammen krävs ingen särskild konfiguration, och integreringar kommer att spara engagemangsdata i CRM:et som standard.

***

### Anpassade integreringar via API:er

Om dina agenter använder den inbyggda Zoom Workplace-appen eller ZCC Smart Embed behöver du en anpassad lösning för att överföra engagemangsdata. Det primära sättet att göra detta är med Zoom kontaktcenter-API:er.

Det finns två huvudsakliga tillvägagångssätt för att få åtkomst till engagemangsdata via API:et:

* **Avfrågning:** Fråga Zoom API regelbundet om ny information om engagemang är tillgänglig.
* **Webhooks:** Ta emot en avisering i realtid från Zoom så snart en avskrift är klar.

Det finns också ett tredje tillvägagångssätt, **Flow Events-integreringar**, som fungerar för vissa datatyper.

#### <mark style="color:blå;">Avfrågning av Zoom kontaktcenter-API:erna</mark>

För att ladda ned engagemangsdata måste du fråga de lämpliga ZCC API-ändpunkterna. Det är viktigt att notera att olika typer av data kommer från olika API:er, så du kommer sannolikt att behöva bygga upp avfrågningslogik för varje relevant ändpunkt.

Många engagemangsrelaterade API:er inom Reports V2 (CX-analyser) stöder nu filtrering efter sluttid med `end_time_from` och `end_time_to`. Föredra dessa parametrar när de är tillgängliga, så att dina avsökningsjobb hämtar engagemang baserat på när de faktiskt har avslutats. Det minskar risken för missade poster eftersom fullständiga engagemangsdata (inklusive data från rapport V2) färdigställs när engagemanget avslutas.

| För att hämta dessa data...                                | Omröstning av detta API...                                                                                                                                                                                                                                                                                                                                                | Använd detta fält... | Anteckningar:                                                   |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | --------------------------------------------------------------- |
| <p>Inspelningsmediefil</p><p>(Röst- och videokanal)</p>    | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/recordings/get/contact_center/recordings">Lista inspelningar</a> eller</p><p>Lista engagemangsinspelningar</p>                                                                                                                                                                                        | `download_url`       | Kräver att samtalsinspelning är aktiverad för kön.              |
| <p>Avskrift av inspelning</p><p>(Röst- och videokanal)</p> | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/recordings/GET/contact_center/recordings">Lista inspelningar</a> eller</p><p>Lista engagemangsinspelningar</p>                                                                                                                                                                                        | `transcript_url`     | Kräver samtalsinspelning med transkription aktiverad.           |
| <p>Avskrift</p><p>(Kanal för meddelanden)</p>              | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Skaffa ett engagemang</a> eller</p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/reports-v2-cx-analytics/get/contact_center/analytics/log/historical/engagement">Lista historiska data för engagemangsloggar</a></p> | `transcript_url`     | Avskrift är aktiverad som standard för kanaler för meddelanden. |
| <p>Dispositioner</p><p>(Alla kanaler)</p>                  | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Skaffa ett engagemang</a> eller</p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/reports-v2-cx-analytics/get/contact_center/analytics/log/historical/engagement">Lista historiska data för engagemangsloggar</a></p> | `dispositions`       | En array av disposition-objekt.                                 |
| <p>Anteckningar</p><p>(Alla kanaler)</p>                   | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Skaffa ett engagemang</a> eller</p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/reports-v2-cx-analytics/get/contact_center/analytics/log/historical/engagement">Lista historiska data för engagemangsloggar</a></p> | `notes`              | En array av anteckningsobjekt.                                  |
| <p>Mediafil för röstbrevlåda</p><p><br><br></p>            | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/messages">Visa en lista över ett kontos inkorgsmeddelanden</a> <strong>eller</strong></p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/{inboxId}/messages">Lista inkorgens meddelanden</a></p>            | `download_url`       | För röstbrevlådor som lämnats i en kontaktcenterinkorg.         |
| Avskrift av röstbrevlåda                                   | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/messages">Visa en lista över ett kontos inkorgsmeddelanden</a> <strong>eller</strong></p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/{inboxId}/messages">Lista inkorgens meddelanden</a></p>            | `transcript_url`     | Kräver att transkription är aktiverad för inkorgen.             |

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

Nedladdningsadresserna (`download_url`, `avskrift_url`, `playback_url`, och så vidare) som tillhandahålls av dessa Zoom-API:er är **inte** offentliga länkar. De är utformade för programmatisk åtkomst och kräver API-autentisering (till exempel en access token i Authorization-headern) för att ladda ner den tillhörande filen.

Det betyder:

* Du kan inte spara dessa URL:er direkt i ett CRM för att en användare ska klicka på dem. En användare som klickar på länken i sin webbläsare kommer inte att vara autentiserad, och nedladdningen kommer att misslyckas.
* Det korrekta sättet är att din backend-tjänst använder URL:en för att hämta filen. Din tjänst kan sedan lagra filen i ditt eget system (till exempel Amazon S3, Azure Blob Storage eller din CRM:s fillagring) och därifrån tillhandahålla en säker länk till dina användare.
  {% endhint %}

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

**Bearbetningsförseningar - röst- och videoinspelningar:**

De här uppgifterna är inte tillgängliga direkt när ett samtal avslutas. Ljudet måste först bearbetas och laddas upp, vilket kan ta flera minuter för långa samtal. Ställ in `query_date_type` -parametern till `recording_end_time` när du avfrågar API:et för att lista inspelningar. Detta hämtar data baserat på när bearbetningen slutfördes, inte när samtalet avslutades.

För engagemangsbaserade avstämningsjobb i Reports V2 (CX-analyser), använd överlappande tidsfönster med `end_time_from` och `end_time_to` för att skapa en säkerhetsmarginal vid försenad bearbetning och tillfälliga leveransproblem.
{% endhint %}

Mer information om API:er för Zoom kontaktcenter finns i [API:er för kontaktcenter](https://developers.zoom.us/docs/api/contact-center/) dokumentation.

#### <mark style="color:blå;">Använd webhook för händelser i realtid</mark>

För ett mer omedelbart, evenemangsdrivet tillvägagångssätt kan du prenumerera på ZCC-webhook. Detta är den mest effektiva metoden för integreringar i nära realtid.

**Hur det fungerar**

1. Prenumerera på lämpliga evenemang i Zoom App Marketplace.
2. När ett evenemang inträffar skickar Zoom en avisering till din webhook-URL (eller till din Websocket-anslutning).
3. Evenemangets nyttolast innehåller de data du behöver, antingen direkt eller som en URL/ID för ett uppföljande API-samtal.

**Vanliga webhook-evenemang för engagemangsdata**

* **Data för avslutat engagemang är redo:** contact\_center.cx\_engagement\_end\_data\_ready (anger att data för engagemangsslutsrapport V2 är redo att hämtas)
* **Röst-/videoinspelning:** kontakt\_center.recording\_completed (tillhandahåller en `download_url`)
* **Avskrift av röst/video:** kontakt\_center.recording\_avskrift\_completed (tillhandahåller en `transcript_url`)
* **Avskrift av meddelanden:** kontakt\_center.engagement\_meddelanden\_avskrift\_completed (tillhandahåller en `avskrift_url`)
* **Obs:** contact\_center.engagement\_note\_added (tillhandahåller en `note` fält med anteckningsdata)
* **Disposition:** kontakt\_center.engagement\_disposition\_added (tillhandahåller en `disposition_name` fält med disposition-data)

**Rekommenderat mönster: Utlös hämtning när engagemangsdata är klart**

När du får `kontakt_center.cx_engagement_end_data_ready`, betrakta det som en signal om att V2-data för rapporten om avslutat engagemang är komplett för det engagemanget. Anropa då API:et för historiska engagemangsloggdata och alla andra relevanta API:er för att samla in den slutliga datamängden. I det här evenemanget använder du `engagement_id` som uppslagsnyckel och hämta sedan de fullständiga engagemangsartefakterna från de obligatoriska slutpunkterna.

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

* **Var uppmärksam på flera händelser:** Den `note_added` och `disposition_added` evenemang kan utlösas flera gånger för ett och samma ärende (till exempel om en agent sparar flera anteckningar eller ett samtal överförs). Applikationslogiken måste kunna hantera detta.
* **Bygg in redundans:** Leverans av evenemang är inte alltid garanterad till 100 % (till exempel kan din ändpunkt eller websocket-anslutning tillfälligt ligga nere).
* **Reservstrategi:** Vi rekommenderar att du kör ett avstämningsskript med hjälp av avsöknings-API:er och `end_time_from` och `end_time_to` -fönster för att fånga upp missade evenemang och täppa till dataluckor.
  {% endhint %}

Mer information om webhook-/WebSocket-händelser i Zooms kontaktcenter finns i [Webhooks för kontaktcenter](https://developers.zoom.us/docs/api/contact-center/events/) dokumentation.

#### <mark style="color:blå;">Flödesintegreringar för evenemang</mark>

För vissa datatyper kan du skicka data direkt till ett externt system från ZCC-flödesredigeraren med ett JavaScript-evenemangsskript.

**Stödda data och begränsningar:**

* **Disposition:** Kan nås på alla typer av inkommande engagemangskanaler med hjälp av `global_system.Engagement.disposition` variabel.
* **Avskrift:** Endast tillgängligt för inkommande meddelandeengagemang (till exempel webbchatt) med hjälp av `global_system.Engagement.avskrift` variabel.
* **Flera flöden:** När du arbetar med flera Flows i din konfiguration, särskilt när ett Flow använder `RouteTo` widget för att ansluta till ett annat flöde är det viktigt att se till att identiska evenemangsskript och utlösare är korrekt konfigurerade i alla flöden.

Denna metod är som mest kraftfull i ett meddelandeflöde, där du kan kombinera både avskriften och disposition i ett enda evenemang.

**Konfigurationssteg**

Följ dessa steg för att konfigurera ditt flöde:

{% stepper %}
{% step %}
**Lägg till ett evenemangsskript**

I ditt ZCC-flöde (till exempel ett webbchattflöde), klicka på Start-widgeten.

Leta reda på evenemangsskript och lägg till ett evenemangsskript för evenemang, till exempel Engagement Closed och/eller Disposition Saved.

<div align="left"><figure><img src="https://460446308-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 %}
**Lägg till din anpassade JavaScript-kod**

Exemplet nedan hämtar både disposition och avskrift och skickar dem sedan tillsammans till ett externt API.

```javascript
async function main () { 
  try {
    // Hämta disposition-objektet från variabeln
    const disposition_data = var_get()['global_system.Engagement.disposition'];
    
    // Hämta hela avskrift-objektet
    const avskrift_data = await req.get(var_get()['global_system.Engagement.avskrift']);

    // Förbered en nyttolast med all data du vill skicka
    const payload_to_send = {
      disposition: disposition_data.data.result,
      avskrift: avskrift_data.data.result.avskrift
    };

    // Definiera destinationen för dina data
    const external_api_url = '<ersätt-med-din-api-ändpunkt>';
    
    // Skicka de kombinerade uppgifterna till ditt externa system
  	const response = await req.post(external_api_url, payload_to_send);
    
    // Logga svaret från det externa systemet för felsökning
    log.debug("Externt API-svar: " + JSON.stringify(response.data));
    
  } catch (error) {
    log.debug("Ett fel uppstod i avskrift-evenemangsskriptet: " + error);
  }
}
```

{% endstep %}
{% endstepper %}

***

### Sammanfattning och rekommendationer

Att välja den metod för integreringar som bäst stämmer överens med ditt agentarbetsflöde och dina tekniska resurser.

| Om dina agenter använder...                                   | Då är ditt bästa alternativ...                                  | Viktiga överväganden:                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ZCC CTI-anslutningsprogrammet i ett CRM som stöds             | Den inbyggda integreringar-lösningen                            | <ul><li>Enklaste vägen</li><li>Ingen kod krävs</li><li>Den inbyggda synkronisera-funktionen för engagemangsdata</li></ul>                                                                                                                                                             |
| Zoom Workplace appen eller Smart Embed                        | API-webhooks plus avstämning av polling filtrerad efter sluttid | <ul><li>Använd <code>kontakt\_center.cx\_engagement\_end\_data\_ready</code> som din hämtningsutlösare</li><li>Stäm sedan av mot <code>end\_time\_from</code>/<code>end\_time\_to</code> fönster</li><li>Förbättrar effektiviteten samtidigt som missade engagemang minskar</li></ul> |
| Ett inkommande meddelandeflöde (och behov av att skicka data) | Skript för flödesevenemang                                      | <ul><li>Nischat, men kraftfullt</li><li>Kräver JavaScript</li><li>Fungerar bäst för att skicka meddelandeavskrifter och dispositioner</li></ul>                                                                                                                                       |

Genom att förstå dessa olika vägar kan du bygga robusta och pålitliga integreringar som ger dig en komplett bild av dina kundinteraktioner. Att kombinera evenemangsutlöst hämtning med avstämning filtrerad efter sluttid hjälper dig att minska onödiga API-anrop samtidigt som fullständigheten förbättras.


---

# 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/sv/business-tjanster/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.
