Müşteri verisi (sipariş ve kayıt sorgusu)

Nereden: Ayarlar → Entegrasyonlar → Müşteri verisi → Kendi sisteminiz (e-Temsilci JSON) → Bağla

Müşteriniz arar ve "Kargom nerede?" der. Asistan cevabı aramak için bekletmez: telefon çalarken arayanın numarasıyla sizin sisteminiz sorgulanır, sonuç asistana görüşme başlamadan ulaşır. Asistan siparişin durumunu, kargo firmasını ve takip numarasını, tahmini teslim tarihini, iade durumunu ve sizin verdiğiniz diğer bilgileri (randevu, bakiye, puan, servis kaydı) doğrudan söyler.

Ne zaman sorgulanır?

• Gelen çağrılarda: kaynak bağlıyken varsayılan olarak açıktır. Gelen çağrılar → Asistan sekmesindeki "Arayanın sipariş ve müşteri bilgilerini sorgula" anahtarıyla kapatabilirsiniz. Kabul edilmeyen çağrılarda (mesai dışı, gizli numara, yetersiz bakiye, meşgul) sorgu yapılmaz.
• Giden kampanyalarda: varsayılan olarak kapalıdır, çünkü büyük bir listede her arama sisteminize bir sorgu demektir. Kampanya sihirbazının Asistan adımından açarsınız; sorgu arama başlamadan hemen önce yapılır.
• Test aramalarında da sorgulanır: kendi numaranızla deneyebilirsiniz.
• Görüşme sırasında arayan başka bir sipariş numarası söylerse asistan o numarayla tekrar sorgular. Sipariş arayanın numarasına ait değilse asistan yalnızca durumunu ve kargo bilgisini görür.

Sisteminiz 1,5 saniye içinde cevap veremezse çağrı bekletilmez: asistan görüşmeyi başlatır, sorgu arka planda tamamlanır ve arayan sorduğunda kullanılır. Sorgu ücretsizdir; hiçbir pakette ek ücret yoktur.

Hangi kaynaklar bağlanabilir?

• Kendi sisteminiz (e-Temsilci JSON): kendi yazılımınız, ERP, CRM, randevu sistemi veya pazaryeri paneliniz ne olursa olsun, sizin sunucunuzda bizim biçimimizde cevap veren küçük bir uç nokta yazarsınız. Biçim ve hazır PHP / Node.js örnekleri: Müşteri verisi API'si.
• Hazır bağlantılar: e-ticaret altyapınızın kartı Ayarlar → Entegrasyonlar → Müşteri verisi grubundadır; kurulum rehberi kartın Nasıl bağlanır? bağlantısındadır. Şu an: ikas, Shopier, Shopify, WooCommerce.

Firma başına tek bir kaynak sorgulanır. Birden fazla kaynak bağlarsanız kartlardan birini Sorgu kaynağı yap ile seçersiniz.

Asistan ne söyler, ne söylemez?

• Bilgileri "sistemimizde görüyorum" diye aktarır; kaynağın adını söylemez.
• Açık adres (il ve ilçe dışında), ödeme ayrıntısı ve e-posta adresinin tamamı söylenmez. Asistana e-posta yalnızca maskeli gider (a***@ornek.com).
• İç not asistanın bilmesi içindir, müşteriye okunmaz.
• Bilgide olmayanı uydurmaz; "ekibimizden teyit edip size ileteyim" der ve görüşmeyi Planlama yapıldı olarak işaretler.
• Karşılamada ad kullanılmaz: telefonu başkası kullanıyor olabilir.

Arayan numarası taklit edilebilir. Kartın ayarlarındaki Arayana ne söylensin? seçeneği:

• Standart: numarası eşleşen arayana sipariş durumu, kargo, tahmini teslim, ürün adları ve tutar söylenir.
• Önce doğrula: asistan ayrıntıdan önce sipariş numarasını veya siparişteki ad soyadı sorar ve kayıtla eşleşmeden ayrıntı vermez.

Bağlantıyı test etme

Kartta Test et'e basın ve kendi müşterilerinizden birinin numarasını (isterseniz bir sipariş numarasını) yazın. Asistanın göreceği bilgiler, cevabın kaç milisaniyede geldiği ve biçime uymadığı için atılan alanlar gösterilir. 1,5 saniyeden yavaş cevaplarda uyarı çıkar; hedef 800 ms'nin altıdır. Test sonucu hiçbir yere kaydedilmez.

Görüşme detayının zaman çizelgesinde her sorgu "Müşteri verisi sorgulandı" olarak görünür (sonuç, sipariş sayısı, süre); sorgulanan bilgilerin kendisi görüşmeye kaydedilmez.

Arayan "Kargom nerede?" dediğinde asistan cevabı aramadan bilsin: telefon çalarken arayanın numarasıyla sisteminize imzalı bir sorgu gönderilir ve cevabınız asistana görüşme başlamadan ulaşır. Bunun için sisteminizde, e-Temsilci müşteri verisi biçiminde cevap veren küçük bir uç nokta (ara katman) gerekir. Altyapınız, ERP'niz, CRM'iniz veya randevu sisteminiz ne olursa olsun bu yolla bağlanabilirsiniz.

Sunucu IP adresimiz: 188.245.28.244

Başlamadan önce

• İnternetten https:// ile erişilebilen, geçerli sertifikalı ve POST isteği kabul eden bir adres.
• Telefon numarasına göre sipariş ve müşteri bilgisini 2 saniye içinde (hedef 800 ms) döndüren küçük bir kod. Biçim ve PHP / Node.js örnekleri yardım merkezindeki Müşteri verisi API'si makalesinde.

Adım adım

1. Uç noktanızın adresini girin, arayana ne kadar bilgi verileceğini seçip kaydedin.
2. Ekranda bir kez gösterilen imza anahtarını (whsec_…) kopyalayıp uç noktanızın ayarlarına koyun.
3. Her sorgu JSON gövdeli bir POST isteğidir: data.phone içinde numaranın dört yazımı (e164, national, nsn, digits) ve arayan söylediyse data.order_number bulunur. Başlıklarda X-Arar-Event: customer.lookup, X-Arar-Timestamp ve X-Arar-Signature gelir.
4. İmzayı doğrulayın: X-Arar-Signature = v1= + HMAC-SHA256(anahtar, X-Arar-Timestamp + "." + ham gövde). 5 dakikadan eski istekleri reddedin.
5. Kayıt varsa {"version": "1", "found": true, …} ile müşteri bilgisini ve son siparişleri, yoksa {"version": "1", "found": false} dönün (404 değil).
6. Kartta Test et'e basıp kendi müşterilerinizden birinin numarasını yazın: asistanın göreceği bilgiler, süre ve atılan alanlar gösterilir.
7. Gelen çağrılar → Asistan'da "Arayanın sipariş ve müşteri bilgilerini sorgula" açık olsun. Giden kampanyalarda aynı anahtar sihirbazın Asistan adımındadır (varsayılan kapalı).

İmza doğrulama örneği (PHP)

$body = file_get_contents('php://input');
$timestamp = (int) ($_SERVER['HTTP_X_ARAR_TIMESTAMP'] ?? 0);
$expected = 'v1=' . hash_hmac('sha256', $timestamp . '.' . $body, $secret);

if (! hash_equals($expected, $_SERVER['HTTP_X_ARAR_SIGNATURE'] ?? '') || abs(time() - $timestamp) > 300) {
    http_response_code(401);
    exit;
}

$data = json_decode($body, true)['data'];
$nsn = $data['phone']['nsn'];          // 5321112233: numaranın son 10 hanesi

header('Content-Type: application/json; charset=utf-8');
echo json_encode(['version' => '1', 'found' => false]);   // kayıt yoksa

Sorun yaşarsanız

• Telefonu son 10 haneyle (data.phone.nsn) karşılaştırın ve o sütuna indeks koyun.
• Açık adres, T.C. kimlik no, kart numarası, IBAN ve sağlık bilgisi (teşhis, tedavi) göndermeyin; biçimde yoktur, gelirse atılır.
• Güvenlik duvarınızda yalnızca 188.245.28.244 IP adresinden gelen isteklere izin verebilirsiniz.
• Yönlendirmeler (3xx) izlenmez ve http:// kabul edilmez; adres isteği doğrudan karşılayan son adres olmalıdır.
• İmza anahtarını kaybettiyseniz kartta Anahtarı yenile'ye basın; eski anahtar hemen geçersiz olur.

KVKK

• Siz veri sorumlususunuz, e-Temsilci veri işleyendir. Sorgu yalnızca o çağrının numarasıyla ve o görüşmeye hizmet için yapılır; toplu veri çekme, eşitleme veya profil çıkarma yoktur.
• Sorgu isteğinde yalnızca telefon numarası (ve arayan söylediyse sipariş numarası) gönderilir.
• Sonuç hiçbir yerde saklanmaz: yalnızca birkaç dakikalık şifreli önbellekte ve o görüşmenin bağlamında yaşar. Asistanın söyledikleri, görüşmenin dökümünde kalır.
• Sorgu sonucu, asistanın cevap üretebilmesi için görüşme içeriğiyle birlikte yurt dışındaki yapay zekâ hizmet sağlayıcısında işlenir. Aydınlatma metninizin "sistemlerinizden alınan sipariş ve müşteri bilgilerini" de kapsadığından emin olun (bkz. Firmanızın sorumlulukları).
• Yalnızca asistanın ihtiyacı olanı gönderin. T.C. kimlik no, kart numarası, IBAN, açık adres, doğum tarihi ve sağlık bilgisi (teşhis, tedavi; KVKK m.6 özel nitelikli veri) göndermeyin. Klinik ve sağlık hizmetlerinde yalnızca randevu zamanını ve yerini yazın.