كل ما تفعله لوحة التحكم تستطيع شيفرتك فعله أيضاً. تكشف واجهة الوكيل البرمجية نفس المحرّك الذي يرد على واتساب وإنستغرام — نفس قاعدة المعرفة، ونفس الذاكرة لكل عميل، ونفس أدوات التقويم والكتالوج — كواجهة REST تستدعيها من منتجك.

المرجع الكامل وإدارة المفاتيح في بوابة المطوّرين.

متى تحتاجها

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

إن كنت تريد وكيلاً على واتساب أو إنستغرام فقط، فلا تحتاج هذا — اربط القناة من التكاملات.

استدعاء واحد

أرسل رسالة ومُعرِّف مستخدم، فيعود إليك ردّ طُبِّقت عليه الذاكرة واستشهادات قاعدة المعرفة وإجراءات الأدوات.

curl https://api.waslo.io/v1/agent/reply \
  -H "Authorization: Bearer wsk_live_..." \
  -d '{
    "message": "Do you have a morning slot Thursday?",
    "userId": "customer_8842",
    "tools": ["calendar"]
  }'

الـuserId تختاره أنت، وهو ما يجعل الوكيل يتذكّر الشخص بين الاستدعاءات. أعِد استخدامه فتستمر المحادثة، وغيّره فتبدأ من جديد.

ماذا تغطي الواجهة أيضاً

المجال	ما تستطيع فعله
الردود	نص، ووسائط (صورة، صوت، فيديو، PDF)، وإخراج صوتي
التصنيف	تقييم رسالة ساخن / دافئ / بارد بشكل مستقل
الذاكرة	قراءة أو حذف ما يتذكّره الوكيل عن مستخدم
قاعدة المعرفة	رفع المستندات وعرضها وحذفها — مشتركة مع لوحة التحكم
الكتالوج	تحكم كامل بالمنتجات — مشترك مع لوحة التحكم
التقويم	ربط Google Calendar أو Cal.com دون فتح لوحة التحكم
الإعداد	ضبط التعليمات والسلوك لكل طلب أو بشكل دائم
الاستهلاك	الأرصدة المستهلكة والرصيد الحالي وسقف الإنفاق

كل ما ترفعه عبر الواجهة يظهر في لوحة التحكم، وكل ما تضيفه في اللوحة تراه الواجهة. مساحة عمل واحدة لا اثنتان.

مفاتيح الواجهة

تُنشأ المفاتيح في بوابة المطوّرين وتُعرض مرة واحدة — فهي مخزَّنة مُعمّاة ولا يمكننا استرجاعها لك. لكل مفتاح صلاحيات (agent, memory, kb, catalog, config, usage)، ولا يستطيع المفتاح إلا ما تسمح به صلاحياته. يمكنك الاحتفاظ بـ10 مفاتيح نشطة لكل مؤسسة، وإلغاء أي منها في أي وقت.

تعامل مع المفتاح كأنه كلمة مرور: على الخادم فقط، ولا تضعه أبداً في حزمة متصفح أو تطبيق جوال.

الأرصدة وحدود المعدل

تحاسب الواجهة بالأرصدة دائماً، على كل الخطط — فهي منتج منفصل عن اشتراك القنوات، واشتراك Growth لا يجعل استدعاءات الواجهة مجانية. الأسعار أعلى من ردود القنوات لأن كل استدعاء يحمل عملاً أكبر:

الحدث	الأرصدة
رد نصي	2
رد استخدم أداة	3
رد قرأ وسائط	5
إخراج صوتي	+2
تصنيف	1

تحدّد خطط المطوّرين حد المعدل وتمنح مخصصاً شهرياً من الأرصدة فوق ما تشتريه. وبلا خطة تعود إلى الحدود الافتراضية بالدقيقة وباليوم. تستطيع أيضاً ضبط سقف إنفاق شهري كي لا تستنزف حلقة شاردة رصيدك — تُرفض الطلبات بـspend_cap_reached عند بلوغه.

الأخطاء

كل خطأ يعود بنفس الغلاف، ومعه request_id يستحق ذكره إن راسلت الدعم.

الرمز	المعنى
400	جسم الطلب لم يجتز التحقق
401	مفتاح مفقود أو غير صالح
402	رصيد غير كافٍ، أو بلوغ سقف الإنفاق
403	صلاحيات المفتاح لا تغطي هذه النقطة
413	الحمولة أكبر من المسموح
429	تجاوز حد المعدل — أعد المحاولة بعد المدة في الترويسة

مرّر ترويسة Idempotency-Key مع الردود، فيعيد الاستدعاء المكرر خلال 24 ساعة الاستجابة الأصلية بدل أن يحاسبك مرتين.

مستخدمو واجهتك خارج صندوق المشغّل

المحادثات المنشأة عبر الواجهة تخصّ مستخدمي تطبيقك لا الشخص الذي يراقب صندوق Waslo — لذلك تُخفى افتراضياً عن شاشتَي العملاء والمحادثات. أضف ?includeApi=true حين تريد رؤيتها.

العلامة البيضاء

في خطة White-label يستطيع المفتاح الرئيسي إنشاء مساحات عمل معزولة لكل عميل، لكلٍّ مفتاحه وقاعدة معرفته وكتالوجه. الحساب الأب يدفع كل الاستهلاك ويحصل على عدّاد لكل مستأجر لإعادة الفوترة، والمستأجر لا يرى رصيد الأب إطلاقاً. والمستأجرون بلا وصول إلى لوحة التحكم بحكم التصميم — الواجهة هي سطحهم كاملاً، بما فيه ربط التقويم.

الخطوات التالية

بوابة المطوّرين — أنشئ مفتاحاً، واقرأ المرجع الكامل، واختر خطة
قاعدة المعرفة — ما يقرأه الوكيل قبل أن يجيب
كتالوج المنتجات — ما يستطيع البيع منه
لماذا هذا الرد — أثر التفكير خلف كل إجابة

واجهة الوكيل البرمجية