ابدأ الآن
واتساب

إعداد واتساب

من Meta Business إلى أول رسالة — خطوة بخطوة.

متطلبات
حساب Meta Business فعّال + شركة موثّقة + رقم WhatsApp غير مرتبط بحساب واتساب شخصي. تستغرق الموافقة من Meta من ساعات إلى أيام.
  1. أنشئ تطبيق Meta
    من developers.facebook.com → My Apps → Create App → نوع “Business”. أضف منتج WhatsApp Business.
  2. احصل على Phone Number ID
    في WhatsApp → API Setup ستجد الرقم الاختباري + Phone Number ID. للإنتاج: اربط رقمك الفعلي. انسخ الـ ID — هذا WHATSAPP_PHONE_ID.
  3. ولّد Access Token دائم
    الـ token المؤقت يصلح للاختبار فقط (24 ساعة). للإنتاج، أنشئ System User من Business Settings ثم ولّد token دائم له. هذا WHATSAPP_ACCESS_TOKEN.
  4. إعداد Webhook
    في WhatsApp → Configuration → Webhook، أضف:
    Callback URL: https://operix.operixdigital.com/webhook/whatsapp
Verify Token: operix-wa-verify-2026 (أو ما تختاره أنت)
    اشترك بحدث messages على الأقل.
  5. املأ متغيرات البيئة
    في backend/.env:
    WHATSAPP_API_VERSION=v21.0
WHATSAPP_PHONE_ID=123456789
WHATSAPP_ACCESS_TOKEN=EAA...
WHATSAPP_BUSINESS_ID=987654321
WHATSAPP_VERIFY_TOKEN=operix-wa-verify-2026
WHATSAPP_APP_SECRET=<من App Settings>
  6. أعد تشغيل Backend
    الـ webhook handler عند /webhook/whatsapp سيستقبل GET للتحقّق ثم POST للرسائل.
  7. جرّب من واتساب
    أرسل أي رسالة من هاتفك للرقم المسجّل. خلال ثوانٍ، يجب أن تظهر في/whatsapp كمحادثة جديدة.
نجح؟
اقرأ الآن أوضاع الـ AI لتفعيل الرد التلقائي على المحادثة.
لم ينجح؟
راجع حل المشاكل. أكثر الأخطاء شيوعاً: Verify Token غير مطابق، signature verification يرفض الطلب، أو الـ token منتهي.