> 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 Edin

### Genel Bakış

Zoom iletişim merkezi, çağrı kayıtları, dökümler, temsilci notları ve işlem 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 iletişim merkezi kullanırken uyumluluk gereksinimlerini karşılamak için etkileşim verilerinin harici sistemlerde (örneğin CRM ve diğer kayıt sistemleri) nasıl depolanacağını öğrenmek için okumaya devam edin.

Temsilcilerinizin daha yüksek verimlilikle nasıl çalışabileceğine bağlı olarak en iyi yaklaşımı seçmenize yardımcı olmak için farklı Entegrasyonlar yöntemlerini ele alacağız.

En iyi yöntem öncelikle tek bir ana 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ısını kullanan temsilciler.
2. Özel bir çözüm gerektiren ZCC API'leri ve Webhook'ları kullanan 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ısı 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ısı, ZCC temsilci arayüzünü doğrudan CRM içine gömer. Bir etkileşim sona erdiğinde, kayıtlar, dökümler, notlar ve işlem 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şitlemesine izin veren işlevsellik "kutudan çıktığı gibi" 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ına yönetici olarak giriş yapın ve İletişim Merkezi Yönetimi > Entegrasyonlar > uygulama bölümüne gidin.

İlgili CRM Entegrasyonunu bulun ve CRM'inizde veri depolamaya izin vermek için uygun Ayarları etkinleştirin.
{% endstep %}

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

gözden geçirin ve izleyin [CRM Entegrasyon kurulum kılavuzları](https://support.zoom.com/) CRM entegrasyon kullanıcı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>

Temsilciler aşağıdaki CRM'leri kullandığında bu işlevselliğe ZCC CRM CTI Bağlayıcısı aracılığıyla 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 yerleşik 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 iletişim merkezi API'leridir.

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

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

Ayrıca üçüncü bir yaklaşım da var, **Flow Events Entegrasyonları**, bu da belirli veri türleri için çalışır.

#### <mark style="color:mavi;">Zoom iletiş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 belirtmek önemlidir; bu nedenle muhtemelen her ilgili uç nokta için anketleme mantığı oluşturmanız gerekecektir.

Reports V2 (CX analiz) içindeki etkileşimle ilgili birçok API artık uç zaman filtrelemesini ile `end_time_from` ve `end_time_to`. Bu parametreleri uygun olduğunda tercih edin, böylece anketleme işleriniz etkileşimleri gerçekten ne zaman sona erdiklerine göre alır. Bu, eksik kayıtların azaltılmasına yardımcı olur; çünkü tam etkileşim verisi (report V2 verileri dahil) etkileşim sonunda kesinleşir.

| Bu Veriyi Almak İçin...                                | Bu API'yi Sorgula...                                                                                                                                                                                                                                                                                                                                                  | Bu Alanı Kullanırken... | 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`          | Kuyruk için çağrı kaydının etkinleştirilmesi 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>                                                                                                                                                                                      | `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ük verilerini listele</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ük verilerini listele</a></p>  | `sonuçlar`              | 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ük verilerini listele</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> | `download_url`          | İ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> | `döküm_url`             | Gelen kutusu için transkripsiyonun etkinleştirilmesi gerekir.   |

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

İndirme URL'leri (`download_url`, `döküm_url`, `playback_url`, ve benzerleri) bu Zoom API'leri tarafından sağlanan **değil** herkese açık bağlantılar değildir. Programatik erişim için tasarlanmıştır ve ilişkilendirilmiş dosyayı indirmek için API kimlik doğrulaması (örneğin, Authorization başlığındaki erişim belirteci) gerektirir.

Bu şu anlama gelir:

* Bu URL'leri bir CRM'de doğrudan, bir kullanıcıın tıklaması için kaydedemezsiniz. Bir kullanıcının bağlantıya tarayıcısında tıklaması durumunda kimlik doğrulama yapılmayacak 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) saklayabilir ve oradan kullanıcılarınıza güvenli bir bağlantı sağlayabilir.
  {% endhint %}

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

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

Bu veri, bir çağrı biter bitmez Uygun değildir. Ses önce işlenip yüklenmelidir; uzun çağrılar için bu işlem birkaç dakika sürebilir. Kayıtları kaçırmamanız için, şunu ayarlayın `query_date_type` parametresini `recording_end_time` List recordings API'sini sorgularken kullanın. Bu, verileri işlemenin ne zaman tamamlandığına göre çeker, çağrının ne zaman bittiğine göre değil.

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

Zoom iletişim merkezi API'leri hakkında daha fazla bilgi için bkz. [iletiş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 güdümlü bir yaklaşım için ZCC webhooks'a 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 bir Bildirim gönderir (veya WebSocket bağlantınıza).
3. Etkinlik yükü, ihtiyacınız olan verileri ya doğrudan ya da bir takip API çağrısı için bir URL/Kimlik olarak içerir.

**Etkileşim Verileri için Yaygın 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.kayıt\_tamamlandı (bir sağlar `download_url`)
* **Ses/Video döküm:** kişi\_center.kayıt\_döküm\_tamamlandı (bir sağlar `döküm_url`)
* **mesajlaşma döküm:** kişi\_center.etkileşim\_mesajlaşma\_döküm\_tamamlandı (bir sağlar `döküm_url`)
* **Notlar:** kişi\_center.etkileşim\_not\_eklendi (bir sağlar `not` not verilerini içeren alan)
* **dağıtım:** kişi\_center.etkileşim\_dağıtım\_eklendi (bir sağlar `dağıtım_name` dağıtım verisini içeren alan)

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

Aldığınızda `kişi_center.cx_engagement_end_data_ready`, bunu etkileşim sonu raporu V2 verilerinin o Etkileşim için tamamlandığına dair sinyaliniz olarak kabul edin. Bu noktada, son veri kümesini toplamak için Historical Engagement günlük verileri API'sine ve diğer ilgili API'lere çağrı yapın. Bu Etkinlikte, `engagement_id` arama anahtarınız olarak kullanın ve ardından gerekli uç noktalarınızdan eksiksiz etkileşim varlıklarını alın.

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

* **Birden çok Etkinliğin farkında 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 alabilmelidir.
* **Yedeklilik oluşturun:** Etkinlik teslimi her zaman %100 garantili değildir (örneğin, uç noktanız veya websocket bağlantınız geçici olarak çevrimdışı olabilir).
* **Yedekleme Stratejisi:** Polling API'leriyle bir mutabakat betiği çalıştırmanızı öneririz `end_time_from` ve `end_time_to` kaçırılmış Etkinlikleri yakalamak ve veri boşluklarını kapatmak için zaman pencereleri.
  {% endhint %}

Zoom iletişim merkezi web kancası/websocket Etkinlikleri hakkında daha fazla bilgi için, bkz. [iletişim merkezi web kancaları](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 ZCC Flow düzenleyicisinden verileri 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şkeni.
* **Döküm:** Yalnızca Gelen mesajlaşma etkileşimleri için (örneğin, Web sohbet) şu kullanılarak erişilebilir `global_system.Engagement.döküm` değişkeni.
* **Birden Fazla Akış:** Yapılandırmanızda birden fazla Flow ile çalışırken, özellikle bir Flow başka bir Flow'a bağlanmak için RouteTo widget'ını kullandığında `RouteTo` özdeş Etkinlik Betikleri ve tetikleyicilerin tüm Flow'larda doğru şekilde Yapılandırılmış olduğundan emin olmak önemlidir.

Bu yöntem, bir mesajlaşma Flow'unda en güçlüdür; burada hem dökümü hem de dağıtımı tek bir Etkinlikte birleştirebilirsiniz.

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

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

{% stepper %}
{% step %}
**Bir Etkinlik Betiği Ekle**

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

Etkinlik Betiklerini bulun ve Etkileşim Kapatıldı ve/veya Dağıtım Kaydedildi gibi Etkinlikler için bir Etkinlik Betiği ekleyin.

<div align="left"><figure><img src="/files/4b5a1bc1e09667cca5a892ee11bb387c77be336d" 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ç noktanızla değiştirin>';
    
    // Birleştirilmiş veriyi harici sisteminize gönderin
  	const response = await req.post(external_api_url, payload_to_send);
    
    // Sorun gidermek için harici sistemden gelen yanıtı günlükleyin
    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 örtüşen Entegrasyonlar yöntemini Seçin.

| Ajanlarınız ... kullanıyorsa...                       | O zaman en iyi seçeneğiniz...                                    | Temel Dikkat Noktaları:                                                                                                                                                                                                                                                    |
| ----------------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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 yerleşiktir</li></ul>                                                                                                                                                                            |
| Zoom Workplace uygulaması veya Smart Embed            | API web kancaları ile bitiş zamanı filtreli yoklama uzlaştırması | <ul><li>Kullan <code>kişi\_center.cx\_engagement\_end\_data\_ready</code> alma tetikleyiciniz olarak</li><li>Sonra ile uzlaştırı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 Flow'u (ve veriyi itme ihtiyacı) | Flow Etkinlik Betikleri                                          | <ul><li>Niş ama güçlü</li><li>JavaScript gerektirir</li><li>mesajlaşma transkriptlerini ve işlem sonuçlarını göndermek için en iyi şekilde çalışır</li></ul>                                                                                                               |

Bu farklı yolları anlayarak, müşteri etkileşimlerinizin eksiksiz bir görünümünü sağlayan sağlam ve güvenilir Entegrasyonlar oluşturabilirsiniz. Etkinlik-tetiklemeli alımı, son zaman filtreli mutabakatla 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.