AskAIs
ابدأ الآن
تصفّح الوثائقنظرة عامة على التكامل
البدء

نظرة عامة على التكامل

طرق ربط AskAIs المتاحة اليوم: موقعك الإلكتروني، وتطبيقك، وTelegram، وعملاء الذكاء الاصطناعي.

الأسماء التقنية مثل window.SingChat جزء من الأداة وواجهة API. انسخها في الكود كما هي تمامًا.

AskAIs خدمة مُستضافة: مساحة عملك وصندوق الوارد ووكيل الذكاء الاصطناعي وقاعدة المعرفة كلها موجودة على askais.com. تربط عملاءك بها بالطرق الموضّحة أدناه، وتصل كل محادثة إلى صندوق الوارد المشترك نفسه، حيث يجيب عنها وكيل الذكاء الاصطناعي نفسه بالمعرفة والإعدادات نفسها.

طرق الربط

أينطريقة الربطالتحديثات
موقعك الإلكترونيوسم <script> واحدلا حاجة إليها: كل تحميل للصفحة يجلب النسخة الحالية من أداة الدردشة
تطبيقك على iOS أو Android أو Flutter أو React Native أو سطح المكتبWebView يفتح صفحة الدردشة الخاصة بكلا حاجة إليها: يحمّل WebView النسخة الحالية من أداة الدردشة
Telegramرمز البوت (token) في الإعدادات → Channelsلا حاجة إليها
Claude Code أو Cursor أو Gemini CLI (لفريقك)خادم MCP مع مفتاح MCPلا حاجة إليها

موقعك الإلكتروني

أضف هذا قبل </body>. انسخ App ID من الإعدادات → صناديق الوارد؛ فهو عام ويمكن نشره بأمان.

<script src="https://askais.com/widget.js"
  data-app-id="YOUR_APP_ID"
  data-base-url="https://askais.com"
  async></script>

⚠️ حمّل widget.js من askais.com

لا تنزّل widget.js ولا تدمجه في شيفرتك. عند تحميله من askais.com يعمل دائمًا بأحدث إصدار؛ أما النسخة المحلية فتبقى جامدة وتفوتها كل الإصلاحات والميزات الجديدة.

تطبيقات الجوال وسطح المكتب

لا توجد حزمة SDK لتثبيتها. افتح https://askais.com/api/widget-embed?appId=YOUR_APP_ID في WebView، فيعرض تطبيقك الدردشة نفسها الموجودة على موقعك، بملء الشاشة. أضف إلى الرابط معرّف المستخدم الذي سجّل الدخول وبريده الإلكتروني واسمه، ليعرف فريقك مع من يتحدث. تجد الدليل الكامل في صفحة «الدردشة داخل التطبيق»، مع شيفرات لـ Flutter وiOS وAndroid وJavaScript.

الزوار الذين سجّلوا الدخول والهوية الموثّقة

للمستخدمين الذين سجّلوا الدخول، مرّر externalId وemail وname لتنتقل محادثاتهم معهم عبر الأجهزة. ولمنع أي شخص من انتحال صفة مستخدم آخر، مرّر أيضًا hmac: وهو HMAC-SHA256 لقيمة externalId، يُحسب على خادمك ومفتاحه هو المفتاح السري لصندوق الوارد. تشرح صفحة «أداة الدردشة على الويب» كيفية ذلك.

Telegram

أنشئ بوتًا عبر @BotFather، والصق رمزه (token) في الإعدادات → Channels، ثم اربطه. تصل الرسائل المرسلة إلى البوت إلى صندوق الوارد نفسه، حيث يرد عليها وكيل الذكاء الاصطناعي وفريقك.

عملاء الذكاء الاصطناعي (MCP)

يتيح خادم MCP لـ Claude Code أو Cursor أو Gemini CLI العمل على مساحة عملك: قراءة المحادثات والرد عليها، وتدريب الذكاء الاصطناعي، وتعديل الأسئلة الشائعة، والاطلاع على التحليلات. وهو مخصّص لك ولفريقك، لا لعملائك. ينشئ مفتاحَ MCP مالكُ مساحة العمل أو أحد مشرفيها.

غير متاح حاليًا

  • حزم SDK قابلة للتثبيت (npm وpub.dev وCocoaPods وGradle). استخدم وسم السكربت على الويب، وصفحة WebView في التطبيقات.
  • واجهة REST API عامة لخادمك الخلفي. لا يقبل مفاتيح API إلا خادم MCP.
  • Webhooks لأحداث المحادثات أو الرسائل. يمكن في الإعدادات → Webhooks حفظ نقطة نهاية (endpoint) وإرسال طلب اختبار (ping) موقّع، لكن لا تُرسَل أي أحداث حتى الآن.
  • دوال JavaScript لفتح أداة الدردشة أو إغلاقها أو الاستماع إلى أحداثها. window.SingChat.start() هي الدالة الوحيدة التي يوفّرها السكربت.

للتعمّق أكثر

السابقبداية سريعةالتاليخادم MCP (وكلاء الذكاء الاصطناعي)