# Etkileşim Verilerini Entegre Etme
### Genel Bakış
Zoom iletişim merkezi, çağrı kayıtları, dökümler, temsilci notları ve durumlar dahil olmak üzere her müşteri etkileşimi sırasında değerli etkileşim verileri oluşturur. Zoom iletişim merkezini kullanırken birleşik bir müşteri görünümü oluşturmak, etkili temsilci koçluğu sağlamak veya uyumluluk gereksinimlerini karşılamak için etkileşim verilerinin harici sistemlerde (örneğin CRM ve diğer kayıt sistemleri) nasıl saklanacağını öğrenmek için okumaya devam edin.
Temsilcilerinizin artan verimlilikle nasıl çalışabileceğine göre 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önettikleri uygulama**. Tartışacağımız iki seçenek şunlardır:
1. Hazır ZCC CRM CTI Bağlayıcısı'nı CRM içinde 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ısı Entegrasyonu
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.
#### Nasıl Çalışır
CTI Bağlayıcısı, 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 durumlar gibi veriler otomatik olarak Zoom içinde kaydedilir ve CRM'nizdeki ilgili kayda (örneğin bir bilet veya kişi) bağlanır.
#### Kurulum Gereksinimleri
Zoom ile CRM arasında veri eşitlemesine olanak tanıyan işlevsellik "hazır" 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**
Zoom yönetici portalına bir yönetici olarak giriş yapın ve İletişim Merkezi Yönetimi > Entegrasyonlar > Uygulamalar bölümüne gidin.
İlgili CRM Entegrasyonunu bulun ve CRM'nizde veri depolamaya izin vermek için uygun Ayarlar'ı etkinleştirin.
{% endstep %}
{% step %}
**CRM İzinleri**
Şunu gözden geçirin ve izleyin: [CRM Entegrasyonları kurulum kılavuzları](https://support.zoom.com/) CRM Entegrasyonları kullanıcınızın ilgili tüm nesneler için gerekli yazma izinlerine sahip olduğunu doğrulamak için.
{% endstep %}
{% endstepper %}
#### Desteklenen CRM Platformları
Bu işlevsellik, temsilciler aşağıdaki CRM'leri kullandığında 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'ye 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'leri iledir.
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 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.
Ayrıca üçüncü bir yaklaşım daha vardır, **Akış Olayları Entegrasyonları**, bu belirli veri türleri için çalışır.
#### Zoom İletişim Merkezi API'lerini sorgulama
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, muhtemelen her ilgili uç nokta için sorgulama mantığı oluşturmanız gerekecektir.
| Bu Veriyi Almak İçin... | Bu API'yi Sorgula... | Bu Alanı Kullan... | Notlar: |
| ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------- |
|
| `döküm_url` | Gelen kutusu için transkripsiyonun etkinleştirilmesini gerektirir. |
{% hint style="danger" %}
**Uyarı**
İndirme URL’leri (`download_url`, `döküm_url`, `playback_url`, vb.) bu Zoom API’leri tarafından sağlanır ve **değildir** genel bağlantılardır. Programatik erişim için tasarlanmışlardır ve ilişkilendirilmiş dosyayı indirmek için API kimlik doğrulama (örneğin, Authorization başlığındaki access belirteç) gerektirir.
Bu şu anlama gelir:
* Bu URL’leri bir kullanıcının tıklaması için doğrudan bir CRM’de kaydedemezsiniz. Kullanıcının bağlantıya tarayıcıda tıklaması durumunda kimlik doğrulama yapılmış olmayacaktır ve indirme başarısız olur.
* Doğru yöntem, arka uç hizmetinizin dosyayı almak için URL’yi 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ı sona erdiği anda Uygun değildir. Sesin önce işlenmesi ve yüklenmesi gerekir; bu da uzun çağrılar için birkaç dakika sürebilir. Kayıtları kaçırmamanız için, şunu ayarlayın: `query_date_type` parametre için `kayıt_bitiş_zamanı` List recordings API'sini yoklarken. Bu, verileri çağrının ne zaman bittiğine göre değil, işlemenin ne zaman tamamlandığına göre getirir.
{% 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.
#### Gerçek Zamanlı Olaylar için Webhook'ları Kullanın
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'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 doğrudan ya da bir takip API çağrısı için URL/ID olarak içerir.
**Etkileşim Verileri için Yaygın web kancası Olayları**
* **Ses/Video Kaydı:** kişi\_center.recording\_completed (sağlayan bir `download_url`)
* **Ses/Video Dökümü:** kişi\_center.kayıt\_döküm\_tamamlandı (bir `döküm_url`)
* **Mesajlaşma dökümü:** kişi\_center.engagement\_mesajlaşma\_döküm\_completed (sağlar bir `döküm_url`)
* **Notlar:** kişi\_center.etkileşim\_notu\_eklendi (bir `not` not verileri alanı)
* **Dağıtım:** kişi\_center.engagement\_dağıtım\_added (bir `dağıtım_adı` dağıtım verileri alanı)
{% hint style="warning" %}
**Dikkat**
* **Birden Fazla Olayın Farkında Olun:** Bu `note_added` ve `dağıtım_added` olaylar tek bir etkileşim için birden fazla kez tetiklenebilir (örneğin, bir temsilci birden fazla not kaydederse veya bir çağrı aktarılırsa). uygulama mantığınız bununla başa çıkabilecek şekilde olmalıdır.
* **Yedeklilik Oluşturun:** Etkinlik teslimi her zaman %100 garanti edilmez (örneğin, uç noktanız veya websocket bağlantınız geçici olarak kapalı olabilir).
* **Yedek Strateji:** Kaçırılan etkinlikleri yakalamak için yoklama API'lerini kullanarak her gece bir uzlaştırma betiği çalıştırmanızı öneririz.
{% endhint %}
Zoom İletişim Merkezi web kancası/websocket etkinlikleri hakkında daha fazla bilgi için bkz. [İletişim Merkezi Web Kancaları](https://developers.zoom.us/docs/api/contact-center/events/) dokümantasyon.
#### Akış Etkinlikleri Entegrasyonlar
Belirli veri türleri için, bir JavaScript Etkinlik Betiği kullanarak ZCC Akış düzenleyicisinden verileri doğrudan harici bir sisteme gönderebilirsiniz.
**Desteklenen Veriler ve Sınırlamalar:**
* **Dağıtım:** Aşağıdaki 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, şu kullanılarak Gelen mesajlaşma etkileşimleri (örneğin, Web sohbet) için erişilebilir `global_system.Engagement.döküm` değişken.
* **Birden Fazla Akış:** Yapılandırmanızda birden fazla Akış ile çalışırken, özellikle bir Akışın şu kullanması durumunda `RouteTo` başka bir Akışa bağlanmak için widget'ı kullanıyorsa, aynı Etkinlik Betiklerinin ve tetikleyicilerin tüm Akışlar genelinde doğru şekilde yapılandırıldığından emin olmak gerekir.
Bu yöntem, döküm ve 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 Betiği Ekle**
ZCC Flow'unuzda (örneğin, bir Web sohbet akışında), Başlat widget'ına tıklayın.
Etkinlik Komut Dosyalarını bulun ve Etkinlikler için, örneğin Engagement Closed ve/veya dağıtım Saved gibi, bir Etkinlik Komut Dosyası Ekle.
{% 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 payload 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 = '';
// Birleştirilmiş verileri harici sisteminize gönderin
const response = await req.post(external_api_url, payload_to_send);
// Sorun giderme için yanıtı harici sistemden 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
Temsilci iş akışınız ve teknik kaynaklarınızla en iyi örtüşen Entegrasyonlar yöntemini Seç.
| Eğer temsilcileriniz ... kullanıyorsa | O zaman en iyi seçeneğiniz ... | Temel Hususlar: |
| -------------------------------------------------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Desteklenen bir CRM'deki ZCC CTI Bağlayıcı | yerleşik Entegrasyonlar |
En kolay yol
Kod gerekmez
Etkileşim verisi Eşitle yerleşiktir
|
| Zoom Workplace uygulaması veya Smart Embed | Mutabakat için gecelik bir yoklama işiyle API Webhook'ları |
En sağlam özel çözüm
Güvenilir bir yedekleme süreciyle neredeyse gerçek zamanlı veri sağlar
|
| Bir Gelen mesajlaşma Akışı (ve veri itme ihtiyacı) | Akış Etkinlik Betikleri |
Niş ama güçlü
JavaScript gerektirir
mesajlaşma dökümlerini ve durumları göndermek için en iyi şekilde çalışır
|
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.
---
# Agent Instructions: 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:
```
GET https://library.zoom.com/technical-library/tr/isletme-hizmetleri/zoom-contact-center/expert-insights/integrate-engagement-data.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.