الانتقال إلى المحتوى الرئيسي

​
بلا API، فقط رمز QR

تربط قناة WhatsApp تطبيق وولف فيش بحسابك على WhatsApp عبر بروتوكول الويب. لا حاجة لواجهة برمجية رسمية، ولا لحساب أعمال — فقط امسح رمز QR وسيكون مساعدك الذكي الشخصي متاحًا في WhatsApp.

​
الإعداد

في وولف فيش، افتح الإعدادات > WhatsApp وفعّل القناة. سيظهر رمز QR.
يتصل وولف فيش كجهاز مرتبط باستخدام بروتوكول WhatsApp متعدد الأجهزة. لا يحتاج هاتفك أن يبقى متصلًا بالإنترنت بعد الربط الأولي.

​
مسار الاتصال

QR displayed → Phone scans → Multi-device auth → Session keys stored → Persistent connection
تُخزّن مفاتيح الجلسة محليًا في مساحة العمل. طالما لم تفصل الجهاز من إعدادات WhatsApp، يستمر الاتصال بشكل دائم.

​
الأوامر

نفس أوامر الشرطة المائلة المتاحة في Telegram تعمل في WhatsApp:
الأمرالإجراء
/stopإلغاء المهمة الجارية حاليًا
/newبدء محادثة جديدة
/resumeمتابعة المحادثة السابقة
/deleteحذف المحادثة الحالية
/currentعرض المحادثة النشطة
/statusتقرير النظام (النموذج، استخدام الذاكرة، وقت التشغيل)
/localالتبديل إلى النموذج المحلي (Ollama)
/cloudالتبديل إلى النموذج السحابي (Claude/OpenAI)
أرسل أي أمر كرسالة WhatsApp عادية — لا حاجة لتنسيق خاص.

​
آلية الموافقة

عندما تُصنّف الـ amygdala استدعاء أداة، يستخدم WhatsApp رسائل نصية لأن الأزرار المضمّنة غير متوفرة: 
[Approval Required]

Wolffish wants to execute:
  shell_exec: npm install express

Reply "approve" to proceed or "deny" to abort.
يتوقف الدور حتى ترد. الردود لا تتأثر بحالة الأحرف — approve وApprove وAPPROVE وyes وy جميعها تعمل.
بخلاف أزرار Telegram المضمّنة، موافقات WhatsApp هي رسائل نصية عادية. تتعرّف القناة على كلمات الموافقة أو الرفض فقط عندما يكون هناك طلب موافقة معلّق.

​
إعادة الاتصال

إذا انقطع اتصال WebSocket (تغيير الشبكة، سكون/استيقاظ، إعادة تشغيل الخادم)، يعيد وولف فيش الاتصال تلقائيًا مع تأخير تصاعدي:
المحاولةالتأخير
1ثانيتان
24 ثوانٍ
38 ثوانٍ
416 ثانية
5-1230 ثانية (الحد الأقصى)
بعد 12 محاولة فاشلة، يتوقف وولف فيش عن المحاولة ويُعلّم القناة كمنفصلة. يمكنك إعادة الاتصال يدويًا من الإعدادات أو الانتظار حتى إعادة تشغيل التطبيق التالية.
عمليًا، تنجح إعادة الاتصال من المحاولة الأولى أو الثانية لمشاكل الشبكة العابرة. تسلسل المحاولات الكامل (12 محاولة) لا يُستنفد إلا إذا أُلغيت الجلسة من هاتفك.

​
معالجة الرسائل القديمة

تُتجاهل الرسائل الأقدم من 3 ساعات افتراضيًا. هذا يمنع وولف فيش من معالجة تراكم الرسائل التي وصلت أثناء عدم اتصاله — فتلك الرسائل غالبًا لم تعد تحتاج ردًا. يمكن تعديل هذا الحد في config.json: 
{
  "channels": {
    "whatsapp": {
      "staleMessageThresholdMs": 10800000
    }
  }
}
اضبطه على 0 لتعطيل فلتر الرسائل القديمة ومعالجة كل شيء بغض النظر عن عمره.

​
الرسائل الصوتية

تُحوّل الرسائل الصوتية المرسلة في WhatsApp إلى نص عبر تقنية تحويل الكلام إلى نص (STT) في وولف فيش وتُعالج كمدخل نصي عادي. يحدث التحويل محليًا قبل دخول الرسالة إلى خط معالجة الذكاء.

​
معالجة حالة الانشغال

إذا كان هناك دور يعمل عند وصول رسالة WhatsApp جديدة، يرسل وولف فيش إشعارًا مختصرًا: 
I'm working on something right now. Your message is queued
and I'll get to it when I'm done.
تدخل الرسالة قائمة انتظار TurnRunner وتُعالج بالترتيب عند اكتمال الدور الحالي.

​
نتائج المهام المفصّلة

افتراضيًا يستقبل WhatsApp تغذية نظيفة — ردود الوكيل، وأي ملفات أو صوت يُنتجه، والأخطاء. أما خطوات الأدوات الروتينية فتبقى في واجهة سطح المكتب. بدّل ذلك من الإعدادات → القنوات → WhatsApp → نتائج المهام المفصّلة:
  • إيقاف (الافتراضي) — رسائل الوكيل والنتائج الحاملة للملفات والأخطاء فقط.
  • تشغيل — يُعاد بثّ كل استدعاء أداة وكل نتيجة وكل نشاط إلى المحادثة.
لا يغيّر الوضع المفصّل سوى ما يُرسَل إلى WhatsApp. أما الدور كاملًا فيُحفظ في السجل والذاكرة بغضّ النظر عن الإعداد.

​
ربط المحادثات

كل معرّف JID في WhatsApp (معرّف رقم الهاتف) يرتبط بمحادثة في وولف فيش. عمليًا:
  • الرسائل التي ترسلها لنفسك (عبر “راسل نفسك” في WhatsApp) تنشئ محادثة واحدة
  • إذا هيّأت وولف فيش للرد على جهة اتصال محددة، يحصل معرّف JID الخاص بها على محادثة منفصلة
المحادثات مشتركة بين القنوات — يمكنك البدء في WhatsApp والمتابعة في واجهة Electron أو Telegram.

​
التفاصيل التقنية

تستخدم قناة WhatsApp مكتبة Baileys، وهي تنفيذ مفتوح المصدر بلغة TypeScript لبروتوكول WhatsApp Web. تتولى Baileys:
  • توليد رمز QR والمصادقة متعددة الأجهزة
  • إدارة اتصال WebSocket
  • تشفير/فك تشفير الرسائل (بروتوكول Signal)
  • تنزيل ورفع الوسائط
  • مؤشرات الحضور والكتابة
Baileys هي مكتبة خارجية تقوم بهندسة عكسية لبروتوكول WhatsApp Web. رغم استخدامها الواسع واستقرارها، إلا أنها غير مدعومة رسميًا من Meta. قد تتطلب تغييرات بروتوكول WhatsApp أحيانًا تحديثات للمكتبة.