Entegrasyonlar, taşıma ve API anahtarları

Entegrasyonlar (/app/integrations) altında reactive.chat’i ekibinizin zaten kullandığı araçlarla bağlarsınız. Entegrasyonlar tüm çalışma alanı için geçerlidir. Sahipler ve yöneticiler bunları ayarlayabilir; belirli projelerle sınırlandırılmış bir yönetici ayarlayamaz.

Bu sayfa, entegrasyonların ne işe yaradığını ve nasıl kullanıldığını açıklar. Webhook imzalama gibi teknik ayrıntılar Teknik entegrasyon bölümündedir.

Mevcut durum hakkında açık bilgi

30’dan fazla hizmete bağlantı mevcuttur. Çoğu simüle edilmiş karşı sistemlerle test edilmiştir, ancak henüz canlı hizmete karşı çalıştırılmamıştır. Entegrasyonlar sayfası bunları “Canlı hizmetle doğrulanmadı” olarak işaretler; bazılarında “Devam ediyor” yazar. Webhook’lar ve Slack bu notu taşımaz. Doğrulanmamış bir entegrasyonu ayarlayın, gerçek verilerle test edin ve bir sorun varsa Geri bildirim gönder ile bize bildirin.

Bir entegrasyonu ayarlama

1. Entegrasyonlar bölümünü açın. Üstte kaçının bağlı olduğu, kaçında hata bulunduğu veya duraklatıldığı ve iletimlerin başarısız olup olmadığı görünür.
2. Katalogda arama yapın (Entegrasyon ara, “Tümü” veya “Bağlı değil” filtresi) ve Ayarla seçeneğine tıklayın.
3. Hizmetin istediği erişim bilgilerini girin; genellikle oradaki hesabınızdan bir API anahtarı veya token gerekir.
4. Bağlan ve etkinleştir bağlantıyı hemen kontrol eder ve entegrasyonu açar. Etkinleştirmeden kaydet ile bunu sonraya bırakabilirsiniz.

Daha sonra bir entegrasyonu Düzenleyebilir, Duraklatabilir, Yeniden etkinleştirebilir veya Kaldırabilirsiniz. Kaldırma, saklanan erişim bilgilerini siler ve geri alınamaz. Erişim bilgileri şifreli saklanır.

Hizmette oturum açma düğmesi yalnızca Google Drive için vardır. Diğerlerinde erişim bilgilerini kendiniz girersiniz; örneğin Slack için kendi Slack uygulamanızın bilgilerini.

Bir hizmet yanıt vermediğinde

Her entegrasyon bir kuyruk üzerinden çalışır. Hizmet yanıt vermezse iletim, aralıklar giderek uzatılarak birkaç kez yeniden denenir; tekrarlanan hatalardan sonra bir süre askıya alınır (“Geçici olarak askıya alındı: hizmet art arda yanıt vermedi …”). Yaklaşık bir saat içinde iletilemeyen olay atılır. En son başarısız iletimleri Başarısız iletimler bölümünde içerikleri olmadan görürsünüz.

Bir sohbet mesajı asla entegrasyonu beklemez. Bir hizmet takılırsa sohbet etkilenmeden devam eder.

Neler mevcut?

Ekibinize bildirimler

• Slack – her yeni sohbet bir kanalda ileti dizisi olarak görünür. Dizide yanıt verirsiniz ve ziyaretçi yanıtı sohbette görür. /rc durumu gösterir. Slack kullanıcılarını temsilcilerle eşleştirirsiniz.
• Microsoft Teams, Discord – webhook adresi üzerinden bildirimler.
• Telegram – bot token’ı ve sohbet kimliğiyle bir sohbete bildirimler.
• E-posta – ekip posta kutusuna bildirimler.

Otomasyon

• Webhook’lar – reactive.chat, seçtiğiniz bir adrese https:// üzerinden imzalı olaylar gönderir: yeni sohbet, her mesaj, bir insana aktarım isteği, değerlendirme, yeni hata olayı. Zapier, Make ve n8n de bu şekilde bağlanır. İmzalama gizli anahtarını gösterebilir, kopyalayabilir ve yeniden oluşturabilirsiniz; yeni anahtar hemen geçerli olur, eskisi artık geçerli olmaz.
• Zapier – arayüzün REST hook’ları üzerinden. Make ve n8n için henüz hazır uygulama yoktur; bunlarda webhook kullanın.

Temsilci panelinde bağlam

Bu entegrasyonlar, temsilci panelinin bağlam sütununda ziyaretçiyle ilgili kartlar gösterir; örneğin siparişleri veya CRM kişisi, bazılarında işlemler de bulunur:

• CRM – HubSpot, Pipedrive
• Mağaza – Shopify, Shopware 6, WooCommerce
• Ödemeler – Stripe (sınırlı bir okuma anahtarıyla)
• Web sitesi – WordPress
• Analiz – Matomo, Plausible, Google Analytics 4
• Hatalar – Sentry

Kart, ziyaretçinin imzasız beyanına dayanan bilgileri işaretler. İşlemleri Çalıştır ve bir onay ile yürütürsünüz.

Talepler, randevular, telefon

• Zendesk, Freshdesk, Jira, Linear, GitHub – bir sohbetten veya hata olayından talep ya da sorun kaydı oluşturma.
• Cal.com – uygun randevuları gösterme ve ayırtma; yapay zekâ asistanı üzerinden de yapılabilir.
• Twilio – temsilci panelinden SMS ve SMS kanalının gönderim yolu.

Bilgi kaynakları

• Notion, Confluence – içeriği bilgi tabanına alma.
• Google Drive – bilgi tabanı altında “Dosyalar ve Google Drive” (Bilgi tabanı ve yardım merkezi sayfasına bakın).
• KB-Crawler – web sitenizin taranmasına ilişkin ayarlar.

Kanallar

• WhatsApp Business, Facebook Messenger, Instagram Direct – Kanallar sayfasına bakın.

Başka bir sağlayıcıdan geçiş

Taşıma (/app/migration) altında başka bir sohbet aracından veri alırsınız:

• Intercom ve Crisp – arayüzleri veya dışa aktarma dosyası üzerinden; Crisp için yardım makaleleri Markdown olarak da alınabilir,
• Tidio – dışa aktarma dosyası üzerinden,
• Zendesk – tam JSON dışa aktarımı ve yardım merkezinin dışa aktarımı üzerinden.

İzlenecek adımlar:

1. Yeni taşıma başlat ve hedefi seçin (Hangi projeye?).
2. Bağlan ve neler olduğunu gör – mevcut verileri ve bir örneği görürsünüz.
3. Neler taşınsın? – kişiler, sohbetler, makaleler.
4. Taşımayı başlat. Durdurabilir veya İşi silebilirsiniz.

Bilmeniz gerekenler:

• İçe aktarılan sohbetler temsilci paneline kapalı gelir.
• İçe aktarılan kişiler doğrulanmamış sayılır.
• Metinlerdeki hassas bilgiler maskelenir.
• Ekler dosya olarak değil, bağlantı olarak gelir.
• İkinci çalıştırma hiçbir şeyi iki kez oluşturmaz.
• Eski sağlayıcıya ait erişim bilgileriniz çalıştırma sonrasında silinir.
• Sağlayıcı arayüzleri, gerçek hesaplar olmadan test edilmiştir; dosya içe aktarımları örnek dosyalarla uçtan uca test edilmiştir.

Kodu değiştir ile hesap, mevcut bir Intercom veya Crisp kodunu reactive.chat koduna dönüştürür. boot, open, identify ve track JavaScript komutlarının adları Intercom ile aynı kalır.

API anahtarları

API anahtarları (/app/api-keys, sahipler ve yöneticiler) altında REST arayüzü için anahtarlar oluşturursunuz. Bir anahtar yalnızca bir kez gösterilir; sonrasında reactive.chat yalnızca parmak izini saklar. Bu nedenle hemen güvenli bir yere kopyalayın.

Oluştururken anahtarın yapabileceklerini seçersiniz:

• yalnızca okuma
• okuma ve yazma
• yalnızca müşteri verisi içe aktarma – Sohbette müşteri verileri sayfasında açıklanan içe aktarma için
• okuma + ziyaretçi verileri veya okuma, yazma + ziyaretçi verileri – anahtar ancak bunlarla ziyaretçilerin adını, e-postasını ve telefonunu görür

Listede ad, önek, anahtarın ne zaman ve kim tarafından oluşturulduğu ve son kullanım zamanı görünür. İptal et hemen geçerli olur ve geri alınamaz.

Bir anahtarla reactive.chat’i Model Context Protocol (MCP) kullanan yapay zekâ araçlarına da bağlayabilirsiniz; sayfada örnekler bulunur. Arayüzün nasıl çalıştığı Teknik entegrasyon bölümünde açıklanır.