ما الجديد في إعداد واتساب في Hermes

إذا كنت تتابع سلسلة مقالاتنا عن Hermes Agent، فأنت تعلم أننا نحب تبسيط الأمور. اليوم، سنغوص في الإعداد المحدّث لواتساب — وهناك تغيير كبير تحت الغطاء.

أصبح Hermes يتصل بواتساب الآن عبر جسر مدمج مبني على Baileys. اعتبره محاكاة لجلسة واتساب ويب. لا حساب مطوّر من Meta، لا تحقق تجاري، لا رابط عام — فقط أنت وهاتفك ورمز QR.

بداية سريعة: شغّل hermes gateway setup واختر WhatsApp للحصول على دليل خطوة بخطوة.

تكاملان مع واتساب — اعرف الفرق

قبل أن نتعمق أكثر، دعنا نوضح نقطة الالتباس الشائعة. هناك طريقتان لربط واتساب بـ Hermes:

التكامل	الأنسب لـ	يتطلب
جسر Baileys (هذا الدليل)	بوتات شخصية، اختبار سريع، بدون رابط عام	هاتف به واتساب فقط
واجهة برمجة تطبيقات واتساب للأعمال السحابية	بوتات أعمال حقيقية، استقرار، صفر خطر حظر	حساب Meta للأعمال، رابط webhook عام

جسر Baileys غير رسمي — يحمل خطر حظر بسيط. أما واجهة برمجة تطبيقات الأعمال السحابية فهي المسار الرسمي المدعوم من Meta. يمكنك حتى تشغيل كليهما بالتوازي على أرقام هواتف مختلفة إذا احتجت ذلك.

⚠️ تحذيران مهمان

خطر الحظر: واتساب لا يدعم رسميًا بوتات الطرف الثالث خارج واجهة برمجة تطبيقات الأعمال. لتبقى آمنًا:

استخدم رقم هاتف مخصص للبوت (وليس رقمك الشخصي)
لا ترسل رسائل جماعية أو مزعجة — اجعل المحادثات طبيعية
لا تُشغّل رسائل صادرة تلقائية لأشخاص لم يراسلوك أولاً

تحديثات البروتوكول: واتساب يحدّث بروتوكول الويب الخاص به دوريًا، مما قد يكسر جسور الطرف الثالث مؤقتًا. إذا توقف بوتك عن العمل بعد تحديث واتساب، فقط اسحب أحدث إصدار من Hermes وأعد الاقتران.

وضعان — اختر أسلوبك

الوضع	كيف يعمل	الأنسب لـ
رقم بوت منفصل (موصى به)	خصّص رقمًا للبوت؛ يراسله الناس مباشرة	تجربة مستخدم نظيفة، عدة مستخدمين، خطر حظر أقل
محادثة ذاتية شخصية	استخدم واتساب الخاص بك؛ راسل نفسك للتحدث مع الوكيل	إعداد سريع، مستخدم واحد، اختبار

المتطلبات الأساسية

Node.js v18+ و npm — الجسر يعمل كعملية Node.js
هاتف مثبّت عليه واتساب (لمسح رمز QR)

خبر جيد: جسر Baileys الحالي لا يتطلب Chromium أو Puppeteer بعد الآن. أخف بكثير.

الخطوة 1: تشغيل معالج الإعداد

hermes whatsapp

سيقوم المعالج بـ:

سؤالك عن الوضع الذي تريده (bot أو self-chat)
تثبيت تبعيات الجسر إذا لزم الأمر
عرض رمز QR في الطرفية
الانتظار حتى تقوم بمسحه

لمسح رمز QR:

افتح واتساب على هاتفك
انتقل إلى الإعدادات ← الأجهزة المرتبطة
اضغط ربط جهاز
وجّه كاميرتك نحو رمز QR في الطرفية

بمجرد الاقتران، يؤكد المعالج الاتصال ويخرج. يتم حفظ جلستك تلقائيًا.

نصيحة: إذا ظهر رمز QR مشوّهًا، تأكد من أن عرض الطرفية لا يقل عن 60 عمودًا وتدعم Unicode.

الخطوة 2: الحصول على رقم هاتف ثانٍ (وضع البوت)

لوضع البوت، تحتاج رقمًا غير مسجّل بالفعل في واتساب. ثلاثة خيارات:

الخيار	التكلفة	ملاحظات
Google Voice	مجاني	الولايات المتحدة فقط. تحقق من واتساب عبر SMS من خلال تطبيق Google Voice.
شريحة SIM مسبقة الدفع	5–15 دولارًا دفعة واحدة	فعّلها، تحقق، ثم يمكن للشريحة أن تبقى في الدرج. أجرِ مكالمة كل 90 يومًا لإبقائها نشطة.
خدمات VoIP	مجاني–5 دولارات/شهر	TextNow، TextFree، وغيرها. بعض الأرقام محجوبة من واتساب — جرّب عدة أرقام.

بعد الحصول على الرقم:

ثبّت واتساب على هاتف (أو استخدم تطبيق واتساب للأعمال مع شريحتين)
سجّل الرقم الجديد
شغّل hermes whatsapp وامسح رمز QR من ذلك الحساب

الخطوة 3: إعداد Hermes

أضف هذا إلى ملف ~/.hermes/.env:

# مطلوب
WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot                          # "bot" أو "self-chat"

# التحكم في الوصول — اختر واحدًا:
WHATSAPP_ALLOWED_USERS=15551234567         # أرقام مفصولة بفواصل (رمز الدولة، بدون +)
# WHATSAPP_ALLOWED_USERS=*                 # أو اسمح للجميع
# WHATSAPP_ALLOW_ALL_USERS=true            # أو فعّل هذا الخيار (مثل *)

اختصار السماح للجميع: تعيين WHATSAPP_ALLOWED_USERS=* يسمح لجميع المرسلين — أي ما يعادل WHATSAPP_ALLOW_ALL_USERS=true. لاستخدام تدفق الاقتران بدلاً من ذلك، أزل كلا المتغيرين واعتمد على نظام اقتران الرسائل المباشرة.

إعدادات اختيارية في ~/.hermes/config.yaml:

unauthorized_dm_behavior: pair

whatsapp:
  unauthorized_dm_behavior: ignore

pair (الافتراضي العام) يرسل رمز اقتران لمرسلي الرسائل المباشرة غير المعروفين.
ignore يُبقي واتساب صامتًا تجاه الرسائل المباشرة غير المصرح بها — عادةً أفضل لرقم خاص.

ثم شغّل البوابة:

hermes gateway              # في المقدمة
hermes gateway install      # تثبيت كخدمة مستخدم
sudo hermes gateway install --system   # لينكس: خدمة نظام عند الإقلاع

استمرار الجلسة وإعادة الاقتران

يحفظ الجسر جلسته تحت ~/.hermes/platforms/whatsapp/session. وهذا يعني:

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

إذا انكسرت الجلسة (إعادة ضبط الهاتف، تحديث واتساب، إلغاء ربط يدوي)، سترى أخطاء اتصال في السجلات. أصلحها بتشغيل:

hermes whatsapp

هذا يولّد رمز QR جديدًا لإعادة الاقتران.

هذا هو إعداد واتساب الجديد باختصار. سريع، خفيف، وبدون أوراق Meta. التالي في السلسلة: سنقارن هذا الجسر جنبًا إلى جنب مع واجهة برمجة تطبيقات واتساب للأعمال السحابية — ترقبوا!