يمكنك الآن ترحيل حساب 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. فيما يلي قائمة بيانات جهة الاتصال التي ستتمكن من الحصول عليها من هذه القناة:
رقم التليفون
معرف رقم الهاتف
اسم الملف الشخصي
معرف واتساب
إدارة ملف تعريف API الخاص بـ WhatsApp Cloud
إذا كانت هناك حاجة لإجراء تغيير أو التحقق من ملف تعريف WhatsApp Cloud API الخاص بك، فيمكن القيام بذلك على منصة response.io.
الخطوة 1: انتقل إلى إعدادات مساحه عمل > انقر على القنوات.
الخطوة 2: حدد موقع قناة WhatsApp Cloud API > انقر فوق إدارة > الملف الشخصي.
الخطوة 3: انقر فوق مزامنة الملف الشخصي للحصول على أحدث معلومات ملف تعريف WhatsApp Business من WhatsApp.
الخطوة 4: قم بتعديل المعلومات التالية حسب الحاجة.
الحقول | وصف |
|---|---|
صورة الملف الشخصي | الصورة المعروضة هي صورة الملف الشخصي لحساب WhatsApp التجاري. يوصى بحجم صورة 640 × 640. |
عن | الأعمال'حول النص. يظهر هذا النص في الملف الشخصي للشركة'أسفل صورة الملف الشخصي ورقم الهاتف وأزرار الاتصال. |
عنوان | عنوان العمل. الحد الأقصى 256 حرفًا. |
وصف | وصف العمل. الحد الأقصى 512 حرفًا. |
بريد إلكتروني | عنوان البريد الإلكتروني (بتنسيق بريد إلكتروني صالح) للتواصل مع الشركة. الحد الأقصى 128 حرفًا. |
رَأسِيّ | صناعة الأعمال. يجب أن تكون واحدة من هذه القيم المقبولة: السيارات، الجمال، السبا، الملابس، التعليم، الترفيه، التخطيط للأحداث، التمويل والمصارف، الأغذية والبقالة، الخدمة العامة، الفنادق، الطب، غير الربحية، الخدمات المهنية، التسوق وتجارة التجزئة، السفر والنقل، المطاعم، وغيرها. لا يمكن أن يعود القطاع التجاري إلى قيمة فارغة بعد إنشائه. |
موقع إلكتروني | عناوين URL (بما في ذلك http:// أو https://) المرتبطة بالنشاط التجاري (على سبيل المثال، موقع الويب، وصفحة Facebook، وInstagram). الحد الأقصى هو 2 موقع ويب بحد أقصى 256 حرفًا لكل موقع. |
الخطوة 5: راجع المعلومات وانقر فوق حفظ التغييرات.
إدارة قوالب رسائل WhatsApp
قبل إرسال قالب رسالة إلى جهة اتصال على منصة response.io، تأكد من أنك'قمت بما يلي:
- تم إرسال قالب الرسالة للموافقة عليه - تمت إضافة قالب الرسالة المعتمد إلى مساحة العمل عن طريق مزامنة قالب الرسالة
إرسال قوالب الرسائل
الخطوة 1: انتقل إلى إعدادات مساحه عمل > انقر على القنوات.
الخطوة 2: حدد موقع قناة WhatsApp Cloud API > انقر فوق إدارة.
الخطوة 3: انقر فوق القوالب > إرسال القالب لإرسال قالب رسالة للموافقة عليه.
الخطوة 4: املأ المعلومات المطلوبة اللازمة لإنشاء قالب.
مجال | وصف |
|---|---|
اسم القالب | لا يمكن أن يحتوي الاسم إلا على أحرف أبجدية رقمية صغيرة وعلامات سفلية ( _ ) |
فئة | الفئة التي ينتمي إليها قالب الرسالة. |
لغة | اللغة التي تمت كتابة القالب بها. |
الخطوة 5: قم بإنشاء الرسالة عن طريق ملء المكونات الضرورية، ثم راجع الرسالة في قسم المعاينة. يمكنك تضمين المعلمات {{1}}، {{2}}، وما إلى ذلك كعناصر نائبة يتم ملؤها بمحتوى مخصص.
كتلة البناء | وصف |
|---|---|
جسم | يحتوي النص على أهم نص في القالب الخاص بك. يتم دعم النص فقط. يمكنك استخدام Markdown لتنسيق محتوى هذه الكتلة. تعرف على المزيد. |
رأس الصفحة | يعد الرأس اختياريًا ويعمل كعنوان أو رأس للقالب الخاص بك. يدعم ما يلي: |
تذييل | التذييل اختياري ويدعم النص فقط. يمكن استخدامه لتوفير معلومات تكميلية في قالب الرسالة الخاص بك. |
زر | يعد الزر اختياريًا ويضيف تفاعلية إلى قوالبك. هناك نوعان متاحان: |
الخطوة 6: تقديم قيمة العينة
ينطبق هذا فقط إذا قمت بتضمين أي معلمات في محتوى قالب الرسالة الخاص بك.
إن توفير قيم العينة للمعلمة في قالب الرسالة سيساعد مراجع WhatsApp على فهم الرسالة التي تحاول إرسالها إلى جهات الاتصال الخاصة بك.
رابط مهم: إرشادات قالب رسالة WhatsApp
مزامنة قوالب الرسائل
الخطوة 1: انتقل إلى إعدادات مساحه عمل > انقر على القنوات.
الخطوة 2: حدد موقع قناة WhatsApp Business Platform (API) > انقر فوق إدارة.
الخطوة 3: انقر فوق القوالب > مزامنة القالب لبدء عملية المزامنة.
تمت عملية المزامنة بالكامل. هذا يعنى:
- سيتم إدراج قوالب الرسائل مع الحالات المقابلة لها.- سيتم تحديث تاريخ ووقت آخر مزامنة.- إذا تم رفض القالب الخاص بك، فسيتم عرض سبب الرفض أسفل قالب الرسالة المرفوضة.
يوضح الجدول التالي الحالات المحتملة لقوالب الرسائل:
حالة | وصف |
|---|---|
مُقَدَّم | تم تقديم قالب الرسالة وهو في انتظار الموافقة. |
موافقة | تمت الموافقة على قالب الرسالة ويمكن إرساله إلى جهات الاتصال. |
مرفوض | تم رفض قالب الرسالة ولا يمكن استخدامه. |
استخدم البحث والتصفية في الزاوية اليمنى العليا من القائمة للعثور على قوالبك بسهولة!
أنواع الملفات المدعومة
أنواع الملفات التي يدعمها واتساب والحد الأقصى لحجم الملف لهذا النوع هو كما يلي:
الصوت & الفيديو (16 ميجابايت)
مستند (100 ميجابايت)
الصورة (5 ميجا بايت)
ملصق (100 كيلوبايت)
سيتم عرض الرسائل غير المدعومة على شكل عرض احتياطي مع نص الرسالة غير المدعومة أو الحمولة المخصصة والنوع (إذا كان متاحًا). بالنسبة لأي نوع ملف غير مدعوم أو ملف يتجاوز الحد الأقصى لحجم الملف المرسل عبر WhatsApp Cloud API، سيتم تحويل الملف تلقائيًا إلى رابط URL على منصة response.io. بالنسبة للحمولة المخصصة (Custom Payload)، يمكنك النقر على عرض المزيد لعرض حمولة JSON لهذه الرسالة. أمثلة على الرسائل غير المدعومة لـ WhatsApp Cloud API هي:
- بطاقة جهة الاتصال
- ردود الفعل
- الرسالة المحذوفة
- الاستطلاعات
- الرسالة المؤقتة
حدود المعدل
حد المعدل هو عدد مكالمات واجهة برمجة التطبيقات التي يمكن للتطبيق أو المستخدم إجراؤها خلال فترة زمنية معينة تحددها القناة. تعرف على المزيد حول حدود المعدل لهذه القناة هنا.
الأسئلة الشائعة واستكشاف الأخطاء وإصلاحها
غير قادر على إرسال الرسائل
تأكد من أن الرقم الذي قمت'بتوصيله بالمنصة هو رقم API الخاص بـ WhatsApp Cloud.
الرسائل لا تصل
يمكن أن يحدث هذا عندما لا يتم الاشتراك في خطاف الرسائل.
الخطوة 1: انتقل إلى صفحة Facebook App Webhook
افتح تطبيق فيسبوك وانتقل إلى صفحة Webhooks.
الخطوة 2: تحقق من الحدث المشترك
حدد حساب أعمال WhatsApp وتحقق مما إذا كان الحدث الرسائل مشتركًا.
الخطوة 3: إرسال رسالة اختبار
أرسل رسالة اختبار إلى رقم هاتف WhatsApp وتحقق من وصولها.
غير قادر على تلقي إيصالات القراءة
عندما يقوم المستخدم المتصل بـ WhatsApp Cloud API بتغيير كلمة مرور Facebook الخاصة به، ستصبح الأذونات قديمة وتحتاج إلى التحديث.
الخطوة 1: انتقل إلى إعدادات مساحه عمل > انقر على القنوات.
الخطوة 2: حدد موقع قناة WhatsApp Business Platform (API) > انقر فوق إدارة.
الخطوة 3: انقر فوق استكشاف الأخطاء > تحديث الإذن لتحديث أذونات WhatsApp.
الخطوة 4: أرسل رسالة اختبار إلى رقم هاتف WhatsApp وتحقق مما إذا كانت قد وصلت.
تعذر إرسال الرسائل الصادرة: خطأ في التحقق من رمز الوصول
يمكن أن يحدث هذا بسبب عدة أسباب:
عندما تنتهي جلسة التحقق من صحة رمز الوصول.
تم تغيير صلاحيات المسؤول للمستخدم في مدير أعمال ميتا.
لقد تم تغيير كلمة المرور على 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.
لا يزال بإمكانك استخدام الرقم لأغراض أخرى، مثل الاتصال واستقبال الرسائل النصية القصيرة بعد تسجيله على منصة WhatsApp Business.
بمجرد استخدامك لهاتف 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 الخاص بك هنا.
لماذا فشلت رسالتي في الإرسال مع ظهور الخطأ "مشكلة في دفع أهلية العمل"؟
من المرجح أن يكون السبب في ذلك هو تجاوزك للحد الأقصى للمستوى المجاني الشهري دون وجود طريقة دفع صالحة. لحل هذه المشكلة، أضف وسيلة دفع صالحة.
ما هو تسعير WhatsApp Cloud API؟
اعتبارًا من 1 يوليو 2025، تستخدم واجهة برمجة التطبيقات السحابية لواتساب نموذج تسعير هجين. المحادثات الخدمية (عندما ترد على عميل خلال 24 ساعة) تُحسب لكل محادثة. رسائل القوالب - التسويق، المرافق، والمصادقة - تُحسب لكل رسالة مُرسلة. القوالب الخدمية مجانية إذا تم إرسالها خلال 24 ساعة، بينما قوالب المصادقة والتسويق تُفرض دائمًا رسومًا لكل رسالة. تحصل القوالب الخدمية والمصادقة ذات الحجم العالي على خصومات تلقائية متدرجة. تفتح محادثات نقاط الدخول المجانية من الإعلانات أو CTAs الخاصة بالصفحة نافذة مجانية مدتها 72 ساعة حيث تكون جميع أنواع الرسائل مجانية.
تعرف على المزيد حول أسعار WhatsApp هنا.
كيف يمكنني حذف رقم هاتف من حساب تجاري؟
هناك بعض المتطلبات والخطوات اللازمة لحذف رقم الهاتف، اقرأ المزيد هنا.
هل يمكنني استخدام response.io لإرسال بث API لـ WhatsApp Cloud برقم اختبار Meta؟
بإمكانك إرسال بث اختبار من المنصة باستخدام رقم اختبار Meta. ومع ذلك، يقتصر البث باستخدام رقم الاختبار على خمسة مستلمين. يجب عليك أولاً إضافة هؤلاء المستلمين الخمسة إلى قائمة أرقام الهاتف في أدوات Meta Developer.
إذا لم تقم بإضافة مستلمين إلى هذه القائمة أو إذا حاولت إرسال بث إلى مستلمين غير موجودين في هذه القائمة، فستتلقى رسالة الخطأ هذه:
هل يمكنني حذف رقم اختبار Meta من حساب Cloud API المتصل بي؟
لا، يتم توفير هذا الرقم تلقائيًا لجميع الحسابات لاستخدامه في إرسال رسائل الاختبار ولا يمكن حذفه. فقط كن حذرًا ولاحظ أن هذا رقم اختبار لا ينبغي استخدامه لأغراض أخرى.
لماذا أرى جهات اتصال مكررة من نفس قناة WhatsApp؟
تمرّر WhatsApp رقم هاتف جهة الاتصال في صيغة تختلف عن صيغة E.164 التي يستخدمها respond.io. يؤدي هذا الاختلاف إلى تكرار جهات الاتصال من بلدان معينة. إذا حدث ذلك، تواصل معنا هنا.
كيف يمكنني تغيير اسم عرض Cloud API الخاص بي؟
لتغيير اسم عرض Cloud API الخاص بك، اتبع الخطوات التالية:
انتقل إلى حساب WhatsApp الخاص بك > FBM > رقم الهاتف. تعرض هذه الصفحة حد الرسائل وجودتها.
قم بالتمرير فوق رمز القلم الرصاص الموجود بجوار اسم العرض لتمكين التحرير.
انقر فوق التالي لإرسال اسم العرض الجديد إلى Meta للموافقة عليه.
انتظر تأكيد الموافقة من Meta.
ما هي الخطوات التي يجب أن أتخذها بمجرد الموافقة على اسم العرض الجديد لواجهة برمجة التطبيقات السحابية الخاصة بي؟
بعد الحصول على موافقة من Meta على اسم العرض الجديد الخاص بك، أكمل الخطوات التالية:
أعد تسجيل رقم هاتفك باستخدام اسم العرض المعتمد حديثًا.
قم بتنفيذ استدعاء API POST إلى للتحقق من رقم هاتفك.
قم بإجراء مكالمة POST API أخرى إلى لإعادة تسجيل رقم الهاتف الذي تم التحقق منه.
بمجرد النجاح، يصبح تحديث اسم العرض الخاص بـ Cloud API'الخاص بك كاملاً.
لماذا واجهت الخطأ "خطأ في التحقق من رمز الوصول: تم إبطال الجلسة لأن المستخدم قام بتغيير كلمة المرور الخاصة به أو قام Facebook بتغيير الجلسة لأسباب أمنية" عند محاولة إرسال رسالة؟
سيحدث هذا الخطأ إذا قمت مؤخرًا بتحديث بيانات اعتماد Facebook الخاصة بك، وقد يؤدي ذلك إلى تعطيل اتصال القناة على منصتنا، مما يؤدي إلى حدوث أخطاء عند إرسال الرسائل.
لحل هذه المشكلة، يتعين عليك تحديث أذونات القناة على منصتنا باستخدام بيانات اعتماد Facebook المحدثة. تتطلب هذه العملية دور المسؤول. عن طريق تحديث الأذونات، ستعيد إنشاء الاتصال ببيانات الاعتماد الجديدة، مما يضمن إرسال رسائلك الصادرة بنجاح دون مواجهة أخطاء.
كيف أقوم بإلغاء ربط 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.
