Kendi sisteminizi bağlayın

Genel Bakış

Kanallar & entegrasyonlar → Kendi sisteminiz (/tr/integrations/own-system), müşteri hesaplarını kendi sistemlerinde (örneğin bir lojistik portalı) tutan ve bu verileri OrderInChat'a kopyalamak istemeyen mağazalar içindir.

• OrderInChat widget'ını oturum açmış sayfalarınıza gömüyorsunuz.
• Sunucunuz, oturum açmış kullanıcı için kısa ömürlü bir token imzalıyor ve bunu widget'a veriyor.
• O müşteri kendi hesabıyla ilgili bir şey sorduğunda (örneğin "Gönderimim nerede?"), AI, o kullanıcının token'ı ile kendi salt okunur MCP araçlarınızı çağırıyor, metin sohbetinde ve widget'tan başlatılan sesli aramalarda.
• OrderInChat yalnızca imzanızı kontrol eder. Asla kimlik oluşturmaz, veritabanınızı okumaz ve araçlarınızın döndürdüğü verileri saklamaz.

Ücretli planlarda (Starter, Pro, Ultra) mevcuttur. Geçerli bir token'ı olmayan ziyaretçiler anonimdir: AI, bilgi tabanınızdan yanıt verir ve hesap soruları için oturum açmalarını ister.

Geliştiricinizin yapay zekâsına yaptırın

Geliştiricinizin yapay zekâsına verin bölümünde Talimatı kopyala'ya tıklayın ve metni olduğu gibi geliştiricilerinizin kullandığı yapay zekâ asistanına (Claude Code, Cursor, ChatGPT…) yapıştırın. Metin İngilizcedir ve neyin kurulacağını — token endpoint'i, imzalı MCP sunucusu ve widget kodu — mağaza kimliğiniz ve adresleriniz doldurulmuş olarak tam anlatır. Sonunda yapay zekâdan bu sayfaya girilecek değerlerin listesini ister. Gizli anahtarlar metinde asla yer almaz: imzalama anahtarlarını bu sayfada oluşturup sunucunuza kendiniz girin.

1. Kullanıcı oturum açma token'ı

Sunucunuz, oturum açmış kullanıcı için bir JWT imzalar:

OrderInChat'ın bunu nasıl doğrulayacağını seçin:

• JWKS URL (ES256 veya RS256) — genel anahtarlarınızın HTTPS adresi.
• Açık anahtar (ES256 veya RS256) — PEM açık anahtarını yapıştırın.
• Paylaşılan gizli anahtar (HS256) — en az 32 karakter, şifreli olarak saklanır.

Canlıya geçmeden önce kontrol etmek için Test a token altında bir örnek token yapıştırın. Geçersiz veya süresi dolmuş bir token sohbeti asla başarısız etmez — ziyaretçi basitçe anonim olarak muamele görür.

2. MCP sunucunuz

MCP sunucunuzun adresini girin (Streamable HTTP, tools/list ve tools/call). Test ve Canlı her birinin kendi adresi ve imzalama gizli anahtarı vardır; Aktif mod AI'nın hangisini kullanacağını seçer.

Bir imzalama gizli anahtarı almak için Oluştur butonuna tıklayın. Bu bir kez gösterilir — sunucunuzda saklayın. İptal et hemen kaldırır (bu modda aramalar durur, yeni bir tane oluşturana kadar).

OrderInChat'ın sunucunuza gönderdiği her istekte bulunur:

• X-OIC-Timestamp — Unix saniyeleri
• X-OIC-Signature — v1= + imzalama gizli anahtarınızla timestamp.body'nin hex HMAC-SHA256'i
• X-OIC-User-Token — kullanıcının token'ı, değişmeden (kendiniz doğrulayın ve yalnızca o kullanıcının verilerini döndürün)
• X-OIC-Mode — test veya live

İmzası eşleşmeyen veya zaman damgası 5 dakikadan eski olan istekleri reddedin. OrderInChat'ın sabit bir IP adresi yoktur, bu nedenle IP izin listesi yerine imzayı kullanın.

3. Araçlar

Sunucunuzun listelediği araçları okumak için Araçları Keşfet butonuna tıklayın, ardından AI'nın kullanabileceği araçları açın. Yalnızca salt okunur araçlara izin verin. Daha sonra görünen araçlar, açana kadar kapalı olarak başlar.

• Metin sohbeti: bir araç çağrısı en fazla 8 saniye sürebilir.
• Sesli aramalar: en fazla 3 saniye; asistan önce kısa bir "kontrol edeyim" der. Sunucunuz yavaşsa, şu anda kontrol edemediğini söyler.
• Araçlarınızın döndürdüğü veriler yalnızca veri olarak değerlendirilir, asla talimat olarak değil ve sohbet geçmişinde saklanmaz.

4. Widget'ı gömün

<script>
  window.OrderInChatSettings = {
    userToken: "",
    getUserToken: async () => (await fetch("/your/oic-token")).text(),
  };
</script>
<script src="https://app.orderinchat.com/widget/oic-widget.js" data-tenant-id="YOUR-STORE-ID"></script>

getUserToken, token süresi dolmak üzereyken çağrılır. Script yüklendikten sonra ayrıca OrderInChat.setUserToken(token), OrderInChat.clearUserToken() (oturum kapatıldığında) ve OrderInChat.onTokenRefresh(fn) kullanabilirsiniz.

Geçerli bir token ile ve sesli asistan açıkken, widget başlığı bir telefon butonu gösterir. Arama widget içinde gerçekleşir ve AI kredileri üzerinden faturalandırılır, herhangi bir web sitesi araması gibi (araç çağrıları aramaya dahildir). Web arama sesleri kaydedilmez.

Özelleştir widget ayarlarını yeni sekmede açar. Kod her sayfa açılışında widget görünümünü OrderInChat'ten (data-tenant-id ile) okur; orada kaydettiğiniz değişiklikler kodu yeniden yapıştırmadan hemen geçerli olur. Vitrin için seçili widget profili (yoksa aktif ya da ilk profil) kullanılır, yeni profil oluşturulmaz.

5. Bağlantıyı test edin

Araçlar bölümünün altındaki Bağlantıyı test et, test imza anahtarıyla Test MCP adresinize sabit kontroller çalıştırır. Yapay zekâ kullanılmaz ve hiçbir şey kaydedilmez. Şunları kontrol eder:

• adres herkese açık https (localhost ya da özel ağ adresi değil);
• doğru imzalı tools/list çalışıyor;
• yanlış imzalı istek reddediliyor;
• doğru imzalı ama 5 dakikadan eski zaman damgalı istek reddediliyor;
• açık bir araçta kullanıcı token'ı olmadan tools/call hata döndürüyor ve veri vermiyor;
• Jeton test et alanına örnek token yapıştırdıysanız tools/call çalışıyor — ve ne kadar hızlı (2 saniyenin üstü sesli aramalar için yavaş; sesli aramalar 3 saniyede vazgeçer).

Yalnızca keşfettiğiniz ve açtığınız araçlar, boş argümanlarla çağrılır; örnek token yalnızca o test için kullanılır, hiç saklanmaz. Başarısız her maddede nasıl düzeltileceği yazar. Sonuçları geliştiriciniz için kopyalayın, geliştiricinize ya da onun yapay zekâsına yapıştırabileceğiniz İngilizce bir rapor kopyalar; hiçbir madde başarısız kalmayana kadar testi tekrarlayın.

Ekibinizin gördüğü

• Gelen Kutusu → Web: token'dan müşterinin adı ve e-posta adresi, ya da ikisini de göndermediğinizde Kullanıcı #ID. Her AI yanıtı, hangi araçlarınızı kullandığını ve çalışıp çalışmadığını gösterir — asla verileri göstermez.
• Gelen Kutusu → Aramalar: widget aramaları Mağaza web sitesi altında ve Canlı sırasında görünür; transkript her araç adımını gösterir (sadece isim ve sonuç).
• Müşteriler: her kullanıcı kimliği için bir müşteri kartı oluşturulur veya yeniden kullanılır (Mağaza kullanıcı kimliği), böylece aynı kişinin sohbetleri ve aramaları bağlantılıdır.