الصفحة الرئيسية

أدلة الإعداد

اربط Nova
قناةً تلو الأخرى.

ما يحتاجه كل ربط، لك أو للمطوّر الذي يساعدك. ترشدك بوابة Nova في كل خطوة، فأبقِ هذه الصفحة مفتوحة إلى جانبها.

WhatsApp

اربط رقم WhatsApp الخاص بك عبر Meta.

افتح صفحة القنوات في بوابة Nova واتبع خطوات الربط مع Meta لحساب WhatsApp Business الخاص بك. يستقبل Nova الرسائل ويردّ عليها من هذا الرقم، مع إشعارات القراءة ومؤشر الكتابة.

الطريق المباشر

رقم WhatsApp الخاص بك.
Meta Cloud API.
مساعد Nova الخاص بك.

جهّز حساب WhatsApp Business الخاص بك. أذونات Meta جزء من عملية الربط.

Instagram

ردّ في الرسالة الخاصة التي أرسلوها على Instagram.

اربط حساب Instagram الاحترافي من صفحة القنوات في بوابة Nova ووافق على أذونات Meta. يردّ Nova على الرسائل الخاصة الواردة وفق تعليمات مساحة عملك وأدواتها، ويجدّد رموز الربط تلقائيًا.

المساعد نفسه، وصندوق رسائل آخر

أداة الطلبات التي تربطها لـ WhatsApp تستطيع أيضًا الرد على رسالة خاصة في Instagram.

محادثة الموقع

انسخ، الصق، وانتهى.
موقعك يردّ الآن.

أضف نطاق موقعك في البوابة، ثم انسخ رمز التضمين وضعه قبل وسم إغلاق body. يعرض Nova الردود أثناء كتابتها ويتذكّر الزائر عبر الصفحات في المتصفح نفسه.

يفصل الـ shadow DOM أنماط المحادثة عن أنماط موقعك. حدّد مظهرها من البوابة.

HTML / رمز التضمين الخاص بك
<script src="https://nova.kockatoos.co/widget.js" data-key="YOUR_WIDGET_KEY" async></script>

استبدل YOUR_WIDGET_KEY بالمفتاح العام لمساحة عملك. تعطيك البوابة هذا الوسم نفسه مع مفتاحك جاهزًا.

العملاء المسجّلون

اعرف أيّ عميل يتحدّث معك.

عندما يكون العميل مسجّل الدخول على موقعك، مرّر معرّفه إلى الأداة مع توقيع لا يستطيع إنشاءه إلا خادمك. عندها يعرف Nova مع من يتحدّث، ويحتفظ بسجلّ محادثاته على جميع أجهزته، وتستطيع أدوات MCP الخاصة بك البحث عن طلبات هذا العميل نفسه.

أنشئ مفتاح الهوية السرّي من صفحة التثبيت في البوابة. وقّع معرّف العميل كنصّ على خادمك باستخدام HMAC-SHA256 وهذا المفتاح، ثم مرّر الناتج بصيغة hex في userHash. يتجاهل Nova أيّ معرّف بلا توقيع صالح.

عيّن kockatoosSettings قبل سكربت الأداة، أو استدعِ kockatoosChat.identify() بعد تحميلها، واستدعِ logout() عندما يسجّل العميل خروجه. رمز وصول العميل اختياري ولا يُرسَل إلا إلى خادم MCP الخاص بك. لا تطبعه أبدًا داخل صفحة HTML قد تقدّمها ذاكرة التخزين المؤقت لزوّار آخرين.

اقرأ الدليل الكامل لأصحاب الأعمال والمطوّرين
JavaScript / identify
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 / Node / Shopify Liquid
// 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' }}
Flutter SDK

تطبيق Flutter الخاص بك يحصل على مساعد Nova نفسه.

أضف kockatoos_nova_ai_chatbot من مستودع الـ SDK. هيّئ Nova داخل main()، ثم ضع NovaFloatingButton() في الـ Scaffold. تدعم الحزمة Flutter للجوال و Flutter للويب.

سجّل معرّفات تطبيقك أو نطاق الويب في البوابة، واستبدل YOUR_API_KEY بالمفتاح العام لمساحة عملك.

اقرأ ملف README الخاص بـ Flutter SDK (يفتح في علامة تبويب جديدة)
Dart / main.dart
import 'package:flutter/material.dart';
import 'package:kockatoos_nova_ai_chatbot/kockatoos_nova_ai_chatbot.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Nova.initialize(config: const NovaConfig(apiKey: 'YOUR_API_KEY'));
  runApp(const MyApp());
}

// Then, in any Scaffold:
floatingActionButton: const NovaFloatingButton(),
أدواتك (MCP)

دع Nova يبحث في أنظمتك الخاصة.

يتصل Nova بأنظمتك عبر خادم MCP، أي Model Context Protocol، وهو معيار مفتوح لتزويد مساعدي الذكاء الاصطناعي بالأدوات. يبني مطوّرك خادمًا، أو يستخدم خادمًا جاهزًا، يتيح إجراءات محدّدة مثل البحث عن طلب أو التحقق من المخزون أو إيجاد حجز.

سجّل رابط الخادم وبيانات الدخول إليه ضمن خوادم MCP في بوابة Nova. يتعرّف Nova على أدواته ويستخدمها أثناء أي محادثة، على كل القنوات. وخادمك هو من يحدّد السجلات التي يمكن لكل أداة إرجاعها.

ما تسجّله

رابط الخادم.
بيانات الدخول إليه.
ولا شيء آخر لتثبيته.

تتضمن Nova Plus اتصال MCP واحدًا، وتوفّر Nova Partners حدودًا مرنة.

WhatsApp عبر Wati

احتفظ بـ Wati، وامنح Nova مكانًا في صندوق الرسائل.

أدخل رابط Wati API الخاص بك في بوابة Nova، ثم تبادل أمرين: الصق رابط الـ webhook من Nova في Custom AI Agent على Wati، ثم الصق رمز الوصول الخاص بهذا المساعد في Nova. لا حاجة لإعداد تطبيق Meta خاص بك.

أسند المحادثات إلى Nova في Wati. وعندما تسند محادثة إلى أحد أعضاء فريقك، يتنحّى Nova جانبًا.

بعد رابط الـ API

1 رابط الـ Webhook
Nova → Wati Custom AI Agent
2 رمز الوصول
Wati → Nova portal

متاح في Nova Partners. يتطلب باقة Wati Pro أو Business مع إضافة Connect AI Agents من Wati، ويحدّد Wati سعرها.

تجربة مجانية

جاهز للربط؟

7 أيام و$2 من استخدام الذكاء الاصطناعي مجانًا، بدون بطاقة. اربط قناتك الأولى وشاهد Nova يردّ على عملائك.

ابدأ التجربة المجانية