واتساب — الذكاء الاصطناعي لأكثر تطبيق محادثة استخدامًا في العالم
WhatsApp — AI for the World's Most-Used Chat — easy-to-understand guide based on official docs
واتساب — الذكاء الاصطناعي لأكثر تطبيق محادثة استخدامًا في العالم
واتساب في كل مكان. أكثر من ملياري شخص يستخدمونه يوميًا، والآن يمكنك ربط Hermes به مباشرة. بدون حساب مطوّر من Meta. بدون توثيق تجاري. بدون إعدادات API معقدة. فقط امسح رمز QR وستتحدث مع وكيل الذكاء الاصطناعي الخاص بك من نفس التطبيق الذي تستخدمه لمراسلة أصدقائك.
كيف يعمل
يتصل Hermes بواتساب عبر جسر مدمج يعتمد على Baileys. اعتبره محاكاة لجلسة WhatsApp Web — بنفس الطريقة التي تربط بها متصفحًا بهاتفك. إنه ليس واجهة برمجة تطبيقات WhatsApp Business الرسمية، مما يعني أنك لا تحتاج إلى أي موافقات خاصة للبدء.
شغّل
hermes gateway setupواختر WhatsApp للحصول على إرشادات خطوة بخطوة.
طريقتان للاستخدام
| الوضع | كيف يعمل | الأنسب لـ |
|---|---|---|
| رقم بوت منفصل (موصى به) | خصّص رقم هاتف للبوت. يرسل الأشخاص رسائل إلى ذلك الرقم مباشرة. | تجربة مستخدم نظيفة، عدة مستخدمين، خطر حظر أقل |
| محادثة ذاتية شخصية | استخدم واتساب الخاص بك. تراسل نفسك للتحدث مع الوكيل. | إعداد سريع، مستخدم واحد، اختبار |
نهج رقم البوت المنفصل أنظف — وكيل الذكاء الاصطناعي له هويته الخاصة، ولا تخلط المحادثات الشخصية مع محادثات البوت. وضع المحادثة الذاتية مثالي لتجربة سريعة.
قبل أن تبدأ
ستحتاج إلى:
- Node.js v18+ و npm — جسر واتساب يعمل كعملية Node.js
- هاتف مثبت عليه واتساب (لمسح رمز QR)
الخبر الجيد: على عكس الجسور القديمة القائمة على المتصفح، لا تحتاج إلى تثبيت Chromium أو Puppeteer. الإعداد أخف بكثير.
الخطوة 1: تشغيل معالج الإعداد
hermes whatsapp
سيقوم المعالج بـ:
- سؤالك عن الوضع الذي تريده (bot أو self-chat)
- تثبيت تبعيات الجسر إذا لزم الأمر
- عرض رمز QR في الطرفية
- الانتظار حتى تقوم بمسحه
لمسح رمز QR:
- افتح واتساب على هاتفك
- انتقل إلى الإعدادات ← الأجهزة المرتبطة
- اضغط ربط جهاز
- وجّه الكاميرا نحو رمز QR في الطرفية
بمجرد الاقتران، يؤكد المعالج الاتصال وينتهي. يتم حفظ جلستك تلقائيًا.
نصيحة: إذا كان رمز QR يبدو مشوهًا، تأكد من أن عرض الطرفية لا يقل عن 60 عمودًا وتدعم Unicode. يمكنك أيضًا تجربة محاكي طرفية مختلف.
الخطوة 2: الحصول على رقم هاتف ثانٍ (وضع البوت)
لوضع البوت، تحتاج إلى رقم غير مسجل بالفعل في واتساب. إليك خياراتك:
| الخيار | التكلفة | ملاحظات |
|---|---|---|
| Google Voice | مجاني | الولايات المتحدة فقط. احصل على رقم من voice.google.com. تحقق من واتساب عبر SMS من خلال تطبيق Google Voice. |
| شريحة SIM مسبقة الدفع | 5–15 دولارًا دفعة واحدة | أي مشغّل. فعّل الشريحة، تحقق من واتساب، ثم يمكن أن تبقى الشريحة في الدرج. يجب أن يبقى الرقم نشطًا (قم بإجراء مكالمة كل 90 يومًا). |
| خدمات VoIP | مجاني–5 دولارات شهريًا | TextNow أو TextFree أو ما شابه ذلك. بعض أرقام VoIP محجوبة من واتساب — جرّب عدة أرقام إذا لم يعمل الأول. |
بعد الحصول على الرقم:
- ثبّت واتساب على هاتف (أو استخدم تطبيق WhatsApp Business مع شريحتين)
- سجّل الرقم الجديد في واتساب
- شغّل
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=* يسمح لجميع المرسلين. لاستخدام تدفق الاقتران بدلاً من ذلك، احذف المتغيرين واعتمد على نظام اقتران الرسائل المباشرة.
إعدادات سلوك اختيارية في ~/.hermes/config.yaml:
unauthorized_dm_behavior: pair
whatsapp:
unauthorized_dm_behavior: ignore
unauthorized_dm_behavior: pairهو الإعداد الافتراضي العام. المرسلون غير المعروفين في الرسائل المباشرة يحصلون على رمز اقتران.whatsapp.unauthorized_dm_behavior: ignoreيجعل واتساب يبقى صامتًا تجاه الرسائل المباشرة غير المصرح بها — عادةً الخيار الأفضل لرقم خاص.
ثم شغّل البوابة:
hermes gateway # في المقدمة
hermes gateway install # تثبيت كخدمة مستخدم
sudo hermes gateway install --system # لينكس فقط: خدمة نظام عند الإقلاع
تبدأ البوابة جسر واتساب تلقائيًا باستخدام الجلسة المحفوظة.
استمرار الجلسة
يحفظ جسر Baileys جلسته في ~/.hermes/platforms/whatsapp/session. هذا يعني:
- الجلسات تبقى بعد إعادة التشغيل — لا تحتاج إلى إعادة مسح رمز QR في كل مرة
- تتضمن بيانات الجلسة مفاتيح التشفير وبيانات اعتماد الجهاز
- لا تشارك أو ترفع مجلد الجلسة إلى نظام التحكم بالإصدارات — فهو يمنح وصولًا كاملاً إلى حساب واتساب
إعادة الاقتران
إذا انقطعت الجلسة (إعادة ضبط الهاتف، تحديث واتساب، إلغاء الربط يدويًا)، سترى أخطاء اتصال في سجلات البوابة. لإصلاح ذلك:
hermes whatsapp
سيقوم هذا بتوليد رمز QR جديد لإعادة الاقتران.
كلمة تحذير
واتساب لا يدعم رسميًا البوتات الخارجية خارج Business API. استخدام جسر خارجي يحمل خطرًا صغيرًا لقيود على الحساب. لتقليل المخاطر:
- استخدم رقم هاتف مخصصًا للبوت (وليس رقمك الشخصي)
- لا ترسل رسائل جماعية أو غير مرغوب فيها — حافظ على الاستخدام في إطار المحادثة
- لا تقم بأتمتة الرسائل الصادرة لأشخاص لم يراسلوك أولاً
أيضًا، يحدّث واتساب بروتوكول الويب الخاص به بشكل دوري، مما قد يكسر التوافق مؤقتًا مع الجسور الخارجية. عندما يحدث هذا، سيقوم Hermes بتحديث تبعية الجسر. إذا توقف البوت عن العمل بعد تحديث واتساب، اسحب أحدث إصدار من Hermes وأعد الاقتران.
تريد شيئًا أكثر رسمية؟
إذا كنت تدير بوتًا تجاريًا حقيقيًا وتريد الاستقرار، اطّلع على دليل WhatsApp Business Cloud API بدلاً من ذلك. إنه المسار الرسمي المدعوم من Meta: لا خطر حظر للحساب، لكن يتطلب حساب Meta Business وعنوان webhook عام. يمكن أيضًا تشغيل المحولين بالتوازي على أرقام هواتف مختلفة إذا كان لديك سبب لذلك.
معظم المشاريع الشخصية والتجارب، مع ذلك، جسر Baileys هو أسرع طريقة لإدخال الذكاء الاصطناعي إلى واتساب الخاص بك. امسح، هيّئ، وابدأ المحادثة.
📖 التوثيق الرسمي
この記事は Hermes Agent のالتوثيق الرسميに基づいています:التوثيق الرسمي › user-guide/messaging/whatsapp