اعرف أيّ عميل يتحدّث معك.
عندما يكون العميل مسجّل الدخول على موقعك، مرّر معرّفه إلى الأداة مع توقيع لا يستطيع إنشاءه إلا خادمك. عندها يعرف Nova مع من يتحدّث، ويحتفظ بسجلّ محادثاته على جميع أجهزته، وتستطيع أدوات MCP الخاصة بك البحث عن طلبات هذا العميل نفسه.
أنشئ مفتاح الهوية السرّي من صفحة التثبيت في البوابة. وقّع معرّف العميل كنصّ على خادمك باستخدام HMAC-SHA256 وهذا المفتاح، ثم مرّر الناتج بصيغة hex في userHash. يتجاهل Nova أيّ معرّف بلا توقيع صالح.
عيّن kockatoosSettings قبل سكربت الأداة، أو استدعِ kockatoosChat.identify() بعد تحميلها، واستدعِ logout() عندما يسجّل العميل خروجه. رمز وصول العميل اختياري ولا يُرسَل إلا إلى خادم MCP الخاص بك. لا تطبعه أبدًا داخل صفحة HTML قد تقدّمها ذاكرة التخزين المؤقت لزوّار آخرين.
اقرأ الدليل الكامل لأصحاب الأعمال والمطوّرين
window.kockatoosSettings = {
identity: {
userId: '42',
userHash: 'HMAC_SHA256_OF_THE_ID',
name: 'Jane Doe',
email: 'jane@example.com',
token: 'CUSTOMER_ACCESS_TOKEN', // optional
attributes: { plan: 'gold' },
},
};
window.kockatoosChat.logout(); // on sign-out
// PHP
hash_hmac('sha256', (string) $customer->id, $identitySecret);
// Node
crypto.createHmac('sha256', identitySecret).update(String(customer.id)).digest('hex');
{% comment %} Shopify Liquid, inside {% if customer %} {% endcomment %}
{{ customer.id | hmac_sha256: 'YOUR_IDENTITY_SECRET' }}