واتسآب API السحابي

مطلوب إجراء: حدّث عنوان URL للـWebhook الخاص بك قبل 5 أغسطس 2026

سيتم نقل عنوان URL للـWebhook الخاص بك من app.respond.io إلى webhook.respond.io. حدّث قناة WhatsApp Cloud API قبل 5 أغسطس 2026 وإلا سيتوقف تسليم الرسائل الواردة.

كيفية التحديث
1. في respond.io، انتقل إلى إعدادات القناة > التكوين وانسخ عنوان URL الجديد للـWebhook.
2. ألصق عنوان URL الجديد في حقل Callback URL في لوحة معلومات تطبيق Meta.

هل تحتاج إلى مساعدة؟ اتصل بالدعم.

يمكنك الآن ترحيل حساب WhatsApp 360dialog المتصل بك إلى Response.io WhatsApp Business API للاستمتاع بموثوقية أعلى وتكاليف أقل والوصول إلى ميزات جديدة. تعرف على المزيد حول عملية الترحيل هنا.

للاتصال بـ WhatsApp Cloud API، يلزم وجود تطبيق Facebook مع تمكين منتج WhatsApp. اقرأ هذا الدليل حول كيفية إعداد تطبيق Facebook الخاص بك.

أعلنت شركة Facebook عن إصدار WhatsApp Cloud API في 20 مايو، وهي متاحة لأي شركة مهما كان حجمها، كبيرة كانت أم صغيرة، للتواصل مع العملاء باستخدام واجهة برمجة تطبيقات WhatsApp الرسمية.

تتمتع هذه القناة بفترة مراسلة محدودة لمدة 24 ساعة بسبب لوائح WhatsApp. تعرف على المزيد حول سياسة أعمال WhatsApp هنا.

ربط WhatsApp Cloud API

شاهد الفيديو أدناه للحصول على دليل خطوة بخطوة حول كيفية ربط WhatsApp Cloud API بـ response.io.

للدردشة مع عملائك عبر WhatsApp Cloud API، قم بربط ملف تعريف WhatsApp Business وحساب Meta Business.

يجب أن يكون لديك تطبيق Facebook وحساب Meta Business ويجب أن تكون مسؤولاً عن كليهما للاتصال.

الخطوة 1: انتقل إلى إعدادات مساحه عمل > انقر على إضافة قناة

الخطوة 2: حدد موقع قناة WhatsApp Cloud API > انقر فوق الاتصال.

الخطوة 3: انقر فوق الزر الاتصال بفيسبوك.

الخطوة 4: قم بتسجيل الدخول باستخدام حساب Facebook مع إمكانية الوصول إلى حساب Meta التجاري وتطبيق Facebook.

الخطوة 5: في القائمة المنسدلة، حدد اسم WABA مع رقم WhatsApp الذي ترغب في الاتصال به.

الخطوة 6: أضف عنوان URL للاتصال العكسي. ارجع إلى قسم WhatsApp في تطبيق Facebook Developer. انتقل إلى القسم الفرعي Configuration وقم بإعداد عنوان URL للاتصال الراجع. أضف عنوان URL للاتصال الراجع الناتج وتحقق من الرمز من response.io في الحقول المقابلة في مربع حوار webhook.

الخطوة 7: على تطبيق Facebook، تحقق من التغييرات التي أجريتها على التطبيق واحفظها.

الخطوة 8: الاشتراك في حدث webhook. في تطبيق Facebook الخاص بك، حدد علامة التبويب Webhooks ضمن لوحة Products وحدد WhatsApp Business Account في القائمة المنسدلة. انقر فوق الاشتراك في رسائل الحدث.

الخطوة 9: انقر فوق التبديل في أعلى الصفحة لتشغيل الوضع المباشر.

تذكر أن تقوم بملء عنوان URL لسياسة الخصوصية الخاصة بك. إذا كان هذا فارغًا، فلن يُسمح لك بتشغيل الوضع المباشر.

الخطوة 10: انقر فوق حفظ التغييرات لإكمال الإعداد.

بعد إكمال الإعداد، سيتم الآن استلام أي رسائل مرسلة إلى رقم WhatsApp الخاص بك في مساحة العمل الخاصة بك.

تكوين القناة

يمكن تكوين قناة WhatsApp Cloud API باستخدام اسم قناة فريد.

الخطوة 1: انتقل إلى إعدادات مساحه عمل > انقر على القنوات.

الخطوة 2: حدد موقع قناة WhatsApp Cloud API > انقر فوق إدارة.

الخطوة 3: قم بتكوين اسم القناة الذي يُستخدم داخليًا لتحديد الحساب.

الخطوة 4: انقر على حفظ التغييرات لتحديث تكوين القناة.

البيانات الوصفية التي تلقتها القناة

توفر القنوات المختلفة مجموعات مختلفة من بيانات التعريف الخاصة بجهة الاتصال لمنصة response.io. فيما يلي قائمة بيانات جهة الاتصال التي ستتمكن من الحصول عليها من هذه القناة:

• رقم التليفون

• معرف رقم الهاتف

• اسم الملف الشخصي

• معرف واتساب

• معرّف المستخدم على مستوى الأعمال (BSUID)

• BSUID

إدارة ملف تعريف WhatsApp Cloud API

إذا كانت هناك حاجة لإجراء تغيير أو التحقق من ملف تعريف WhatsApp Cloud API الخاص بك، فيمكن القيام بذلك على منصة respond.io.

الخطوة 1: انتقل إلى إعدادات مساحة العمل > انقر فوق القنوات.

الخطوة 2: حدد موقع قناة WhatsApp Cloud API > انقر فوق إدارة > الملف الشخصي.

الخطوة 3: انقر فوق مزامنة الملف الشخصي للحصول على أحدث معلومات ملف تعريف WhatsApp Business من WhatsApp.

الخطوة 4: قم بتعديل المعلومات التالية حسب الحاجة.

الخطوة 5: راجع المعلومات وانقر فوق حفظ التغييرات.

إدارة قوالب رسائل WhatsApp

قبل إرسال قالب رسالة إلى جهة اتصال على منصة respond.io، تأكد من قيامك بما يلي:

- تم إرسال قالب الرسالة للموافقة عليه - تمت إضافة قالب الرسالة المعتمد إلى مساحه العمل عن طريق مزامنة قالب الرسالة

إرسال قوالب الرسائل

الخطوة 1: انتقل إلى إعدادات مساحه العمل > انقر فوق القنوات.

الخطوة 2: حدد موقع قناة WhatsApp Cloud API > انقر فوق إدارة.

الخطوة 3: انقر فوق القوالب > إرسال القالب لإرسال قالب رسالة للموافقة عليه.

الخطوة 4: املأ المعلومات المطلوبة اللازمة لإنشاء قالب.

الخطوة 5: قم بإنشاء الرسالة بملء المكونات الضرورية، ثم راجع الرسالة في قسم المعاينة. يمكنك تضمين المعلمات {{1}}، {{2}}، إلخ كعناصر نائبة ليتم ملؤها بمحتوى مخصّص

الخطوة 6: تقديم قيمة العينة

ينطبق هذا فقط إذا قمت بتضمين أي معلمات في محتوى قالب الرسالة الخاص بك

توفير قيم عينة للمعلمات في قالب الرسالة سيساعد مراجع WhatsApp على فهم الرسالة التي تحاول إرسالها إلى جهات الاتصال الخاصة بك

رابط مهم:إرشادات قالب رسالة WhatsApp

مزامنة قوالب الرسائل

الخطوة 1: انتقل إلى إعدادات مساحه العمل > انقر فوق القنوات.

الخطوة 2: حدد موقع قناة منصة واتساب للأعمال (API) > انقر فوق إدارة.

الخطوة 3: انقر فوق القوالب > مزامنة القالب لبدء عملية المزامنة.

تمت عملية المزامنة بالكامل. هذا يعني:
- ستُدرج قوالب الرسائل مع حالاتها المقابلة.
- سيتم تحديث تاريخ ووقت آخر مزامنة.
- إذا تم رفض قالبك، سيتم عرض سبب الرفض أسفل قالب الرسالة المرفوض.

يوضح الجدول التالي الحالات المحتملة لقوالب الرسائل:

استخدم البحث والتصفية في الزاوية اليمنى العليا من القائمة للعثور على قوالبك بسهولة!

أنواع الملفات المدعومة

أنواع الملفات التي يدعمها واتساب والحد الأقصى لحجم الملف لكل نوع هي كما يلي:

• صوت وفيديو (16MB)

• مستند (100 MB)

• صورة (5 MB)

• ملصق (100 KB)

ستظهر الرسائل غير المدعومة بعرض احتياطي يتضمن نص "رسالة غير مدعومة" أو "حمولة مخصصة" والنوع (إذا كان متوفرًا) بالنسبة لأي نوع ملف غير مدعوم أو ملف يتجاوز الحد الأقصى لحجم الملف المرسل عبر WhatsApp Cloud API، سيتم تحويل الملف تلقائيًا إلى رابط URL على منصة respond.io. بالنسبة للحمولة المخصصة، يمكنك النقر فوق عرض المزيد لعرض حمولة JSON لهذه الرسالة. أمثلة على الرسائل غير المدعومة لـ WhatsApp Cloud API هي:
- ردود الفعل
- الرسالة المحذوفة
- استطلاعات الرأي
- الرسالة المؤقتة

حدود المعدلات

حد المعدل هو عدد مكالمات API التي يمكن أن يجريها تطبيق أو مستخدم ضمن فترة زمنية معينة تحددها القناة. تعرف على المزيد حول حدود المعدل لهذه القناة هنا.

الأسئلة المتكررة وحل المشكلات

غير قادر على إرسال الرسائل

تأكد من أن الرقم الذي قمت بتوصيله بالمنصة هو رقم WhatsApp Cloud API.

الرسائل لا تصل

يمكن أن يحدث هذا عندما لا يتم الاشتراك في Webhook الخاص بالرسائل.

الخطوة 1: انتقل إلى صفحة Facebook App Webhook

افتح تطبيق Facebook وانتقل إلى صفحة Webhooks.

الخطوة 2: تحقق من الحدث المشترك

حدد حساب أعمال WhatsApp وتحقق مما إذا كان الحدث الرسائل مشتركًا.

الخطوة 3: إرسال رسالة اختبار

أرسل رسالة اختبار إلى رقم هاتف WhatsApp وتحقق من وصولها

غير قادر على تلقي إيصالات القراءة

عند قيام المستخدم المتصل بـ WhatsApp Cloud API بتغيير كلمة مرور Facebook الخاصة به، ستصبح الأذونات قديمة وتحتاج إلى التحديث

الخطوة 1: انتقل إلى إعدادات مساحه العمل > انقر فوق القنوات.

الخطوة 2: حدد موقع قناة منصة واتساب للأعمال (API) > انقر فوق إدارة.

الخطوة 3: انقر فوق استكشاف الأخطاء >تحديث الإذن لتحديث أذونات WhatsApp.

الخطوة 4: أرسل رسالة اختبار إلى رقم هاتف WhatsApp وتحقق مما إذا كانت قد وصلت.

تعذر إرسال الرسائل الصادرة: خطأ في التحقق من رمز الوصول

يمكن أن يحدث هذا لعدة أسباب:

• عندما تنتهي جلسة التحقق من صحة رمز الوصول.

• تم تغيير صلاحيات المسؤول للمستخدم في Meta Business Manager.

• تم تغيير كلمة المرور في Meta Business Manager.

لحل هذا الخطأ، يجب عليك تحديث أذونات قناة WhatsApp Cloud API الخاصة بك وإرسال رسالة اختبار مرة أخرى.

يجب أن تكون مسؤولًا في Meta Business Manager لتتمكن من تحديث الأذونات

جهة الاتصال لا تتلقى رسائل

قد يحدث هذا عندما لم يوافق جهة الاتصال على شروط WhatsApp وسياسة الخصوصية.

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

ما هي متطلبات رقم الهاتف الذي سيتم استخدامه للتسجيل في WhatsApp Cloud API؟

• لا يمكن استخدام رقم الهاتف المستخدم في WhatsApp Cloud API في تطبيق WhatsApp الشخصي أو تطبيق الأعمال. ستحتاج إلى حذف الحساب من تطبيق WhatsApp الشخصي أو تطبيق الأعمال قبل أن تتمكن من استخدام الرقم للتسجيل في WhatsApp Cloud API.

• لا يزال بإمكانك استخدام الرقم لأغراض أخرى، مثل الاتصال واستقبال SMS بعد تسجيله على منصة واتساب للأعمال.

• بمجرد استخدام رقم على WhatsApp Cloud API لن تتمكن بعد الآن من استخدام هذا الرقم على تطبيق WhatsApp Business.

هل التحقق من الأعمال ضروري لبدء استخدام Cloud API؟

ليس من الضروري إكمال عملية التحقق من Facebook Business لبدء إرسال الرسائل على WhatsApp. بدون التحقق من الأعمال، ستظل شركتك قادرة على:

• الرد على عدد غير محدود من المحادثات التي بدأها المستخدم

• إرسال محادثات بدأتها الشركة (قوالب الرسائل) إلى 250 عميلًا فريدًا خلال فترة 24 ساعة متواصلة

• تسجيل ما يصل إلى رقمين هاتفيين

يمكن للشركات بدء عملية التحقق من الأعمال فقط عندما تكون جاهزة لتوسيع المحادثات التي تبدأها الأعمال أو ترغب في أن تصبح حسابًا تجاريًا رسميًا

هل يمكنني عرض تحليلات المحادثات لحساب WhatsApp Business الخاص بي؟

نعم، يمكنك مراقبة تحليلات الرسائل والإنفاق في الوقت الفعلي لحساب WhatsApp التجاري الخاص بك في علامة التبويب Insights في Meta WhatsApp Manager. اقرأ المزيد هنا.

ما هي حدود الرسائل في واتساب؟

تحدد حدود الرسائل الحد الأقصى لعدد مستخدمي واتساب الفريدين الذين يمكن لمحفظة الأعمال بدء محادثات مبادرة من الأعمال معهم خلال فترة 24 ساعة. يتم مشاركة هذا الحد بين جميع أرقام الهواتف في المحفظة

لا تنطبق هذه الحدود على المحادثات التي يبدأها المستخدم تبدأ المحادثة التي تبدأها الأعمال عند تسليم أول رسالة إلى العميل وتستمر لمدة 24 ساعة

هناك سوء فهم شائع يفيد بأن كل رسالة تُحتسب ضمن الحد — في الواقع، الرسائل المتعددة المرسلة إلى نفس المستخدم خلال 24 ساعة تُحتسب على أنها محادثة واحدة فقط.

اقرأ المزيد هنا.

كيف أضيف طريقة دفع إلى حساب WhatsApp Business الخاص بي؟

يمكنك إضافة طريقة دفع إلى حساب WhatsApp Business الخاص بك في Business Manager. تعرف على كيفية إضافة طريقة دفع إلى حساب WhatsApp Business الخاص بك هنا.

لماذا فشلت رسالتي في الإرسال مع ظهور الخطأ "Business eligibility payment issue"؟

من المرجح أن يكون السبب تجاوزك للحد المجاني الشهري دون وجود وسيلة دفع صالحة. لحل هذه المشكلة، أضف وسيلة دفع صالحة.

ما هو تسعير WhatsApp Cloud API؟

اعتبارًا من 1 يوليو 2025، تستخدم WhatsApp Cloud API نموذج تسعير هجين. المحادثات الخدمية (عندما ترد على عميل خلال 24 ساعة) تُحسب لكل محادثة رسائل القوالب — التسويق، الخدمية، والمصادقة — تُحسب لكل رسالة مرسلة القوالب الخدمية مجانية إذا أُرسلت خلال 24 ساعة، بينما قوالب المصادقة والتسويق تُفرض دائمًا رسومًا لكل رسالة تحصل القوالب الخدمية والمصادقة ذات الحجم الكبير على خصومات تلقائية متدرجة تفتح محادثات نقاط الدخول المجانية من الإعلانات أو CTAs الخاصة بالصفحة نافذة مجانية مدتها 72 ساعة حيث تكون جميع أنواع الرسائل مجانية

تعرف على المزيد حول أسعار WhatsApp هنا.

كيف أحذف رقم هاتف من حساب تجاري؟

هناك بعض المتطلبات والخطوات اللازمة لحذف رقم الهاتف، اقرأ المزيد هنا.

هل يمكنني استخدام respond.io لإرسال بث WhatsApp Cloud API باستخدام رقم اختبار Meta؟

بإمكانك إرسال بث اختبار من المنصة باستخدام رقم اختبار Meta. ومع ذلك، يقتصر البث باستخدام رقم الاختبار على خمسة مستلمين يجب عليك أولًا إضافة هؤلاء المستلمين الخمسة إلى قائمة أرقام الهاتف في أدوات مطوّري Meta.

إذا لم تقم بإضافة مستلمين إلى هذه القائمة أو حاولت إرسال بث إلى مستلمين غير موجودين في هذه القائمة، فستتلقى رسالة خطأ.

هل يمكنني حذف رقم اختبار Meta من حساب Cloud API المتصل بي؟

لا، يتم توفير هذا الرقم تلقائيًا لجميع الحسابات لاستخدامه في إرسال رسائل الاختبار ولا يمكن حذفه. يرجى ملاحظة أن هذا رقم اختبار ولا ينبغي استخدامه لأغراض أخرى

لماذا أرى جهات اتصال مكررة من نفس قناة WhatsApp؟

تمرّر WhatsApp رقم هاتف جهة الاتصال في صيغة تختلف عن صيغة E.164 التي يستخدمها respond.io. يسبب هذا الاختلاف تكرار جهات الاتصال من بعض البلدان إذا حدث ذلك، تواصل معنا هنا.

كيف أغير اسم عرض Cloud API الخاص بي؟

لتغيير اسم عرض Cloud API الخاص بك، اتبع الخطوات التالية:

1. انتقل إلى حسابك في FBM > حساب WhatsApp > رقم الهاتف تعرض هذه الصفحة حد الرسائل وجودتها

2. مرّر فوق أيقونة القلم بجوار اسم العرض لتمكين التحرير

3. انقر فوق التالي لإرسال اسم العرض الجديد إلى Meta للموافقة

4. انتظر تأكيد الموافقة من Meta.

ما الخطوات التي يجب أن أتخذها بمجرد الموافقة على اسم العرض الجديد لـ Cloud API الخاص بي؟

بعد الحصول على موافقة من Meta على اسم العرض الجديد، أكمل الخطوات التالية:

1. أعد تسجيل رقم هاتفك باستخدام اسم العرض المعتمد حديثًا.

2. قم بتنفيذ استدعاء POST API إلى للتحقق من رقم هاتفك.

3. قم بإجراء استدعاء POST API آخر إلى لإعادة تسجيل رقم الهاتف الذي تم التحقق منه.

4. بمجرد النجاح، يكتمل تحديث اسم العرض الخاص بـ Cloud API.

لماذا واجهت الخطأ "خطأ في التحقق من رمز الوصول: تم إبطال الجلسة لأن المستخدم غيّر كلمة مروره أو لأن فيسبوك غيّر الجلسة لأسباب أمنية" عند محاولة إرسال رسالة؟

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

لحل هذه المشكلة، تحتاج إلى تحديث أذونات القناة على منصتنا باستخدام بيانات اعتماد فيسبوك المحدثة الخاصة بك. تتطلب هذه العملية دور مسؤول. عن طريق تحديث الأذونات، ستعيد إنشاء الاتصال بالبيانات الجديدة، مما يضمن إرسال رسائلك الصادرة بنجاح دون أخطاء.

كيف أقوم بإلغاء ربط WhatsApp Cloud API من respond.io؟

لإيقاف استخدام WhatsApp Cloud API مع respond.io، اتبع الخطوات التالية:

الخطوة 1: حذف القناة في respond.io

• اذهب إلى إعدادات مساحه العمل > القنوات.

• حدد قناة WhatsApp Cloud API الخاصة بك.

• احذف القناة.

الخطوة 2: حذف رقم الهاتف من WhatsApp Manager

• انتقل إلى إدارة أعمال ميتا.

• انتقل إلى WhatsApp Manager > أرقام الهواتف.

• احذف رقم الهاتف.

ماذا يحدث بعد إلغاء ربط WhatsApp Cloud API؟

• سيتوقف respond.io عن استلام وإرسال الرسائل.

• ستتوقف Webhooks المتصلة بـ respond.io عن العمل.

مهم:

• حذف القناة في respond.io لا يؤدي إلى حذف الرقم تلقائيًا من حساب Meta Business الخاص بك.

• إذا رغبت في استخدام الرقم مرة أخرى في تطبيق WhatsApp Business، يجب حذفه من Cloud API أولًا (كما تطلبه Meta).

• إذا استمر الرقم في المراسلة عبر تكامل آخر، فقد تنطبق أسعار المحادثات القياسية من Meta.