Sohbet öğesini yapılandırma

Genel Bakış

Web (Canlı Sohbet), Mobil (Uygulama İçi Mesajlaşma) ve Anlık Bildirimler için bir Sohbet öğesi oluşturmak ve yapılandırmak için Control Hub'daki Dijital Kanalları kullanın. Yapılandırma için kullanılabilen ayarlar, Atama bölümünde seçilen hizmete ve Web, Mobil veya her ikisini de seçip seçmediğinize bağlıdır.

Bu makalede, varlık oluşturulduktan sonra desteklenen yetenekler, mesajlaşma, push sağlayıcı kimlik bilgileri, JSON Web Token (JWT) yetkilendirmesi, JSON Web Anahtarları (JWK), aktarım protokolleri, çok kullanıcılı kayıt ve hizmete özel yapılandırma dahil olmak üzere tüm varlık yapılandırma süreci açıklanmaktadır.

Desteklenen yetenekler

Tablo 1. Hizmete göre desteklenen yetenekler
Yetenek	Webex Connect	Webex İletişim Merkezi	Webex İletişim Merkezi Kurumsal
Web Canlı Sohbet	desteklenen	desteklenen	desteklenen
Mobil Uygulama İçi Mesajlaşma	desteklenen	desteklenen	desteklenen
Tek bir varlıkta Web ve Mobil	desteklenen	Desteklenmiyor	Desteklenmiyor
Mobil - Android push bildirimleri	desteklenen	desteklenen	desteklenen
Mobil - iOS push bildirimleri	desteklenen	desteklenen	desteklenen
Web Push bildirimleri	Desteklenen (Chrome ve Firefox)	Desteklenmiyor	Desteklenmiyor
JWT - Mobil	desteklenen	Desteklenen ve gerekli	Desteklenen ve gerekli
JWT - İnternet	desteklenen	Desteklenmiyor	Desteklenmiyor
Çok kullanıcılı kayıtlar	desteklenen	desteklenen	desteklenen
Sunucu Tarafı Gelen Kutusu	desteklenen	Uygulanamaz	Uygulanamaz
Veri Akışı	desteklenen	Uygulanamaz	Uygulanamaz

Başlamadan önce

Control Hub 'da dijital varlıkları yönetebilen tam yönetici veya İletişim Merkezi yöneticisi olarak oturum açın.
Kuruluş için Webex Connect dijital hizmetlerin, Webex Contact Center veya Contact Center Enterprise'ın sağlandığından emin olun. Yetki olmadan, Dijital Varlıklar mevcut değildir.
Yeni Sohbet görüşmeleri alacak İletişim Merkezi giriş noktasını ve akışını belir leyin.
Dağıtımda Mobil push bildirimleri kullanılıyorsa, seçilen platformun gerektirdiği Firebase, Huawei veya Apple kimlik bilgilerini hazırlayın.
JWT yetkilendirmesini kullanmayı planlıyorsanız, güvenilir arka ucunuz tarafından verilen belirteçleri doğrulamak için kullanılan genel JWK'yı hazırlayın.

Sohbet varlığını yapılandırma

Sohbet varlığını yapılandırmak için:

1	Control Hub"da oturum açın.
2	Hizmetler > Dijital Var lıklar'a gidin.
3	Var lık oluştur'u seçin.
4	Varlık ayrıntılarını yapılandırma bölümünde aşağıdaki değerleri girin: Ad (gerekli): Bir varlık adı girin. Açıklama: İsteğe bağlı bir kullanım durumu açıklaması girin. Kanal (gerekli): Sohbet'i seçin. Varlık oluşturulduktan sonra kanalı değiştiremezsiniz. Atama (gerekli): Webex Cont Webex Connect act Center veya Webex Contact Center Enterprise'ı seçin. Kullanılabilir seçenekler kuruluş yetkinliklerine bağlıdır.
5	Mesajlaşma bölümünde platformu seçin ve Canlı Sohbet/Uygulama İçi Mesajlaşmayı ve gerekli anlık bildirimleri yapılandırın. Görüntülenen seçenekler seçilen platforma bağlıdır. Mobil seçildiğinde Android ve iOS bildirim ayarları kullanılabilir. Web Push, atanan bir varlık için Web seçildiğinde kullanılabilirWebex Connect.

Mesajlaşmayı yapılandırma

Mesajlaşma bölümünde platformu seçin ve varlığın mesajlaşma özelliklerini yapılandırın.

Mesajlaşmayı yapılandırmak için:

Birincil ve ikincil taşıma protokolleri farklı olmalıdır. SDK birincil protokolü kullanarak bağlantı kuramazsa, ikincil protokolü yedek olarak kullanır.

1	Platform: WebWebex Connect, Mobil veya her ikisini birden seçin. Mobil için Android, iOS veya her ikisini de seçin. Webex İletişim Merkezi veya Webex Contact Center Enterprise için Web veya Mobil'i seçin.
2	Canlı Sohbet/Uygulama İçi Mesajlaşma: İçinWebex Connect, Web ve Mobil için kullanılabilir. Webex Contact Center veya Webex Contact Center Enterprise için Web Canlı Sohbet ve Mobil Uygulama İçi Mesajlaşma sağlar.
3	Birincil aktarım protokolü: MQTT veya Web Soketi seçin.
4	İkincil aktarım protokolü: Birincil olarak seçilmeyen protokolü seçin.

Anlık bildirimleri yapılandırın

Uygulamanın yapılandırılmış bir push sağlay ıcısı aracılığıyla bildirim alması gerektiğinde Anlık bildirimlere izin ver seçeneğini etkinleştirin. Görüntülenen bildirim bölümleri seçilen platforma bağlıdır.

Aşağıdaki push sağlayıcı seçenekleri mevcuttur:

Android: Firebase Bulut Mesajlaşma (FCM), Huawei veya her ikisi. Webex Webex Connect Contact Center ve Webex Contact Center Enterprise için geçerlidir.
iOS: FCM, Apple Push Bildirim Hizmeti (APNS) veya APNS için belirteç tabanlı kimlik doğrulama. Webex Webex Connect Contact Center ve Webex Contact Center Enterprise için geçerlidir.
Web: Firebase Bulut Mesajlaşma. Webex ConnectSadece için geçerlidir.

Platformu seçin ve ilgili konuda ilgili sağlayıcıyı yapılandırın.

Firebase Hizmet Hesabı JSON'unu edinin

Webex, Firebase Cloud Messaging için sunucu isteklerini doğrulamak için bir Firebase hizmet hesabı JSON dosyası kullanır. Uygulamanızla ilişkili Firebase projesini kullanın.

Firebase Hizmet Hesabı JSON'unu almak ve yüklemek için:

Güvenlik: Firebase hizmet hesabı JSON hassas kimlik bilgileri içerir. Güvenli bir şekilde saklayın ve yalnızca amaçlanan Firebase projesi için dosyayı yükleyin.

Firebase Cloud Messaging yapılandırma talimatları için bkz. FCM HTTP v1 API'sini kullanarak ileti gönder me.

1	Firebase konsolunu açın ve uygulamanız tarafından kullanılan Firebase projesini seçin.
2	Proje ayarları > Hizmet hesapları'nı açın.
3	Yeni özel anahtar oluştur öğ esini seçin ve indirmeyi onaylayın.
4	İndirilen JSON dosyasını güvenli bir şekilde saklayın. Dosya özel anahtar kimlik bilgilerini içerir.
5	Control Hub'da, ilgili Android, iOS veya Web bildirim yapılandırması için JSON dosyasını Firebase Service Account JSON öğesine yük leyin.

Android push bildirimlerini yapılandırın

Mobil, Android ve Anlık bildirimlere izin ver seçildiğinde Android bildirim bölümü görüntülenir. En az bir sağlayıcı seçin; Firebase ve Huawei tek tek veya birlikte yapılandırılabilir. Bu yapılandırmaWebex Connect, Webex Contact Center ve Webex Contact Center Enterprise Mobile varlıkları için kullanılabilir.

Sağlayıcı belgeleri: Huawei - Push Kit kurulumu ve testi

1	Mobil, Android ve Anlık bildirimlere izin ver'i seçin. Android bildirim bölümü görüntü lenir.
2	Firebase Cloud Messaging öğesini seçin ve Firebase projesinden gerekli Firebase Hizmet Hesabı JSON dosyasını yükleyin.
3	Uygulama Huawei Mobil Hizmetlerini kullanan cihazları destekliyorsa, Huawei'yi seçin ve AppGallery Connect 'ten Uygulama İçi Kimliği ve Uygulama İçi Sırrı girin. Huawei istisnası: Uygulama Google Play Hizmetleri olmayan cihazları desteklemediğinde Huawei yapılandırması atlanabilir. Mevcut Webex Connect kılavuz EMUI 10.x ve sonraki sürümlerini destekler.

İOS push bildirimlerini yapılandırın

Mobil, iOS ve Anlık bildirim lere izin ver seçildiğinde iOS bildirim bölümü görüntülenir. Bir push sağlayıcısı seçin. Bu yapılandırmaWebex Connect, Webex Contact Center ve Webex Contact Center Enterprise Mobile varlıkları için kullanılabilir.

Sertifika tabanlı APN'ler yapılandırma talimatları için bkz. APN'lere sertifika tabanlı bağlantı kurma.

Belirteç tabanlı APN'ler yapılandırma talimatları için bkz. APN' lere belirteç tabanlı bağlantı kur ma.

1	Mobil, iOS ve Anlık bildirimlere izin ver'i seçin. İOS bildirim bölümü görüntülenir.
2	Bir push sağlayıcısı seçin.
3	Firebase Cloud Messaging için Firebase proj esinden indirilen Firebase Service Account JSON dosyasını yükleyin.
4	Apple Anlık Bildirim Hizmeti (APNS) için sertifika parolasını girin, Korumalı Alan veya Üretim'i seçin, APNS sertifikasını yükleyin, bir ad girin ve yapılandırmayı doğrulayın. Sadece.p12 sertifika biçimi desteklenir.
5	Belirteç tabanlı APNS kimlik doğrulaması için Anahtar Kimliğini, Takım Kimliğini ve uygulama paketi veya paket kimliğini girin, Sandbox veya Production'ı seçin ve APNS özel anahtar dosyasını yükleyin. Ağ geçidi seçimi: Bir geliştirme uygulaması için Sandbox'ı ve üretime hazır bir uygulama için Prodüksiyon'u kullanın. APNS özel anahtarını güvenli bir şekilde saklayın; Apple indirilen .p8 anahtar dosyasının yalnızca bir kez alınmasına izin verir.
6	Hızlı teslimatın kesintiye uğramasını önlemek için Apple sağlayıcı sertifikasını süresi dolmadan değiştirin.

Web Push bildirimlerini yapılandırma

Web Push bildirimleri yalnızca Web seçildiğinde atanan var Webex Connect lıklar için kullanılabilir. Chrome ve Firefox desteklenmektedir. Safari Web Push şu anda desteklenmiyor.

Web Push bildirimleri, Webex Contact Center veya Webex Contact Center Enterprise'a atanan varlıklar için desteklenmez.

Web Push bildirimlerini yapılandırmak için:

1	Varlığın atandığını Webex Connect ve Web'in seçili olduğunu onaylayın.
2	Web sitesine erişmek ve Web Push bildirimleri almak için Chrome veya Firefox'u kullanın.
3	Web sitesi URL'si (gerekli): Web Push bildirimlerini alacak web sitesinin URL'sini girin.
4	Bildirim Simgesi (gerekli): Bildirim simgesinin yolunu girin. Simge 80 x 80 piksel olmalıdır.
5	Firebase belgelerini izleyerek web uygulamanız için Firebase Cloud Messaging'i (FCM) yapılandırın.
6	Firebase Hizmet Hesabı JSON (gerekli): Firebase Cloud Messaging HTTP v1 API'sini kullanmak için gereken özel anahtarı içeren Firebase hizmet hesabı JSON dosyasını yükleyin.

JSON Web Token yetkilendirmesini yapılandırma

JWT yetkilendirmesi SDK iletişiminin geçerli bir JSON Web Token kullanılarak yetkilendirilmesini gerektirir. Yeni varlıklar için şifreleme türü Asimetriktir.

JWT desteği aşağıdaki gibidir:

Webex Connect: Aynı varlıkta Mobil ve Web için desteklenir.
Webex İletişim Merkezi ve Webex İletişim Merkezi Kurumsal - Web: Desteklenmez.
Webex İletişim Merkezi ve Webex Contact Center Enterprise - Mobil: Mobil varlık yapılandırması için desteklenir ve gereklidir.

Aşağıdaki ayarları yapılandırın:

Şifreleme türü: Yeni varlıklar için asimetrik.
Token Sona Erme Süresi (gerekli): Yeni bir kullanıcı kimlik belirteci gerekmeden önce JWT'nin ne kadar süre geçerli kalacağını girin. Geçerli aralık: 5-360 dakika. Varsayılan: 60 dakika.
JSON Web Anahtarları (gerekli): Belirteçleri doğrulamak için kullanılan genel JWK'yı yükleyin. Döndürme için ikinci bir anahtar ekleyebilirsiniz. Maksimum: iki anahtar.

Genel JSON Web Anahtarını alt konularda açıklandığı gibi ekleyin ve hazırlayın.

Halka açık JWK'yı hazırlayın

Yüklenen dosya genel RSA doğrulama anahtarını içermelidir. Webex aşağıdaki JWK özelliklerini doğrular.

JWK özellikleri RFC 7517, Bölüm 4 'te tanımlanmıştır. Algoritmaya özgü özellikler RFC 7518'de tanımlanmıştır.

Tablo 2. Herkese Açık JWK mülkleri
Mülkiyet adı	Açıklama
alg	Anahtarla kullanılan şifreleme algoritmasını tanımlar. Gerekli değer, SHA-256 kullanarak RSASSA-PKCS1'i belirten RS256'dır. v1_5
e	Base64URLuint kodlu bir değer olarak temsil edilen RSA genel anahtar ının üstünü.
key_ops	Anahtarın amaçlandığı işlemi belirtir. Desteklenen değer doğrulanır ve anahtarın dijital imzaları doğrulamak için kullanıldığını gösterir. Bk z. RFC 7517, Bölüm 4.3.
kty	Anahtarla birlikte kullanılan şifreleme algoritması ailesini tanımlar. Değer RSA olmalıdır. Bk z. RFC 7517, Bölüm 4.1.
n	Base64URLuint kodlu bir değer olarak temsil edilen RSA genel anahtar ının modülü.
kullanım	Ortak anahtarın kullanım amacını belirtir. Değer, anahtarın imza doğrulaması için tasarlandığını belirten sig olmalıdır. Bk z. RFC 7517, Bölüm 4.2.
çocuk	Anahtarı tanımlar ve anahtar döndürme sırasında olduğu gibi belirli bir anahtarı eşleştirmek için kullanılır. Bk z. RFC 7517, Bölüm 4.5.

Yalnızca genel doğrulama anahtarını yükleyin. İlgili özel imzalama anahtarını JWT'leri veren güvenilir sistemde saklayın.

JSON Web Anahtarı Ekleme

Genel bir JSON Web Anahtarı eklemek için:

1	Anahtar ekle'yi seçin.
2	Bir JSON Web Anahtarı Adı girin.
3	JSON Web Anahtarı Vericiyi girin. Bu değer, JWT'yi oluştururken güvenilir arka uç tarafından kullanılan yayıncıyla eşleşmelidir.
4	Herkese açık JWK dosyasını yükleyin.
5	Kaydet'i seçin.

Çok kullanıcılı kayıtlarını yapılandırma

Birden fazla kullanıcı aynı fiziksel cihaza kaydolabildiğinde aynı cihazda çoklu kullanıcı kayıtlarına izin ver seçeneğini etkinleştirin.

Anlık bildirimler hem aktif hem de etkin olmayan kayıtlı kullanıcılar için gönderilir.
Canlı Sohbet veya Uygulama İçi Mesajlaşma, o anda aktif olan kullanıcıya teslim edilir. Etkin olmayan kullanıcılar için iletiler, kullanıcı tekrar aktif hale gelene kadar sıraya alınır.

Ek Webex Connect ayarlarını yapılandırın

Aşağıdaki gelişmiş ayarlar yalnızca Webex Connect varlıklar için geçerlidir ve Webex Contact Center veya Webex Contact Center Enterprise varlıkları için geçerli değildir.

Kullanıcı Başına Tek Aygıt: Bir kullanıcıyı tek bir kayıtlı cihazla sınırlar. Yeni bir cihaza kaydolmak, eski cihaza hızlı teslimatı durdurur.
Sunucu Tarafı Gelen Kutusu: Daha sonra alınmak üzere gelen kutusu verilerinin sunucu tarafı kopyasını depolar.
Veri Akışı: Mesajlaşma API'si aracılığıyla gönderilen iletiler için seçilen Webex Connect entegrasyona uygulanabilir olay verilerini gönderir.

Varlığı oluşturmak için kaydedin

İlgili Mesajlaşma, JWT yetkilendirmesi, çok kullanıcılı kayıt ve Webex Connect ayarları yapılandırdıktan sonra Sohbet varlığını oluşturmak için yapılandırmayı kaydedin.

Varlığı oluşturmak için Kay det'i seçin.

Varlığın başarıyla oluşturulduğunun onaylanmasını bekleyin.

Komple servis entegrasyonu

Sohbet öğesini oluşturduktan sonra Atama bölümünde seçilen hizmet için tümleştir meyi tamamlayın. Webex Contact Center veya Webex Contact Center Enterprise için Webex Connect geçerli prosedürü izleyin.

Komple Webex Connect entegrasyonu

Atanan bir varlık içinWebex Connect, hizmet eşlemesini ve akış yapılandırmasını tamamlayınWebex Connect. Düğüm yetkilendirmesi gerekli değildir.

Gelen olayları yakalamak ve bir akışı tetiklemek için Başlangıç Düğümü, Özel Olay veya Özel Webhook kullanabilirsiniz. Daha fazla bilgi için bkz. Başlang ıç Düğümü, Özel Olay ve Özel Web Kancası.

1	Oturum açWebex Connect.
2	Sohbet varlığı için geçerli hizmet eşlemesini ve akış yapılandırmasını tamamlayın.
3	Oluşturulan Uygulama Kimliğini ve İstemci Anahtarını kaydedin.
4	Seçilen her platform için SDK yapılandırma dosyasını indirin.

Komple Webex İletişim Merkezi entegrasyonu

Webex İletişim Merkezi'ne atanan bir varlık için, varlığı bir İletişim Merkezi giriş noktasına eşleyin ve ardından Webex İletişim Merkezi düğüm yetkilendirmesini tamamlayın.

Bir varlık yalnızca bir giriş noktasına eşlenebilir. Müşteri deneyimini yayınlamadan önce giriş noktası ve akış haritalamasını tamamlayın.

1	Contact Center yapılandırmasını Control Hub'da açın.
2	Sohbet konuşmalarını alan giriş noktasını oluşturun veya açın.
3	Ak ış Eşlem esi'nde Sohbet varlığını ve gerekli müşteri girişi akışını seçin.
4	Giriş noktasını kaydedin ve varlık ve akış eşlemesini doğrulayın.
5	Webex Contact Center düğüm yetkilendirmesini tamamlayın. Webex Connect Talimatlar için bkz. Webex CC Görev Tümleştirme Düğümleri ve Düğüm Yetkilendirmeleri.
6	Web dağıtımı için Canlı Sohbet widget'ını yapılandırın ve Web sitesi yerleştirme kodunu Control Hub'da edinin.

Komple Webex İletişim Merkezi Kurumsal entegrasyonu

Webex Contact Center Enterprise'a atanan bir varlık için yönlendirme akışını yapılandır Webex Connect madan önce CCE düğümü yetkilendirmesini tamamlayın.

1	Oturum açWebex Connect.
2	CCE düğüm yetkilendirmesini tamamlayın. Talimatlar için bkz. CCE Entegrasyon Düğümleri ve Düğüm Yetkilendirmeleri.
3	Sohbet varlığı için geçerli CCE tümleştirme düğümlerini ve yönlendirme akışını yapılandırın. Akış örnekleri için bkz. Ak ış Yapılandırmaları.
4	Akışı kaydedin ve test edin.

Ek yapılandırma kılavuzu için bkz. En İyi Uygulamalar ve Yönergeler ve SSS.

İstisnalar ve sınırlamalar

Aşağıdaki istisnaları ve sınırlamaları aklınızda bulundurun:

Varlığı oluşturmadan önce kanal, platform, atama ve yönlendirme seçimini onaylayın. Kanal oluşturulduktan sonra değiştirilemez ve platform değişiklikleri iş yükü ile sınırlandırılır.
Webex Contact Center ve Webex Contact Center Enterprise için tek bir varlık Web ve Mobile'ı birlikte kullanamaz. Her ikisi de gerektiğinde ayrı varlıklar oluşturun.
Web Push bildirimleri yalnızca aşağıdakiler için kullanılabilir:Webex Connect. Safari Web Push, Webex Contact Center Web Push ve Webex Contact Center Enterprise Web Push desteklenmez.
Webex Contact Center veya Webex Contact Center Enterprise'a atanan Web varlıkları için JWT yetkilendirmesi desteklenmez.
Webex Contact Center ve Webex Contact Center Enterprise için Control Hub'ın İletişim Merkezi bölümünde giriş noktası, akış, widget ve gömme kod yapılandırması gerçekleştirin.
İçinWebex Connect, hizmet ve akış yapılandırmasını tamamlayınWebex Connect.
Bir Sohbet öğesini bir hizmetle eşlendikten sonra, aşağı akış eşlemesini kaldırmadan veya güncellemeden silmeyin. Silinen bir varlık geri yüklenemez ve mevcut eşlemeyi kullanılamaz hale getirebilir.
Oluşturduktan sonra, uygun SDK'yı başlatmak için gereken oluşturulan Uygulama Kimliği, İstemci Anahtarı ve SDK yapılandırma dosyalarını koruyun.

Cisco AI Assistant

Geri bildiriminiz için teşekkürler.