Genişletilebilir Eklenti Mimarisi — Özel Yetenekler Oluşturun (Gelecek)

Her işletmenin, genel çözümlerin tam olarak karşılayamayacağı benzersiz ihtiyaçları vardır. Planlanan eklenti sistemi, geliştiricilerin widget işlevselliğini özel yeteneklerle genişletmelerine olanak tanıyacaktır — kodu çatallamadan veya güncelleme yollarını kaybetmeden.

Gelişmiş kullanım durumları için eklentilerin önemi

Standart widget'lar, her iş gereksinimini tahmin edemez. Şunlara ihtiyacınız olabilir:

• Duygu analizi, öfkeli müşterileri insan ajanlarına yönlendirmek için
• CRM entegrasyonu, konuşmaları müşteri satın alma geçmişi ile zenginleştirmek için
• Özel moderasyon, marka spesifik içerik politikalarını uygulamak için
• Özel renderlayıcılar, sektör spesifik veriler için (tıbbi grafikler, finansal grafikler, yasal alıntılar)
• İş akışı otomasyonu tetikleyicileri (belirli anahtar kelimeler ortaya çıktığında destek bileti oluştur)

Temiz entegrasyon için yaşam döngüsü kancaları

Eklentiler, widget başlatıldığında kaydedilir ve önemli yaşam döngüsü anlarında geri çağırma alır:

• onBeforeMessageSend — kullanıcı mesajlarını arka uca göndermeden önce ön işleme tabi tutar
• onAfterMessageReceive — AI yanıtlarını render edilmeden önce son işlemden geçirir
• onConversationStart — konuşma başladığında eklenti durumunu başlatır
• onConversationEnd — kaynakları temizler, analizleri kaydeder
• onWidgetOpen / onWidgetClose — etkileşimi izler, yan etkileri tetikler
• onError — özel hata işleme veya raporlama

Mesaj ön işleyicileri ve son işleyicileri

Ön işleyiciler, kullanıcı mesajlarını göndermeden önce değiştirir:
- Yazım denetimi ve otomatik düzeltme
- Küfür filtreleme veya içerik moderasyonu
- Veri çıkarımı (e-postaları, telefon numaralarını, sipariş kimliklerini tespit etme)
- Duygu tespiti

Son işleyiciler, AI yanıtlarını render edilmeden önce değiştirir:
- Markdown geliştirme (tabloları etkileşimli bileşenlere dönüştürme)
- Bağlantı zenginleştirme (URL'leri önizleme, meta verileri açma)
- Uyum filtreleme (Kişisel olarak Tanımlanabilir Bilgileri, hassas finansal verileri gizleme)

Güvenlik yoluyla sandboxing

Eklentiler, widget güvenliğini veya istikrarını tehlikeye atamaz:

• Eklentiler, izole JavaScript alanlarında çalışır (global değişkenlere erişemez veya ad alanını kirletemez)
• API erişimi kısıtlıdır (eklenti yalnızca beyaz listeye alınmış alanları arayabilir)
• DOM erişimi sınırlıdır (eklenti, belirlenen render alanları dışında widget UI'sini değiştiremez)
• Çalışma süresi sınırlıdır (uzun süreli çalışan eklentiler, UI donmalarını önlemek için sonlandırılır)

Yapılandırma örneği

WidgetSDK.registerPlugin({
  name: 'sentiment-analyzer',
  version: '1.0.0',
  hooks: {
    onBeforeMessageSend: async (message, context) => {
      const sentiment = await analyzeSentiment(message.text);
      return { ...message, metadata: { sentiment } };
    },
    onAfterMessageReceive: (message, context) => {
      if (message.metadata?.sentiment < -0.5) {
        context.escalateToHuman(message);
      }
      return message;
    }
  }
});