تكامل Clawdbot مع WhatsApp

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

يتيح لك تكامل Clawdbot مع WhatsApp توصيل مساعدك الشخصي بالذكاء الاصطناعي مباشرة بـ WhatsApp، منصة المراسلة الأكثر شعبية في العالم. يستخدم Clawdbot WhatsApp Web عبر Baileys، مع امتلاك Gateway للجلسة. يتيح لك ذلك أتمتة المحادثات وتلقي ردود ذكية وإدارة رسائل WhatsApp الخاصة بك من خلال الأتمتة المدعومة بالذكاء الاصطناعي.

لماذا تستخدم Clawdbot مع WhatsApp؟

يستخدم WhatsApp أكثر من 2 مليار شخص في جميع أنحاء العالم. من خلال دمج Clawdbot مع WhatsApp، يمكنك فتح قدرات الذكاء الاصطناعي القوية:

الإعداد السريع (للمبتدئين)

1. استخدم رقم هاتف منفصل إن أمكن (موصى به)
2. قم بتكوين WhatsApp في ~/.clawdbot/clawdbot.json
3. قم بتشغيل clawdbot channels login لمسح رمز QR (الأجهزة المرتبطة)
4. ابدأ تشغيل gateway

الحد الأدنى من التكوين:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

الحصول على رقم هاتف

يتطلب WhatsApp رقم هاتف محمول حقيقي للتحقق. عادةً ما يتم حظر أرقام VoIP والأرقام الافتراضية. هناك طريقتان مدعومتان لتشغيل Clawdbot على WhatsApp:

رقم مخصص (موصى به)

استخدم رقم هاتف منفصل لـ Clawdbot WhatsApp. يوفر هذا أفضل تجربة مستخدم مع توجيه نظيف وبدون غرائب الدردشة الذاتية.

الإعداد المثالي: هاتف Android احتياطي/قديم + eSIM. اتركه متصلاً بـ Wi-Fi والطاقة، وقم بربطه عبر QR.

نصيحة WhatsApp Business: يمكنك استخدام WhatsApp Business على نفس الجهاز برقم مختلف للحفاظ على WhatsApp الشخصي منفصلاً.

مثال على التكوين (رقم مخصص، قائمة سماح لمستخدم واحد):

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

الرقم الشخصي (بديل)

بديل سريع: قم بتشغيل Clawdbot على رقمك الخاص. أرسل رسالة لنفسك (WhatsApp "أرسل رسالة لنفسك") للاختبار.

مثال على التكوين (رقم شخصي، دردشة ذاتية):

{
  "whatsapp": {
    "selfChatMode": true,
    "dmPolicy": "allowlist",
    "allowFrom": ["+15551234567"]
  }
}

نصائح للحصول على الأرقام

• eSIM محلي من مشغل الهاتف المحمول في بلدك (الأكثر موثوقية)
• بطاقة SIM مدفوعة مسبقًا — رخيصة، تحتاج فقط إلى تلقي رسالة SMS واحدة للتحقق
• تجنب: TextNow، Google Voice، معظم خدمات "الرسائل القصيرة المجانية" — يحظر WhatsApp هذه الخدمات بقوة

نصيحة: يحتاج الرقم فقط إلى تلقي رسالة SMS واحدة للتحقق. بعد ذلك، تستمر جلسات WhatsApp Web عبر creds.json.

إعداد Clawdbot WhatsApp

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

قبل توصيل Clawdbot بـ WhatsApp، تأكد من أن لديك:

• Clawdbot مثبت على جهازك
• حساب WhatsApp برقم هاتف نشط
• Node.js 22 أو أعلى

الخطوة 1: تكوين قناة WhatsApp

أضف تكوين WhatsApp إلى ~/.clawdbot/clawdbot.json الخاص بك:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

الخطوة 2: تسجيل الدخول باستخدام رمز QR

قم بتشغيل أمر تسجيل الدخول إلى Clawdbot WhatsApp:

clawdbot channels login

افتح WhatsApp على هاتفك، انتقل إلى الإعدادات > الأجهزة المرتبطة > ربط جهاز، وامسح رمز QR المعروض بواسطة Clawdbot.

لتسجيل الدخول بحسابات متعددة:

clawdbot channels login --account <id>

الخطوة 3: بدء تشغيل Gateway

clawdbot gateway --port 18789

الخطوة 4: التحقق من الاتصال

تأكد من أن تكامل Clawdbot WhatsApp الخاص بك يعمل:

clawdbot channels status whatsapp

ميزات Clawdbot WhatsApp

معالجة الرسائل الذكية

يعالج Clawdbot WhatsApp الرسائل الواردة ويولد ردودًا سياقية. يفهم الذكاء الاصطناعي سجل المحادثة ويقدم إجابات ذات صلة. يرى النموذج سياقًا كافيًا لفهم الردود المقتبسة.

خيارات سياسة الرسائل المباشرة

دعم رسائل المجموعة

يدعم Clawdbot WhatsApp محادثات المجموعة. تستخدم الدردشات المباشرة الجلسة الرئيسية للوكيل؛ تظل المجموعات معزولة.

دعم الوسائط

يمكن لـ Clawdbot WhatsApp معالجة والرد على:

• الرسائل النصية
• الصور (مع الذكاء الاصطناعي للرؤية)
• الرسائل الصوتية (صوت PTT مع النسخ)
• المستندات
• رسائل الموقع

إيصالات القراءة

يمكن لـ Clawdbot WhatsApp إرسال إيصالات القراءة عند التكوين.

ردود الفعل التأكيدية

رد فعل تلقائي عند الاستلام لتأكيد استلام الرسالة.

تكوين Clawdbot WhatsApp

مثال على التكوين الكامل

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567", "+10987654321"],
      "configWrites": true,
      "selfChatMode": false
    }
  }
}

كتابات التكوين

بشكل افتراضي، يُسمح لـ WhatsApp بكتابة تحديثات التكوين التي يتم تشغيلها بواسطة /config set|unset. التعطيل باستخدام:

{
  "channels": {
    "whatsapp": {
      "configWrites": false
    }
  }
}

تخزين بيانات اعتماد Clawdbot WhatsApp

يخزن Clawdbot بيانات اعتماد WhatsApp بشكل آمن:

~/.clawdbot/credentials/whatsapp/<accountId>/creds.json

• نسخة احتياطية في creds.json.bak (يتم استعادتها عند التلف)
• التوافق القديم: كانت التثبيتات القديمة تخزن ملفات Baileys مباشرة في ~/.clawdbot/credentials/

تظل بيانات جلسة WhatsApp الخاصة بك على جهازك المحلي، مما يضمن الخصوصية.

استكشاف أخطاء Clawdbot WhatsApp وإصلاحها

فقدان الاتصال

إذا انقطع اتصال Clawdbot WhatsApp:

1. تحقق من اتصال الإنترنت
2. إعادة المصادقة: clawdbot channels login
3. مراجعة السجلات: cat /tmp/clawdbot/whatsapp.log

عدم إرسال الرسائل

إذا فشل Clawdbot WhatsApp في إرسال الرسائل:

1. التحقق من حالة الحساب: clawdbot channels status whatsapp
2. تحقق من تكوين قائمة السماح
3. تأكد من تشغيل gateway Clawdbot
4. مطلوب مستمع نشط للإرسال الصادر

انتهاء صلاحية رمز QR

إذا انتهت صلاحية رمز QR الخاص بـ Clawdbot WhatsApp:

clawdbot channels logout
clawdbot channels login

تسجيل الخروج

يحذف تسجيل الخروج حالة مصادقة WhatsApp (لكنه يحتفظ بـ oauth.json المشترك):

clawdbot channels logout
# أو لحساب محدد
clawdbot channels logout --account <id>

أفضل ممارسات Clawdbot WhatsApp

1. استخدم رقمًا مخصصًا: يوفر رقم هاتف منفصل أفضل تجربة
2. حدد حدودًا واضحة: قم بتكوين قوائم السماح للتحكم في وصول Clawdbot WhatsApp
3. راقب الاستخدام: راجع سجلات Clawdbot WhatsApp بانتظام
4. التحديث بانتظام: حافظ على تحديث Clawdbot للحصول على أحدث توافق مع WhatsApp
5. نسخ احتياطي لبيانات الاعتماد: قم بعمل نسخة احتياطية من بيانات اعتماد Clawdbot WhatsApp بشكل دوري

لماذا لا Twilio؟

أرقام WhatsApp Business غير مناسبة للمساعد الشخصي:

• تفرض Meta نافذة رد مدتها 24 ساعة
• يؤدي الاستخدام الكثيف إلى حظر قوي
• حسابات الأعمال ليست مخصصة لرسائل المساعد الشخصي

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

• تكامل Clawdbot مع Telegram - قم بتوصيل Clawdbot بـ Telegram
• تكامل Clawdbot مع Discord - قم بإعداد Clawdbot على Discord
• دليل إعداد Clawdbot - دليل التثبيت الكامل