> 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/tr/isletme-hizmetleri/zoom-contact-center/expert-insights/integrate-engagement-data.md).

# Etkileşim Verilerini Entegre Etme

Justin Steinberg tarafından yazılmıştır

### Genel Bakış

Zoom İletişim Merkezi, çağrı kayıtları, dökümler, temsilci notları ve sonuçlar dahil olmak üzere her müşteri etkileşimi sırasında değerli etkileşim verileri oluşturur. Zoom İletişim Merkezi’ni kullanırken etkileşim verilerini harici sistemlerde (örneğin CRM ve diğer kayıt sistemlerinde) nasıl saklayacağınızı öğrenmek, birleşik bir müşteri görünümü oluşturmak, etkili temsilci koçluğunu etkinleştirmek veya uyumluluk gereksinimlerini karşılamak için okumaya devam edin.

Temsilcilerinizin artan verimlilikle nasıl çalışabileceğine bağlı olarak en iyi yaklaşımı seçmenize yardımcı olmak için farklı Entegrasyonlar yöntemlerini açıklayacağız.

En iyi yöntem öncelikle tek bir temel faktöre bağlıdır: **temsilcilerin etkileşimlerini yönettiği uygulama**. Tartışacağımız iki seçenek şunlardır:

1. CRM içinde hazır ZCC CRM CTI Bağlayıcıyı kullanan temsilciler.
2. Zoom Workplace uygulamasında çalışan temsilciler; bu, ZCC API'leri ve Webhook'larla özel bir çözüm gerektirir.

***

### Hazır CRM CTI Bağlayıcı Entegrasyonları

Bu en basit yöntemdir. Temsilcileriniz bir ZCC CRM CTI Bağlayıcı kullanıyorsa, etkileşim verilerinin çoğu Zoom platformu ile uygun CRM arasında otomatik olarak eşitlenebilir.

#### <mark style="color:mavi;">Nasıl Çalışır</mark>

CTI Bağlayıcı, ZCC temsilci arayüzünü doğrudan CRM içine yerleştirir. Bir etkileşim sona erdiğinde, kayıtlar, dökümler, notlar ve sonuçlar gibi veriler otomatik olarak Zoom içinde kaydedilir ve CRM'nizde ilgili kayda (örneğin, bir bilet veya kişi) bağlanır.

#### <mark style="color:mavi;">Kurulum Gereksinimleri</mark>

Zoom ile CRM arasında veri eşitlemesine izin veren işlevsellik "hazır gelir", ancak ZCC yönetici portalında etkinleştirilmesi gerekir.

Aşağıdaki adımları tamamlayın:

{% stepper %}
{% step %}
**ZCC Yönetici Portalında Etkinleştir**

Zoom yönetici portalında yönetici olarak oturum açın ve İletişim Merkezi Yönetimi > Entegrasyonlar > Uygulamalar yoluna gidin.

İlgili CRM entegrasyonunu bulun ve CRM'nizde veri saklamaya izin vermek için uygun Ayarlar'ı etkinleştirin.
{% endstep %}

{% step %}
**CRM İzinleri**

şunu gözden geçirin ve izleyin: [CRM entegrasyonu kurulum kılavuzları](https://support.zoom.com/) CRM entegrasyon kullanıcı hesabınızın tüm ilgili nesneler için gerekli yazma izinlerine sahip olduğunu doğrulamak için.
{% endstep %}
{% endstepper %}

#### <mark style="color:mavi;">Desteklenen CRM Platformları</mark>

Bu işlevsellik, temsilciler aşağıdaki CRM'leri kullandığında ZCC CRM CTI Bağlayıcı aracılığıyla erişilebilir:

* Salesforce
* Zendesk
* ServiceNow
* Microsoft Dynamics
* HubSpot

CRM CTI bağlayıcılarıyla özel yapılandırma gerekmez ve entegrasyon etkileşim verilerini varsayılan olarak CRM'ye kaydeder.

***

### Özel Entegrasyonlar aracılığıyla API'ler

Temsilcileriniz yerel Zoom Workplace uygulamasını veya ZCC Smart Embed'i kullanıyorsa, etkileşim verilerini aktarmak için özel bir çözüme ihtiyacınız olacak. Bunu yapmanın temel yolu Zoom İletişim Merkezi API'leridir.

API aracılığıyla etkileşim verilerine erişmek için iki ana yaklaşım vardır:

* **Polling:** Yeni etkileşim verilerinin Uygun olup olmadığını görmek için Zoom API'sini periyodik olarak sorgulayın.
* **Webhook'lar:** Döküm hazır olur olmaz Zoom'dan gerçek zamanlı bir Bildirim alın.

Bir üçüncü yaklaşım da vardır, **Flow Events Entegrasyonu**, bu belirli veri türleri için çalışır.

#### <mark style="color:mavi;">Zoom İletişim Merkezi API'lerini Sorgulama</mark>

Etkileşim verilerini indirmek için uygun ZCC API uç noktalarını sorgulamanız gerekir. Farklı veri türlerinin farklı API'lerden geldiğini unutmamak önemlidir, bu nedenle büyük olasılıkla her ilgili uç nokta için sorgulama mantığı oluşturmanız gerekir.

Reports V2 (CX Analiz) içindeki etkileşimle ilgili birçok API artık ile bitiş zamanı filtrelemeyi destekliyor `end_time_from` ve `end_time_to`. Uygun olduğunda bu parametreleri tercih edin; böylece sorgulama işleriniz etkileşimleri gerçekten ne zaman sona erdiklerine göre alır. Bu, tam etkileşim verileri (Report V2 verileri dahil) etkileşim sonunda kesinleştiğinden, kaçırılan kayıtları azaltmaya yardımcı olur.

| Bu Veriyi Almak İçin...                               | Bu API'yi Sorgulayın...                                                                                                                                                                                                                                                                                                                                                  | Bu Alanı Kullanarak... | Notlar:                                                             |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ------------------------------------------------------------------- |
| <p>Kayıt Medya Dosyası</p><p>(Ses ve Video kanal)</p> | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/recordings/get/contact_center/recordings">Kayıtları listele</a> veya</p><p>Etkileşim Kayıtlarını Listele</p>                                                                                                                                                                                         | `indirme_url`          | Kuyruk için çağrı kaydı etkinleştirilmelidir.                       |
| <p>Kayıt Dökümü</p><p>(Ses ve Video kanal)</p>        | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/recordings/GET/contact_center/recordings">Kayıtları listele</a> veya</p><p>Etkileşim Kayıtlarını Listele</p>                                                                                                                                                                                         | `döküm_url`            | Transkripsiyon etkinleştirilmiş çağrı kaydı gerektirir.             |
| <p>Döküm</p><p>(Mesajlaşma Kanalı)</p>                | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Bir etkileşim alın</a> veya</p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/reports-v2-cx-analytics/get/contact_center/analytics/log/historical/engagement">Geçmiş etkileşim günlüğü verilerini listeleyin</a></p> | `döküm_url`            | Döküm, mesajlaşma kanalları için varsayılan olarak etkindir.        |
| <p>Sonuçlar</p><p>(Tüm Kanallar)</p>                  | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Bir etkileşim alın</a> veya</p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/reports-v2-cx-analytics/get/contact_center/analytics/log/historical/engagement">Geçmiş etkileşim günlüğü verilerini listeleyin</a></p> | `dağıtımlar`           | Dağıtım nesnelerinden oluşan bir dizi.                              |
| <p>Notlar</p><p>(Tüm Kanallar)</p>                    | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Bir etkileşim alın</a> veya</p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/reports-v2-cx-analytics/get/contact_center/analytics/log/historical/engagement">Geçmiş etkileşim günlüğü verilerini listeleyin</a></p> | `notlar`               | Not nesnelerinden oluşan bir dizi.                                  |
| <p>sesli mesaj medya dosyası</p><p><br><br></p>       | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/messages">Bir hesabın gelen kutusu mesajlarını listele</a> <strong>veya</strong></p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/{inboxId}/messages">Bir gelen kutusunun mesajlarını listele</a></p>    | `indirme_url`          | Bir iletişim merkezi gelen kutusunda bırakılan sesli mesajlar için. |
| Sesli Mesaj Dökümü                                    | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/messages">Bir hesabın gelen kutusu mesajlarını listele</a> <strong>veya</strong></p><p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/inboxes/GET/contact_center/inboxes/{inboxId}/messages">Bir gelen kutusunun mesajlarını listele</a></p>    | `döküm_url`            | Gelen kutusu için transkripsiyonun etkinleştirilmesini gerektirir.  |

{% hint style="danger" %}
**Uyarı**

İndirme URL'leri (`indirme_url`, `döküm_url`, `playback_url`, vb.) bu Zoom API'leri tarafından sağlanır **değil** genel bağlantılardır. Programatik erişim için tasarlanmışlardır ve ilişkili dosyayı indirmek için API kimlik doğrulama (örneğin, Authorization başlığında erişim belirteci) gerektirir.

Bu, şu anlama gelir:

* Bu URL'leri, bir kullanıcının tıklaması için doğrudan bir CRM içinde kaydedemezsiniz. Bir kullanıcının bağlantıyı tarayıcıda tıklaması doğrulanmış olmayacaktır ve indirme başarısız olur.
* Doğru yöntem, URL'yi dosyayı almak için arka uç hizmetinizin kullanmasıdır. Hizmetiniz daha sonra dosyayı kendi sisteminizde (Amazon S3, Azure Blob Storage veya CRM'nizin dosya depolaması gibi) saklayabilir ve oradan kullanıcılarınıza güvenli bir bağlantı sağlayabilir.
  {% endhint %}

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

**İşleme Gecikmeleri - Ses ve Video Kayıtları:**

Bu veri, bir çağrı biter bitmez uygun değildir. Ses önce işlenmeli ve yüklenmelidir; bu da uzun çağrılar için birkaç dakika sürebilir. Kayıtları kaçırmadığınızdan emin olmak için `query_date_type` parametresini `recording_end_time` List recordings API'sini sorgularken ayarlayın. Bu, verileri çağrının bittiği zamana göre değil, işlemenin ne zaman tamamlandığına göre getirir.

Reports V2 (CX analiz) etkileşim merkezli mutabakat işleri için, `end_time_from` ve `end_time_to` gecikmeli işleme ve geçici teslim sorunları için bir güvenlik payı sağlamak üzere örtüşen zaman aralıkları kullanın.
{% endhint %}

Zoom iletişim merkezi API'leri hakkında daha fazla bilgi için bkz. [İletişim merkezi API'leri](https://developers.zoom.us/docs/api/contact-center/) dokümantasyon.

#### <mark style="color:mavi;">Gerçek Zamanlı Olaylar için Webhook'ları Kullanın</mark>

Daha anlık, Etkinlik odaklı bir yaklaşım için ZCC web kancalarına abone olabilirsiniz. Bu, neredeyse gerçek zamanlı Entegrasyonlar için en verimli yöntemdir.

**Nasıl Çalışır**

1. Zoom App Marketplace içinde uygun etkinliklere abone olun.
2. Bir Etkinlik gerçekleştiğinde, Zoom web kancası URL'nize (veya Websocket bağlantınıza) bir Bildirim gönderir.
3. Etkinlik yükü, ihtiyacınız olan veriyi ya doğrudan ya da takip amaçlı bir API çağrısı için URL/ID olarak içerir.

**Etkileşim Verileri için Ortak web kancası Olayları**

* **Etkileşim Sonu Verisi Hazır:** kişi\_center.cx\_engagement\_end\_data\_ready (etkileşim sonu raporu V2 verilerinin alınmaya hazır olduğunu belirtir)
* **Ses/Video Kaydı:** kişi\_center.recording\_completed (sağlayan bir `indirme_url`)
* **Ses/Video Dökümü:** kişi\_center.recording\_döküm\_completed (sağlayan bir `döküm_url`)
* **Mesajlaşma Dökümü:** kişi\_center.engagement\_mesajlaşma\_döküm\_completed (sağlayan bir `döküm_url`)
* **Notlar:** kişi\_center.engagement\_note\_added (sağlayan bir `not` not verilerini içeren alan)
* **Dağıtım:** kişi\_center.engagement\_dağıtım\_added (bir `dağıtım_adı` dağıtım verilerini içeren alan)

**Önerilen Kalıp: Etkileşim Verisi Hazır Olduğunda Çekimi Tetikle**

Şunu aldığınızda `kişi_center.cx_engagement_end_data_ready`, bunu, o etkileşim için engagement-end report V2 verilerinin tamamlandığına dair sinyaliniz olarak kabul edin. Bu noktada, Historical Engagement log data API'sini ve diğer ilgili API'leri çağrı yapın ve nihai veri kümesini toplamak için kullanın. Bu Etkinlikte, `engagement_id` aradığınız anahtar olarak kullanın ve ardından gerekli uç noktalardan tam etkileşim varlıklarını çekin.

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

* **Birden Fazla Etkinlikten Haberdar Olun:** Bu `not_eklendi` ve `dağıtım_eklendi` Etkinlikler tek bir etkileşim için birden çok kez tetiklenebilir (örneğin, bir temsilci birkaç not kaydederse veya bir çağrı aktarılırsa). Uygulama mantığınız bunu ele alabilecek durumda olmalıdır.
* **Yedeklilik Oluşturun:** Etkinlik teslimatı her zaman %100 garantili değildir (örneğin, uç noktanız veya websocket bağlantınız geçici olarak kapalı olabilir).
* **Yedekleme Stratejisi:** Kaçırılan Etkinlikleri yakalamak ve veri boşluklarını kapatmak için polling API'leriyle Windows kullanan bir uzlaştırma betiği çalıştırmanızı öneririz. `end_time_from` ve `end_time_to` kaçırılan etkinlikleri yakalamak ve veri boşluklarını kapatmak için Windows
  {% endhint %}

Zoom iletişim merkezi web kancası/websocket Etkinlikleri hakkında daha fazla bilgi için bkz. [İletişim Merkezi Webhook'ları](https://developers.zoom.us/docs/api/contact-center/events/) dokümantasyon.

#### <mark style="color:mavi;">Akış Etkinlikleri Entegrasyonlar</mark>

Belirli veri türleri için, bir JavaScript Etkinlik Betiği kullanarak verileri doğrudan ZCC Akış düzenleyicisinden harici bir sisteme gönderebilirsiniz.

**Desteklenen Veriler ve Sınırlamalar:**

* **Dağıtım:** Şu kullanılarak tüm Gelen etkileşim kanal türlerinde erişilebilir `global_system.Engagement.dağıtım` değişkeni.
* **Döküm:** Yalnızca Gelen mesajlaşma etkileşimleri (örneğin, Web sohbet) için şu kullanılarak erişilebilir `global_system.Engagement.döküm` değişkeni.
* **Birden Çok Akış:** Yapılandırmanızda birden çok Akış ile çalışırken, özellikle bir Akışın kullandığı `RouteTo` widget'ını başka bir Akışa bağlamak için, aynı Etkinlik Scriptlerinin ve tetikleyicilerin tüm Akışlar genelinde doğru şekilde Yapılandırıldığından emin olmak çok önemlidir.

Bu yöntem, hem dökümü hem de dağıtımı tek bir Etkinlikte birleştirebileceğiniz bir mesajlaşma Akışında en güçlüdür.

**Yapılandırma Adımları**

Akışınızı Yapılandırmak için şu adımları izleyin:

{% stepper %}
{% step %}
**Bir Etkinlik Scripti Ekle**

ZCC Akışınızda (örneğin, bir Web sohbet akışında), Başlat widget'ına tıklayın.

Etkinlik Scriptlerini bulun ve Engagement Closed ve/veya Dağıtım Kaydedildi gibi Etkinlikler için bir Etkinlik Scripti Ekle.

<div align="left"><figure><img src="https://4003797241-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 %}
**Özel JavaScript'inizi Ekle**

Aşağıdaki örnek hem dağıtım hem de dökümü alır, ardından bunları birlikte harici bir API'ye gönderir.

```javascript
async function main () { 
  try {
    // dağıtım nesnesini değişkeninden alın
    const dağıtım_data = var_get()['global_system.Engagement.dağıtım'];
    
    // tam döküm nesnesini alın
    const döküm_data = await req.get(var_get()['global_system.Engagement.döküm']);

    // göndermek istediğiniz tüm verilerle bir yük hazırlayın
    const payload_to_send = {
      dağıtım: dağıtım_data.data.result,
      döküm: döküm_data.data.result.döküm
    };

    // Verileriniz için hedefi tanımlayın
    const external_api_url = '<kendi API uç nokta adresinizle değiştirin>';
    
    // birleştirilmiş verileri harici sisteminize gönderin
  	const response = await req.post(external_api_url, payload_to_send);
    
    // Sorun gidermek için harici sistemden gelen yanıtı kaydedin
    log.debug("Harici API yanıtı: " + JSON.stringify(response.data));
    
  } catch (error) {
    log.debug("döküm Etkinlik betiğinde bir hata oluştu: " + error);
  }
}
```

{% endstep %}
{% endstepper %}

***

### Özet ve Öneriler

Ajan iş akışınız ve teknik kaynaklarınızla en iyi uyum sağlayan Entegrasyonlar yöntemini Seç.

| Ajanlarınız ... kullanıyorsa                           | O zaman en iyi seçeneğiniz ...                                   | Temel Hususlar:                                                                                                                                                                                                                                                                        |
| ------------------------------------------------------ | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Desteklenen bir CRM'de ZCC CTI Bağlayıcı               | Yerleşik Entegrasyonlar                                          | <ul><li>En kolay yol</li><li>Kod gerekmez</li><li>Engagement verisi Eşitle yerleşiktir</li></ul>                                                                                                                                                                                       |
| Zoom Workplace uygulaması veya Smart Embed             | API Webhook'ları artı bitiş zamanı filtreli yoklama uzlaştırması | <ul><li>Kullanım <code>kişi\_center.cx\_engagement\_end\_data\_ready</code> alma tetikleyiciniz olarak</li><li>Ardından ... ile uzlaştırın <code>end\_time\_from</code>/<code>end\_time\_to</code> pencereler</li><li>Kaçırılan etkileşimleri azaltırken verimliliği artırır</li></ul> |
| Bir Gelen mesajlaşma Akışı (ve verileri itme ihtiyacı) | Akış Etkinlik Betikleri                                          | <ul><li>Niş ama güçlü</li><li>JavaScript gerektirir</li><li>mesajlaşma dökümlerini ve dağıtımları göndermek için en iyi sonucu verir</li></ul>                                                                                                                                         |

Bu farklı yolları anlayarak, müşteri etkileşimlerinizin eksiksiz bir görünümünü veren sağlam ve güvenilir bir Entegrasyonlar oluşturabilirsiniz. Etkinlik tetiklemeli alma ile bitiş zamanı filtreli uzlaştırmayı birleştirmek, eksiksizliği artırırken gereksiz API çağrılarını azaltmanıza yardımcı olur.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://library.zoom.com/technical-library/tr/isletme-hizmetleri/zoom-contact-center/expert-insights/integrate-engagement-data.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.