> 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ıldı

### 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. Birleşik bir müşteri görünümü oluşturmak, etkili temsilci koçluğunu etkinleştirmek veya Zoom İletişim Merkezi kullanırken uyumluluk gereksinimlerini karşılamak için etkileşim verilerini harici sistemlerde (örneğin, CRM ve diğer kayıt sistemlerinde) nasıl saklayacağınızı öğrenmek 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ı entegrasyon yöntemlerini inceleyeceğiz.

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

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

***

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

Bu en basit yöntemdir. Temsilcileriniz bir ZCC CRM CTI Bağlayıcı kullanıyorsa, çoğu etkileşim verisi 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 Zoom içinde otomatik olarak kaydedilir ve CRM'inizdeki 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şitlemeye izin veren işlevsellik "hazır" olarak gelir, ancak ZCC yönetici portalı içinde etkinleştirilmesi gerekir.

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

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

Yönetici olarak Zoom yönetici portalında oturum açın.  [Yönetim merkezi](https://zoom.com/account), CX yönetimi → İletişim Merkezi → Entegrasyonlar → [Uygulamalar](https://zoom.com/cci/index/admin#/admin-integrations).

İlgili CRM Entegrasyonlar'ını bulun ve verilerin CRM'inizde saklanmasına izin vermek için uygun ayarları etkinleştirin.
{% endstep %}

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

CRM entegrasyonunuzdaki kullanıcının ilgili tüm nesneler için gerekli yazma izinlerine sahip olduğunu doğrulamak üzere  [CRM entegrasyonu kurulum kılavuzlarını inceleyin ve adımları izleyin](https://support.zoom.com/) .
{% endstep %}
{% endstepper %}

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

Bu işlevselliğe, temsilciler aşağıdaki CRM'leri kullandığında ZCC CRM CTI Bağlayıcısı üzerinden erişilebilir:

* Salesforce
* Zendesk
* ServiceNow
* Microsoft Dynamics
* HubSpot

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

***

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

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 olacaktır. 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:

* **Periyodik sorgulama:** Yeni etkileşim verilerinin Uygun olup olmadığını görmek için Zoom API'yi düzenli aralıklarla sorgulayın.
* **Webhook'lar:** Bir döküm hazır olur olmaz Zoom'dan gerçek zamanlı bir Bildirim alın.

Üçüncü bir yaklaşım daha vardır: **Flow Events Entegrasyonlar**. Bu yaklaşım 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ı sorgulamalısınız. Farklı veri türlerinin farklı API'lerden geldiğini unutmamak önemlidir; bu nedenle muhtemelen her ilgili uç nokta için sorgulama mantığı oluşturmanız gerekecektir.

Reports V2 (CX analiz) kapsamındaki etkileşimle ilgili birçok API artık bitiş zamanına göre filtrelemeye şu parametrelerle Destek sağlar: `end_time_from` ve `end_time_to`. Anketleme işlerinizin etkileşimleri gerçekten sona erdikleri zamana göre alması için bu parametreleri uygun olduğunda tercih edin. Bu, etkileşim sona erdiğinde tüm etkileşim verileri (V2 rapor verileri dâhil) son hâline getirildiğinden, kayıtların kaçırılmasını 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>                                                                                                                                                                                      | `download_url`         | Sıra için çağrı kaydının etkinleştirilmiş olması gerekir.                |
| <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>                                                                                                                                                                                      | `transcript_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}">Etkileşim Edinin</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 listele</a></p>   | `transcript_url`       | Döküm, mesajlaşma kanalları için varsayılan olarak etkindir.             |
| <p>Dağıtımlar</p><p>(Tüm Kanallar)</p>                 | <p><a href="https://developers.zoom.us/docs/api/contact-center/#tag/engagements/get/contact_center/engagements/{engagementId}">Etkileşim Edinin</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 listele</a></p>   | `dispositions`         | 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}">Etkileşim Edinin</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 listele</a></p>   | `notes`                | 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> | `download_url`         | Bir İletiş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> | `transcript_url`       | Gelen kutusu için transkripsiyonun etkinleştirilmiş olmasını gerektirir. |

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

İndirme URL'leri (`download_url`, `transcript_url`, `playback_url`, bu Zoom API'leri tarafından sağlanan vb. bilgiler **değil** genel bağlantılar. Bunlar programatik erişim için tasarlanmıştır ve ilişkili dosyayı indirmek için API kimlik doğrulaması (örneğin, Authorization başlığında bir erişim belirteci) gerektirir.

Bu şu anlama gelir:

* Bu URL'leri bir CRM'de doğrudan, bir kullanıcının tıklaması için kaydedemezsiniz. Bağlantıya tarayıcısında tıklayan bir kullanıcı için kimlik doğrulama yapılmış olmayacak ve indirme başarısız olacaktır.
* Doğru yöntem, arka uç hizmetinizin dosyayı almak için URL'yi kullanmasıdır. Hizmetiniz ardından dosyayı kendi sisteminizde (Amazon S3, Azure Blob Storage veya CRM'nizin dosya depolaması gibi) depolayabilir ve kullanıcılarınıza oradan güvenli bir bağlantı sağlayabilir.
  {% endhint %}

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

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

Bu veriler çağrı biter bitmez kullanıma hazır olmaz. Sesin önce işlenip yüklenmesi gerekir; uzun çağrılarda bu işlem birkaç dakika sürebilir. Kayıtları kaçırmadığınızdan emin olmak için şunu ayarlayın `query_date_type` parametresini `recording_end_time` olarak ayarlayın. Bu, verileri çağrının sona erdiği zamana göre değil, işlemenin tamamlandığı zamana göre getirir.

Reports V2 (CX Analiz) etkileşim odaklı mutabakat işleri için çakışan zaman aralıklarını `end_time_from` ve `end_time_to` parametreleriyle kullanarak gecikmeli işleme ve geçici teslimat sorunlarına karşı bir güvenlik payı sağlayı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/) belgelendirme.

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

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

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

1. Zoom App Marketplace'te 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 verileri ya doğrudan ya da sonraki bir API çağrısı için bir URL/ID olarak içerir.

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

* **Etkileşim Sonu Verileri Hazır:** contact\_center.cx\_engagement\_end\_data\_ready (etkileşim sonu raporu V2 verilerinin alınmaya hazır olduğunu belirtir)
* **Ses/Video Kaydı:** kişi\_merkezi.recording\_completed (bir `download_url`)
* **Ses/Video Dökümü:** contact\_center.recording\_transcript\_completed (bir `transcript_url`)
* **Mesajlaşma dökümü:** contact\_center.engagement\_messaging\_transcript\_completed (bir `transcript_url`)
* **Notlar:** contact\_center.engagement\_note\_added (bir `not` not verilerinin bulunduğu alan)
* **Dağıtım:** kişi\_center.engagement\_dağıtım\_added (şunu sağlar: bir `disposition_name` dağıtım verilerini içeren alan)

**Önerilen Kalıp: Etkileşim Verileri Hazır Olduğunda Alımı Tetikleyin**

Aldığınızda `kişi_center.cx_engagement_end_data_ready`, bunu söz konusu etkileşim için etkileşim sonu raporu V2 verilerinin tamamlandığını gösteren işaret olarak değerlendirin. Bu noktada, nihai veri kümesini toplamak için Geçmiş Etkileşim günlüğü verileri API'sini ve ilgili diğer API'leri çağırın. Bu durumda şunu kullanın `engagement_id` arama anahtarınız olarak kullanın ve ardından gerekli uç noktalarınızdan tüm etkileşim verilerini alın.

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

* **Birden Fazla Etkinlik Olabileceğini Unutmayın:** Bu `note_added` ve `dağıtım_added` Tek bir etkileşim için etkinlikler birden çok kez tetiklenebilir (örneğin, bir temsilci birkaç not kaydettiğinde veya bir çağrı aktarıldığında). Uygulama mantığınız bu durumu işleyebilmelidir.
* **Yedeklilik Oluştur:** Etkinlik teslimatının her zaman %100 garantisi yoktur (örneğin, uç noktanız veya WebSocket bağlantınız geçici olarak kesilmiş olabilir).
* **Yedekleme Stratejisi:** Yoklama API'lerini kullanarak bir uzlaştırma betiğini şu sıklıkta çalıştırmanızı öneririz: `end_time_from` ve `end_time_to` kaçırılan olayları yakalamak ve veri boşluklarını kapatmak için Windows
  {% endhint %}

Zoom iletişim merkezi web kancası/WebSocket olayları hakkında daha fazla bilgi için bkz. [İletişim Merkezi Web Kancaları](https://developers.zoom.us/docs/api/contact-center/events/) belgeleri.

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

Belirli veri türleri için, bir JavaScript Etkinlik Betiği kullanarak verileri ZCC Akış düzenleyicisinden doğrudan 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şken.
* **Döküm:** Yalnızca Gelen mesajlaşma etkileşimleri (örneğin, Web Sohbeti) için şu kullanılarak erişilebilir: `global_system.Engagement.döküm` değişken.
* **Birden Çok Akış:** Yapılandırmanızda birden fazla Flow ile çalışırken, özellikle bir Flow ... kullanıyorsa `RouteTo` Başka bir Flow'a bağlanmak için kullanılan widget; tüm Flow'larda aynı Etkinlik Komut Dosyalarının ve tetikleyicilerin doğru şekilde yapılandırıldığından emin olmak çok önemlidir.

Bu yöntem, döküm ve dağıtımı tek bir Etkinlikte birleştirebileceğiniz bir mesajlaşma Flow'unda en etkilidir.

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

Flow'unuzu Yapılandırmak için şu adımları izleyin:

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

ZCC Flow'unuzda (örneğin, bir Web sohbet Flow'unda), Başlat widget'ına tıklayın.

Etkinlik Scriptlerini bulun ve Etkileşim Kapatıldı 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 giderme 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'deki ZCC CTI Bağlayıcı                 | Yerleşik Entegrasyonlar                                                     | <ul><li>En kolay yol</li><li>Kod gerekmez</li><li>Etkileşim verisi Eşitle özelliği yerleşiktir</li></ul>                                                                                                                                                                                          |
| Zoom Workplace uygulaması veya Smart Embed                 | API Webhook’ları ve bitiş zamanına göre filtrelenmiş yoklama ile uzlaştırma | <ul><li>Kullan <code>contact\_center.cx\_engagement\_end\_data\_ready</code> getirme tetikleyiciniz olarak</li><li>Ardından şu öğeyle mutabakat sağlayın <code>end\_time\_from</code>/<code>end\_time\_to</code> Windows</li><li>Kaçırılan etkileşimleri azaltırken verimliliği artırır</li></ul> |
| Bir Gelen mesajlaşma akışı (ve verileri gönderme 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ını 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ü sağlayan sağlam ve güvenilir bir Entegrasyonlar oluşturabilirsiniz. Etkinlik tetiklemeli alma ile bitiş zamanına göre filtrelenmiş 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 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/tr/isletme-hizmetleri/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.
