إعداد واتساب API خطوة بخطوة: دليل التفعيل الكامل

هل تريد إعداد واتساب API لشركتك ولا تعرف من أين تبدأ؟ في هذا الدليل التفصيلي، سنشرح خطوات تفعيل واتساب API من الصفر حتى إرسال أول رسالة. طريقة ربط واتساب API أسهل مما تتخيل!

مع تفعيل واتساب بيزنس API عبر وصلة، يمكنك البدء خلال دقائق!

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

قبل البدء تحتاج:

☑️ المتطلبات الإلزامية:

رقم هاتف جديد (غير مستخدم في واتساب)
صفحة فيسبوك للأعمال
حساب Meta Business Manager
موقع إلكتروني أو متجر
سجل تجاري (موصى به)

لماذا كل متطلب؟

الخطوة 1: إنشاء حساب Meta Business

إنشاء الحساب

1. اذهب إلى: business.facebook.com
اضغط \"إنشاء حساب\"
أدخل:
• اسم النشاط التجاري
• اسمك الشخصي
• البريد الإلكتروني
أكد البريد الإلكتروني

إعداد معلومات الشركة

في إعدادات الحساب، أكمل:

📋 معلومات النشاط:
• الاسم القانوني
• العنوان
• رقم الهاتف
• الموقع الإلكتروني

📄 المستندات (للتحقق):
• السجل التجاري
• رخصة العمل
• فاتورة باسم الشركة

الخطوة 2: ربط صفحة فيسبوك

إنشاء صفحة (إذا لم تكن موجودة)

1. من Meta Business Manager
اضغط \"إضافة صفحة\"
اختر \"إنشاء صفحة جديدة\"
أدخل:
• اسم الصفحة
• الفئة
• الوصف
أضف صورة الملف والغلاف

ربط صفحة موجودة

1. من Meta Business Manager
اضغط \"إضافة صفحة\"
اختر \"المطالبة بصفحة\"
ابحث عن صفحتك
اطلب الوصول (إذا لم تكن المالك)

الخطوة 3: إنشاء تطبيق واتساب

من منصة المطورين

1. اذهب إلى: developers.facebook.com
سجل دخول بحساب فيسبوك
اضغط \"إنشاء تطبيق\"
اختر نوع \"Business\"
أدخل اسم التطبيق
اربط بـ Meta Business Manager

إضافة واتساب للتطبيق

1. في لوحة التطبيق
اضغط \"إضافة منتج\"
اختر \"WhatsApp\"
اضغط \"Set up\"
اقبل الشروط

الخطوة 4: إعداد رقم واتساب

تسجيل الرقم

📱 خطوات تسجيل الرقم:

في إعدادات واتساب
اضغط \"إضافة رقم هاتف\"
أدخل الرقم (مع رمز الدولة)
اختر طريقة التحقق:
• رسالة SMS
• مكالمة صوتية
أدخل الكود

إعداد الملف التعريفي

📋 معلومات الملف:

• اسم العرض (Display Name)
3-50 حرف
يجب أن يطابق اسم الشركة

• الوصف (About)
حتى 139 حرف

• فئة العمل


• صورة الملف
640x640 بكسل

الخطوة 5: الربط مع منصة وصلة

إنشاء حساب وصلة

1. اذهب إلى: app.wsla.io
اضغط \"إنشاء حساب\"
أدخل معلوماتك
اختر الباقة المناسبة

ربط واتساب API

في لوحة تحكم وصلة:

اذهب لـ \"الإعدادات\"
اختر \"ربط واتساب\"
انسخ Webhook URL
أدخل رقم الهاتف
أدخل Access Token
اضغط \"ربط\"

الحصول على Access Token

من Meta Business:

إعدادات التطبيق
واتساب → API Setup
انسخ \"Temporary Access Token\"
(أو أنشئ Permanent Token)

الخطوة 6: إعداد Webhook

ما هو Webhook؟

Webhook = رابط يستقبل الرسائل الواردة

عندما يرسل عميل رسالة:
واتساب → Webhook → وصلة → ترى الرسالة

إعداد الـ Webhook

1. في إعدادات واتساب بـ Meta
اضغط \"Configure Webhooks\"
أدخل:
• Callback URL: (من وصلة)
• Verify Token: (من وصلة)
اشترك في الأحداث:
☑️ messages
☑️ message_deliveries
☑️ message_reads

الخطوة 7: إنشاء قوالب الرسائل

لماذا القوالب؟

⚠️ قواعد واتساب:

• الرسائل للعملاء الجدد تحتاج قالب معتمد
• المحادثة مفتوحة 24 ساعة بعد رد العميل
• بدون قالب = لا يمكنك بدء المحادثة

إنشاء قالب

1. في Meta Business Manager
واتساب → Message Templates
اضغط \"Create Template\"
أدخل:
• الاسم (إنجليزي، بدون مسافات)
• الفئة (Marketing, Utility, Authentication)
• اللغة
• المحتوى

مثال:
الاسم: order_confirmation
الفئة: Utility
اللغة: Arabic
المحتوى:
\"مرحباً {{1}}!
تم استلام طلبك رقم {{2}}.
سنوافيك بالتحديثات قريباً 📦\"

انتظار الموافقة

⏱️ وقت الموافقة:

• عادة: دقائق إلى ساعات
• أحياناً: يوم أو يومين
• مرفوض: راجع السبب وأعد الإرسال

✅ نصائح للقبول:
• لا روابط مختصرة
• لا محتوى مضلل
• التزم بسياسات واتساب

الخطوة 8: إرسال أول رسالة

اختبار الإرسال

من وصلة:

اذهب لـ \"إرسال رسالة\"
أدخل رقم الاختبار (رقمك)
اختر القالب
أدخل المتغيرات
اضغط \"إرسال\"

التحقق من النجاح

✅ علامات النجاح:
• الرسالة ظهرت في واتساب
• حالة التسليم: مسلّمة
• لا أخطاء في السجل

❌ إذا فشل:
• راجع الـ Token
• تأكد من الـ Webhook
• تحقق من القالب

استكشاف الأخطاء

أخطاء شائعة وحلولها

الخطأ: Token منتهي
الحل: أنشئ Token جديد

الخطأ: رقم غير مسجل
الحل: تحقق من إعداد الرقم في Meta

الخطأ: قالب مرفوض
الحل: راجع المحتوى وأعد الإرسال

الخطأ: Webhook لا يستجيب
الحل: تأكد من URL والـ Token

مشاكل التحقق

❌ \"رقم مستخدم\"
→ الرقم مستخدم في واتساب عادي
→ الحل: احذف واتساب من الجهاز وانتظر 24 ساعة

❌ \"فشل التحقق\"
→ الكود خاطئ أو منتهي
→ الحل: اطلب كود جديد

❌ \"الرقم محظور\"
→ الرقم استُخدم بشكل مخالف سابقاً
→ الحل: استخدم رقم جديد

الخطوات القادمة

بعد التفعيل

☐ أنشئ قوالب إضافية
☐ أعد الشات بوت
☐ اربط مع متجرك (سلة/زد)
☐ درّب الفريق
☐ أرسل أول حملة

تحسين الأداء

☐ فعّل العلامة الخضراء
☐ زِد حد الرسائل
☐ أضف وسائط للقوالب
☐ حلل التقارير

الجدول الزمني المتوقع

📅 جدول التفعيل:

اليوم 1:
• إنشاء Meta Business (30 دقيقة)
• ربط صفحة فيسبوك (10 دقائق)

اليوم 2:
• إنشاء التطبيق (20 دقيقة)
• تسجيل الرقم (15 دقيقة)

اليوم 3:
• ربط وصلة (15 دقيقة)
• إنشاء القوالب (30 دقيقة)

اليوم 4-5:
• انتظار موافقة القوالب

اليوم 5+:
• البدء بالإرسال! 🎉

الأسئلة الشائعة

كم يستغرق التفعيل؟

3-5 أيام عادةً، معظمها انتظار موافقة القوالب.

هل يمكنني استخدام رقمي الحالي؟

لا، تحتاج رقم جديد غير مستخدم في واتساب.

ماذا لو رُفض القالب؟

راجع سبب الرفض، عدّل المحتوى، وأعد الإرسال.

هل أحتاج مبرمج؟

مع وصلة، لا! الواجهة سهلة ولا تحتاج برمجة.

ما تكلفة API؟

اشتراك وصلة + رسوم ميتا للرسائل. تفاصيل الأسعار.

ابدأ التفعيل الآن

جاهز لتفعيل واتساب API؟

سجل في وصلة

اتبع دليلنا التفصيلي

فريقنا يساعدك في كل خطوة!

ابدأ مجاناً - نفعّل حسابك خلال 24 ساعة!

---

مقالات ذات صلة:

• واتساب API: الدليل الشامل
• أسعار واتساب API
• قوالب رسائل واتساب
• كيف تحصل على العلامة الخضراء