Dokümanlar

Uygulamalar ve Entegrasyonlar

Ekibinizin zaten kullandığı araçları bağlayın — Stripe, Shopify, Mailchimp, MailerLite, Jira ve Tracio. Kurulu uygulamalar, canlı müşteri verilerini Gelen Kutusu konuşma panelinde, sohbetin hemen yanında kartlar olarak gösterir.

Genel bakış#

Uygulama pazarı Ayarlar → Uygulamalar bölümündedir. Uygulamalar tüm çalışma alanı için bir kez kurulur: bir yönetici, hizmeti çalışma alanının kendi kimlik bilgileriyle bağlar ve gelen kutusu erişimi olan her ekip arkadaşı ortaya çıkan kartı konuşma panelinde görür. Temsilciler hiçbir şeyi kendileri kurmaz — yapay zeka ajanları da hiçbir şey kurmaz.

Çalışma alanı düzeyinde kurulum

Çalışma alanı başına tek bir kimlik bilgisi kümesi. Bir uygulamayı kurmak, düzenlemek veya kaldırmak herkesi aynı anda etkiler.

Gelen Kutusu’nda kartlar

Kurulu her uygulama, konuşma panelinde konuştuğunuz kişi hakkında canlı veriler içeren bir kart çizer.

Dolgu yok

Katalogda listelenen her şey bugün kurulabilir — "yakında" bölümü yoktur. Bir istek kutucuğu, hangi hizmetin eksik olduğunu bize bildirmenizi sağlar.

Uygulamaları yönetmek Uygulama kurma ve yapılandırma iznini gerektirir (varsayılan olarak Owner ve Admin rollerine dahildir, özel rollere de verilebilir). Bu izne sahip olmayan ekip arkadaşları uygulama kartlarını konuşmalarda yine görür — yalnızca kurulum veya yeniden yapılandırma yapamazlar.

Uygulama kataloğu#

Bugün altı uygulama kullanılabilir:

UygulamaKategoriTemsilcilerin konuşmada gördüğü
StripeÖdemelerKonuştuğunuz kişinin aboneliği ve son ödemeleri
ShopifyTicaretÖdeme ve gönderim durumlarıyla birlikte son siparişler
MailchimpPazarlamaKonuştuğunuz kişinin abonelik durumu, hedef kitlesi ve etiketleri
MailerLitePazarlamaKonuştuğunuz kişinin abonelik durumu, grupları ve kayıt tarihi
Jiraİş takibiBu konuşmaya bağlı işler ve tek tıkla yenisini açma
TracioGüvenlikİnsan mı bot mu: Tracio’nun sohbet widget’ı ziyaretçisi hakkındaki kararı

Kendi arka ofisinize düz bir bağlantı mı arıyorsunuz? Bunun için hesap da belirteç de gerekmez; bu yüzden uygulama kataloğunda değil Ayarlar → Genel → Sistemlerinize bağlantılar bölümünde yaşar.

Uygulama kurma#

Ayarlar → Uygulamalar’ı açın, bir kutucuk seçin ve uygulamanın istediği kimlik bilgilerini doldurun. Her alan, değerin oluşturulduğu veya bulunduğu tam sayfaya — sağlayıcının panelinde — bağlantı verir.

AdımAçıklama
1. Önizlemeyi inceleyinHerhangi bir şey yapıştırmadan önce, yapılandırma sayfası temsilcilerinizin göreceği kartın birebir örneğini gösterir — uydurma verilerle oluşturulmuştur; böylece bir kimlik bilgisi kaydedilmeden önce çalışma alanıyla ne paylaşacağınızı bilirsiniz.
2. Kimlik bilgilerini girinAPI anahtarını veya belirteci yapıştırın. Değerler otomatik olarak kırpılır — kopyala-yapıştırdan gelen sondaki boşluk veya satır sonu kurulumu bozmaz.
3. Kaydedin ve test edinKaydetmek yapılandırmayı saklar; bağlantıyı test etmek sağlayıcıya gerçek bir çağrı yapar ve durum çipini yeşile çeviren de budur.

Her uygulama kutucuğunda kurulumun hangi aşamada olduğunu söyleyen bir durum çipi bulunur:

DurumAnlamı
Test edilmediKimlik bilgileri kaydedildi, ancak uygulama henüz gerçek bir isteği yanıtlamadı.
BağlıSağlayıcı gerçekten yanıt verdi — bağlantı yalnızca kaydedilmiş değil, doğrulanmıştır.
İlgilenmek gerekiyorSağlayıcı, kayıtlı kimlik bilgilerini reddetti (iptal edilmiş veya süresi dolmuş anahtar). Bir yönetici uygulamayı kaydedene veya yeniden test edene kadar kartlar sağlayıcıyı aramayı bırakır.
HataBaşka bir şey ters gitti — ipucuna bakın.
Devre dışıBir yönetici uygulamayı kapattı. Kart, kimlik bilgileri silinmeden Gelen Kutusu’ndan kaybolur.

Kimlik bilgileri ve güvenlik#

Uygulama kimlik bilgileri çalışma alanına aittir ve birkaç kural onları güvende tutar:

  • Beklemede şifreli. Gizli alanlar (API anahtarları, belirteçler) depolamada anahtar başına şifrelenir ve kaydedildikten sonra asla geri gösterilmez.
  • Sağlayıcının izin verdiği yerde en az yetki. Stripe; Customers, Subscriptions, Charges ve Invoices verilerini okuyabilen kısıtlı bir anahtarla bağlanmalıdır — Refunds yazma erişimi, yalnızca temsilciler konuşmadan iade yapabilecekse eklenir. Tam erişimli bir anahtar yapıştırırsanız yine çalışır, ancak ayarlar sayfası onu değiştirmenizi önerir.
  • Hedefi taşımak gizli değeri yeniden ister. Kimlik bilgisinin bağlı olduğu bir alanı — Shopify mağaza alan adını, Jira site URL’sini — düzenlemek belirteci yeniden girmeyi gerektirir; böylece kayıtlı bir kimlik bilgisi asla amaçlanmadığı bir ana bilgisayara yönlendirilemez.
  • İptal etmek tüm çalışma alanını etkiler. Çalışma alanı başına uygulama başına tek kurulum vardır: anahtarı sağlayıcıda döndürür veya iptal ederseniz, bir yönetici Ayarlar → Uygulamalar’da güncelleyene kadar her ekip arkadaşının kartı çalışmayı durdurur.

Gelen Kutusu’ndaki uygulama kartları#

Kurulduktan sonra her uygulama, Gelen Kutusu’nun konuşma ayrıntı panelinde bir widget olarak görünür. Bir konuşmayı açmak sağlayıcıdan canlı bir kart getirir: bu müşterinin Stripe’taki kimliği, son Shopify siparişleri, bülten durumu, konuya bağlı Jira işleri veya Tracio’nun ziyaretçi hakkındaki kararı. Çoğu kart ayrıca sağlayıcının kendi panelindeki eşleşen kayda bağlantı verir — Tracio’nun kararı tamamen panelde yaşar.

Kartlar gösterecek bir şey olmadığında dürüsttür. Müşteri bulunamazsa — veya konuşmanın kullanılabilir bir kimliği yoksa — kart boş bir kutu çizmek yerine bunu söyler ve nedenini açıklar. Yanıtlar kısa süreliğine önbelleğe alınır ve uygulama başına hız bütçesine tabidir; böylece açık bir gelen kutusu sağlayıcının API limitlerini tüketmez.

Kartlar doğrulanmış kimliği izler#

Stripe, Shopify, Mailchimp ve MailerLite müşteriyi e-posta adresiyle arar — ve yalnızca gerçekten doğrulanmış bir adresle: widget’ın imzalı kimliğiyle (kimlik doğrulama) kapsanan bir adres veya bir e-posta kanalı konuşmasının Kimden adresi. Ziyaretçinin sohbete yalnızca yazdığı bir adres aramalarda hiç kullanılmaz — aksi halde herhangi biri gerçek bir müşterinin e-postasını yazıp ödeme geçmişini görebilirdi. Bu durumda kart, adresin doğrulanmış bir kimlikle desteklenmediğini açıklar.

Jira ve Tracio e-postaya dayanmaz — Jira kartları konuşmanın bağlı işlerine, Tracio ise widget ziyaretçisine aittir — bu yüzden doğrulanmış adres olmadığında da çalışırlar.

Konuşmanın kendi adresi hiçbir şey bulamazsa, Respondo kişinin bilinen diğer adresini de dener (örneğin bir kişi birleştirmesinden sonra) ve kartı kullandığı adresle etiketler.

Her uygulama ne gösterir#

Stripe#

Müşterinin faturalandırmasına salt okunur bir pencere: ad, e-posta, hesap bakiyesi ve kopyalanabilir bir müşteri kimliği; ayrıca abonelik — durum rozeti, plan, aylık tutar ve başlangıç tarihi — ve fatura numaralarıyla son ödemeler. İadeler tek isteğe bağlı yazma işlemidir: bir yöneticinin uygulama ayarlarında Konuşma panelinden iadelere izin ver’i açması gerekir (varsayılan olarak kapalıdır), operatörün İade ve iptal çalıştırma iznine sahip olması gerekir ve her iade REFUND yazılarak onaylanmalıdır — Stripe gönderilen bir iadeyi geri alamaz.

Shopify#

Salt okunur son siparişler — sipariş numarası, tarih, toplam, ödeme ve gönderim durumu — her siparişe ve Shopify yöneticinizdeki müşteri kaydına bağlantılarla. Mağaza alan adınız ve read_customers ile read_orders kapsamlarına sahip özel bir uygulamadan alınan Admin API belirteciyle bağlanır.

Mailchimp#

Abone, Mailchimp’in gördüğü haliyle: durum rozeti, hedef kitle, etiketler, etkileşim ve son kampanya etkinliği (gönderimler, açılmalar, tıklamalar). Tek bir eylem vardır: Abonelikten çıkar — konuşmadan ayrılmadan bir "bana e-posta göndermeyi bırakın" isteğini yerine getirmek için. API üzerinden geri alınamaz — Mailchimp, bir kişinin yalnızca kendi başına bir kayıt formu üzerinden yeniden abone olmasına izin verir — bu yüzden yazılı bir onay gerektirir. Mailchimp API anahtarlarının kapsamlandırılmadığını unutmayın: bağladığınız anahtar hesaptaki her şeyi okuyup yazabilir.

MailerLite#

Abonelik durumu, gruplar, kayıt tarihi, etkileşim ve son kampanya etkinliği. İki eylem: Abonelikten çıkar (geri alınabilir — MailerLite API’si yeniden aboneliği destekler) ve birinin kendi isteğiyle listeye geri eklenmesi için Yeniden abone et.

Jira#

Konuşmalar ile Jira Cloud işleri arasında çift yönlü bir bağlantı. Kart, bu konuşmaya bağlı işleri güncel durumlarıyla listeler ve İş oluştur (seçtiğiniz projede açılır, otomatik bağlanır) ile hâlihazırda var olan işler için Var olanı bağla / Bağlantıyı kaldır sunar. Jira’da yapılan durum değişiklikleri bir webhook üzerinden geri akar: uygulamanın ayarlar sayfası Jira sitenize yapıştırılacak gizli bir webhook adresi gösterir ve kart o andan itibaren işin canlı durumunu yansıtır. İşler bağladığınız Atlassian hesabı adına oluşturulur ve kart tam olarak o hesabın gördüğünü görür.

Panelden çalıştırılan her eylem rol izinleriyle korunur — abonelikten çıkarma, yeniden abone etme ve Jira işleri için Uygulama eylemlerini kullanma, iadeler için İade ve iptal çalıştırma. Bir uygulama ayrıca çalışma alanı düzeyinde bir yetenek anahtarı sunuyorsa — bugün bu, Stripe’ın Konuşma panelinden iadelere izin ver anahtarıdır — anahtar, yeteneğin var olup olmadığına karar verir ve kapatmak çalışma alanı sahibi dahil herkesi engeller.

Tracio: insan mı bot mu#

Tracio, bir sohbet widget’ı ziyaretçisi hakkında tek bir soruyu yanıtlar: bu bir insan mı yoksa bot mu? Uygulamayı kurmak, Tracio’nun algılama SDK’sını Respondo sohbet widget’ınızın içinde etkinleştirir — yeni widget konuşmaları otomatik olarak bir karar alır ve konuşma panelindeki Tracio kartında bir çip olarak gösterilir.

ÇipAnlamı
İnsanTracio’nun sunucu tarafı denetimi bu ziyaretçi için bot sinyali bulmadı.
Bot · %93Bot algılandı, Tracio’nun güven oranıyla birlikte. Kart ayrıca kararın arkasındaki sinyalleri listeler.
DenetlenmediTracio’nun sunucu tarafı denetimi şu anda kullanılamıyor — kart tarayıcının bildirdiği karara geri döner ve bunu söyler.
Sahte kimlikTarayıcının gönderdiği ziyaretçi kimliği Tracio tarafından bilinmiyor — iddia sahte görünüyor.

İki anahtar bağlanır: SDK’yı widget’ta etkinleştiren bir genel anahtar ve kararın sunucu tarafı denetimi için kullanılan gizli bir Data API anahtarı. Sunucu tarafı denetim olmadan, bir tarayıcının "bot değil" iddiasına tek başına güvenilemez — ve tarayıcının iddiası sunucu kararıyla çeliştiğinde kart ikisini de gösterir.

Tracio yalnızca sohbet widget’ı konuşmaları için çalışır. E-posta, Telegram ve diğer kanalların incelenecek bir ziyaretçisi yoktur; bu yüzden Tracio kartları denetlenecek bir şey olmadığını açıklar. Eksik bir karar şüphe nedeni değildir: reklam engelleyiciler gerçek insanlar için SDK’yı sürekli keser ve Tracio bağlanmadan önce başlayan eski konuşmaların da kararı yoktur.
Tracio SDK’sı sitenizin ziyaretçilerinin parmak izini çıkarır. Ziyaretçi onayını almak (CMP’niz / çerez banner’ınız aracılığıyla) site sahibi olarak sizin sorumluluğunuzdadır.

Sınırlamalar#

  • Stripe ve Shopify kartları salt okunurdur — Stripe uygulamasındaki tek yazma işlemi, isteğe bağlı ve açıkça etkinleştirilen iade eylemidir.
  • E-postayla arayan uygulamalar (Stripe, Shopify, Mailchimp, MailerLite) doğrulanmış bir e-posta adresine ihtiyaç duyar. Anonim widget ziyaretçilerinden veya adressiz kanallardan gelen konuşmalar dürüst bir "aranacak bir şey yok" kartı gösterir.
  • Jira desteği yalnızca Jira Cloud’u kapsar.
  • Mailchimp yeniden abone olma sunmaz: abonelikten çıkıldığında yalnızca kişinin kendisi bir kayıt formu üzerinden geri dönebilir. Bu akış sizin için önemliyse MailerLite’ın yeniden abone etme özelliğini kullanın.
  • Tracio kararları yalnızca SDK yüklü widget konuşmaları için vardır — e-posta veya mesajlaşma kanalları için asla.