Boleh kami bantu?

Terangkan ringkas perkara ini – kami akan menghubungi Anda melalui e-mel.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
Ke halaman utama

Sohbette müşteri verileri (siparişler, kargo, faturalar)

Yapay zekâ asistanı, oturum açmış müşterilerin kendi siparişleriyle ilgili sorularını yanıtlasın: imzalı kimlikle güvenli, alanları tam belirlenmiş, mağazanızdan alınan veya içe aktarılan verilerle.

Müşteri verileriyle yapay zekâ asistanı “Kargom nerede?”, “Faturam ödendi mi?” veya “Son siparişimde neler vardı?” gibi soruları yanıtlar; oturum açmış müşteriler için ve yalnızca kendi verileri hakkında. Özellik ücretli planlarda kullanılabilir.

Veriler nasıl korunur?

Ön koşul: kimlik doğrulama

Asistan müşteri verilerini yalnızca kimliği sunucunuz tarafından doğrulanmış ziyaretçiler için kullanır. Hesabınızda Proje → Kimlik doğrulama altında gizli anahtar ayarlayın. Sunucunuzda kalır; tarayıcıya veya yerleştirme koduna asla konmaz.

Sunucunuz, oturum açmış her müşteri için son kullanma zamanıyla (en fazla 24 saat sonrası) bir özet hesaplayıp widget’a iletir:

$userId = (string) $customer->id;
$exp    = time() + 3600;
$hash   = hash_hmac('sha256', $userId . '.' . $exp, getenv('RC_IDENT_SECRET'));
echo "<script>ReactiveChat('identify', { userId: " . json_encode($userId)
   . ", userHash: " . json_encode($hash) . ", exp: " . $exp . " });</script>";

const crypto = require('crypto');
const exp  = Math.floor(Date.now() / 1000) + 3600;
const hash = crypto.createHmac('sha256', process.env.RC_IDENT_SECRET)
                   .update(String(user.id) + '.' + exp).digest('hex');
// in the template: ReactiveChat('identify', { userId: '<id>', userHash: '<hash>', exp: <exp> });

exp olmadan özet, ziyaretçiyi hâlâ doğrular (örneğin sohbet geçmişi için), ancak müşteri verileri için yeterli değildir. Gizli anahtarı yenilediğinizde eskisi 24 saat geçerli kalır.

E-postayı da imzalama (randevu alma ve e-posta tabanlı entegrasyonlar için). Özetin yanındaki email yalnızca imzanın parçasıysa doğrulanmış sayılır: userHash = HMAC-SHA256(secret, userId + "." + exp + "." + email) – adres tam olarak identify çağrısına ilettiğiniz biçimde olmalıdır. Bu olmadan ziyaretçi oturum açmış olarak kalır; ancak asistan o adres için randevu almaz ve entegrasyonlar o adresi aramaz. Mevcut userId + "." + exp biçimi değişmeden çalışmaya devam eder.

Veri alma, içe aktarma veya ikisi

Proje → Müşteri verileri altında asistanın verileri nereden alacağını seçersiniz:

Asistan hangi verileri alabilir?

Her alanı ayrı etkinleştirirsiniz. Varsayılanlar olağan soruları kapsar:

Kapalı alan asistana asla ulaşmaz: veri alırken atılır, içe aktarırken hiç saklanmaz. Şehir ve posta kodu bilinçli olarak yalnızca açıkça etkinleştirdiğinizde kullanılabilir; sokak ve ad her zaman dışarıda kalır.

Asla iletilmeyenler

Bunlar etkinleştirilemez. Mağazanız gönderirse atılır:

Sınırlar

Yanıt başına en fazla 10 sipariş, sipariş başına en fazla 20 ürün, en fazla 200 karakterlik metinler, yanıtın tamamı en fazla 16 kB. Bilinmeyen alanlar hata olmadan atılır.

Veri alma uç noktası

reactive.chat uç noktanızı POST ile çağırır:

POST https://shop.your-domain.com/rc-customer-data
Content-Type: application/json
X-RC-Zeit: 1791196400
X-RC-Signatur: <hex(HMAC_SHA256(endpoint secret, X-RC-Zeit + "." + body))>

{"user_id":"4711","anliegen":"bestellung","referenz":"2026-0815","sprache":"en","nonce":"..."}

Uç noktanız şunları yapmalıdır:

  1. imzayı doğrulamak (sabit süreli karşılaştırma) ve X-RC-Zeit değeri 5 dakikadan fazla farklı olan istekleri reddetmek,
  2. yalnızca verilen user_id verilerini döndürmek,
  3. genel erişime açık adreste 443 numaralı port üzerinden https ile, yönlendirme olmadan erişilebilir olmak,
  4. 3 saniye içinde yanıtlamak.

Yanıt:

{
  "bestellungen": [
    {
      "nummer": "2026-0815", "datum": "2026-09-28", "status": "shipped",
      "summe": "49.90", "waehrung": "EUR",
      "positionen": [ { "name": "Balance bike blue", "menge": 1 } ],
      "versand": { "dienst": "DHL", "sendungsnummer": "00340434...", "status": "out for delivery" },
      "rechnung": { "nummer": "R-2026-1201", "status": "paid", "faellig_am": "2026-10-12" }
    }
  ]
}

Geliştirici dokümantasyonunda tam PHP örneği bulunur (kundendaten-referenz-endpunkt.php).

Bağlantıyı test et ile reactive.chat, user_id değeri rc-test ve istek türü test olan çağrıyla uç noktanızı çağırıp sonucu gösterir. Bunun için boş liste veya örnek sipariş döndürün.

API ile içe aktarma

kundendaten:schreiben yetkisine sahip API anahtarıyla:

PUT https://reactive.chat/v1/kundendaten/4711?project_id=123
Authorization: Bearer <API key>
Content-Type: application/json

{"bestellungen":[ ... as above ... ]}

project_id, projenizin numarasıdır; çalışma alanınızda yalnızca bir proje varsa atlayabilirsiniz. PUT, bu müşteri kimliğinin tüm siparişlerini değiştirir (en fazla 50). DELETE /v1/kundendaten/4711?project_id=123 bunları kaldırır. İçe aktarılan veriler bizde şifreli saklanır ve son içe aktarmadan 90 gün sonra silinir; bu nedenle değişiklikleri sürekli, örneğin her durum değişikliğinde gönderin.

Oturum açmamış ziyaretçiler

Doğrulanmış kimliği olmayan biri sipariş sorarsa asistan hiçbir veri almaz. Bunun yerine Proje → Müşteri verileri altında yapılandırdığınız bildirimi gösterir: dil başına metin ve isteğe bağlı oturum açma bağlantısı. Alternatif olarak soruyu ekibinize aktarır.

Neler saklanır?

Sorun giderme

Dokümantasyonda daha fazlası

Ayrıntılı bilgi: Müşteri verisi uç noktası. Tüm bölümler dokümantasyondadır.

Kemas kini terakhir: