Entegrasyonlar ve kanallar (teknik)

Kanallar diğer hizmetlerin mesajlarını web sitesi sohbetiyle aynı temsilci paneline getirir; entegrasyonlar diğer hizmetlere olay gönderir veya onlardan bilgi alır. Bu sayfa tekniği açıklar. Hesabınızdaki kullanım El kitabında anlatılır.

Durum: Kanallar ve çoğu entegrasyon, benzetilmiş sağlayıcı yanıtlarıyla test edilmiştir; henüz her gerçek hesapla test edilmemiştir. İmzalı webhook tamamlanmıştır (orada belirtilen kısıtlamayla); diğer tüm sağlayıcılarda açtıktan sonra entegrasyon günlüğünü kontrol edin. Bunları beta olarak değerlendirin.

Ortak kurallar

• Callback adresleri https://reactive.chat/kanal/<kanal>/<SITE_KEY> biçimindedir. Site anahtarı hesabınızda Proje → Kurulum altındadır.
• Her gelen yol sağlayıcının imzasını doğrular. Sağlayıcının gizli anahtarı olmadan hiçbir şey kabul edilmez.
• Erişim bilgileri şifreli ve yapılandırmanın geri kalanından ayrı saklanır.
• Ekibinizin yanıtları giden kuyruk üzerinden sağlayıcıya gider; takılan platform sohbeti bekletmez.
• Mesaj uzunluğu: Plan sınırını aşan gelen mesajlar kısaltılır ve [...] ile işaretlenir (Sınırlar).
• Kanallardaki ekler (e-posta, Telegram fotoğrafları) widget ile aynı kontrolden geçer (tür, boyut, kota). Reddedilen dosyalar metinde “[Ek kabul edilmedi: …]” olarak, projenin varsayılan dilinde görünür (de, en, pl; aksi durumda İngilizce).

WhatsApp, Messenger, Instagram

Hesabınızda Entegrasyonlar altında kurulur. Meta Developer Dashboard içinde kendi uygulamanız gerekir; mesajlarınız bizim hesabımızdan geçmez.

• Callback URL: https://reactive.chat/kanal/whatsapp/SITE_KEY, …/kanal/messenger/SITE_KEY veya …/kanal/instagram/SITE_KEY
• Verify Token: Meta’da ve bizde aynı girdiğiniz uzun rastgele dize (sabit süreli karşılaştırma).
• App Secret: Her callback imzasını bununla doğrularız. App Secret olmadan gelen yol hiçbir şey kabul etmez.
• Access Token: Sizin adınıza göndermek için kullanırız.

İletimleri sessizce başarısız kılan platform kuralları:

• WhatsApp: Müşterinin son mesajından sonraki 24 saat boyunca serbestçe yanıtlayabilirsiniz; sonrasında yalnızca onaylı şablonla (UTILITY türü, tam olarak bir {{1}} yer tutucusu). Adını yapılandırmaya girin; pencere dışında serbest mesaj göndermeyiz.
• Instagram: Önce müşteri yazmalıdır.
• Messenger: Mesaj etiketlerinden yalnızca HUMAN_AGENT kalır; diğerlerini reddederiz.

Meta, callback yanıtını beş saniye içinde bekler; gelen yolumuz yalnızca kabul edip kuyruğa alır.

Telegram, SMS, e-posta

Bu kanallar projeye aittir; Proje → Kanallar altında kurulur.

• Telegram: Kendi botunuz. Bot token’ını kaydettiğinizde https://reactive.chat/kanal/telegram/SITE_KEY callback adresini her callback’in taşıması gereken rastgele secret_token ile setWebhook üzerinden kendimiz kaydederiz. Varsayılan olarak asistan da yanıtlar.
• SMS: Twilio hesabınız üzerinden (Twilio entegrasyonu). Numara için “A message comes in” altında https://reactive.chat/kanal/sms/SITE_KEY girin; X-Twilio-Signature doğrulanır. Varsayılan olarak asistan da yanıtlar.
• E-posta: Posta kutunuz her dakika IMAP ile alınır; yanıtlar SMTP’niz üzerinden gider (aksi durumda Reply-To ile gönderim hizmetimizden). Açıldığında eski e-postalar alınmaz. Sohbete atama In-Reply-To/References ile; aksi durumda son 30 gündeki gönderen ve konuya göre yapılır. Alınmayanlar: ofis dışında yanıtları, teslim raporları, posta listeleri, spam işaretli e-postalar, gönderen ve saat başına 20’den fazla e-posta (proje başına 300). Varsayılan olarak asistan e-postaya yanıt vermez; açıldığında yanıtları Auto-Submitted: auto-replied taşır.

Bilinen eksik: Sağlayıcıya iletim kalıcı olarak başarısız olursa (engellenen numara, kapanmış pencere) nedeni entegrasyon günlüğündedir; henüz sohbette görünmez.

Entegrasyonlar

Entegrasyonları hesabınızda Entegrasyonlar altında açarsınız. Her birinin kendi erişim bilgileri vardır (anahtar, token, adres veya sağlayıcıda oturum açma). Olaylar (conversation.created, message.created, handoff.requested, csat.submitted, fehlerfall.erstellt) yeniden denemeli kuyruktan geçer:

• artan aralıklarla en fazla beş yeniden deneme (1 sn ile 10 dakikanın biraz üzeri),
• sağlayıcı ve çalışma alanı başına devre kesici: 60 saniyede 5 hatadan sonra 30 saniye duraklama,
• bir saatten eski olaylar artık iletilmez,
• sohbet entegrasyonu asla beklemez.

Kodda bulunan sağlayıcılar:

• Kendi sistemlerinize olaylar: webhook’lar (imzalı; Webhook’lar bölümüne bakın), Zapier, Make, n8n (REST hook’larıyla)
• Ekip sohbeti: Slack, Microsoft Teams, Discord
• Destek talepleri ve CRM: Zendesk, Freshdesk, HubSpot, Pipedrive, Jira, Linear, GitHub
• Mağazalar: Shopify, WooCommerce, Shopware, Stripe
• Bilgi: web sitesi tarayıcısı, WordPress, Notion, Confluence, Google Drive
• Analiz ve hatalar: Google Analytics 4, Matomo, Plausible, Sentry
• Randevular: Cal.com
• Kanallar: WhatsApp, Messenger, Instagram, Telegram, Twilio, e-posta

Kendi sağlayıcınızı kaydedemezsiniz. Kendi bağlantılarınız için webhook’ları, sunucu API’sini veya MCP kullanın.

Sohbette mağaza özellikleri (WooCommerce, Shopify ve Shopware için “Sepete ekle” gibi) reactive.chat tarafından proje başına etkinleştirilir; yalnızca kayıtlı mağaza ana makinesinde çalışır ve kendine ait JavaScript API’si yoktur.

Mobil uygulamalar

Uygulamalar için yerel SDK yoktur; WebView için yerleştirme sayfası vardır: Mobil uygulamalar.

Sonraki: Mobil uygulamalar