إنتقل إلى المحتوى الرئيسي

إعداد WhatsApp Cloud API

ما هي هذه القناة​

تربط قناة WhatsApp Cloud API منصة BotBat بـ WhatsApp من خلال بنية API المستضافة لدى Meta. هذه هي طريقة التكامل الموصى بها لأن Meta تدير خوادم WhatsApp الأساسية، مما يعني أنك لا تحتاج إلى توفير أو صيانة أي بنية تحتية خاصة بـ WhatsApp بنفسك. يدعم Cloud API النطاق الكامل لميزات WhatsApp Business، بما في ذلك رسائل القوالب ومرفقات الوسائط والأزرار التفاعلية وقوائم الخيارات والتفاعلات وإيصالات القراءة.

يتضمن إعداد القناة خمسة أنشطة أساسية: إنشاء حساب Meta Business، والحصول على رمز API دائم، وتهيئة Webhook في كل من BotBat وبوابة مطوري Meta، وتسجيل رقم هاتف عملك، والتحقق من الاتصال برسالة اختبار. بمجرد الاتصال، تتدفق جميع محادثات WhatsApp إلى صندوق الوارد الخاص بـ BotBat، ويمكنك استخدام WhatsApp كقناة مستهدفة للحملات وروبوتات المحادثة وأتمتة سير العمل.

يفرض Cloud API نافذة جلسة مدتها 24 ساعة. ضمن تلك النافذة (التي تبدأ من آخر رسالة واردة من العميل)، يمكنك إرسال ردود حرة. خارج النافذة، يجب استخدام قالب رسالة معتمد مسبقًا. يتعامل BotBat مع هذا التمييز تلقائيًا عن طريق مطالبة الوكلاء باختيار قالب عند انتهاء صلاحية الجلسة.

متى تستخدمها​

إضافة WhatsApp كقناة مراسلة. هذا هو مسار الإعداد الرئيسي لأي شركة ترغب في التواصل مع العملاء عبر WhatsApp. سواء كان هدفك دعم العملاء أو التواصل التسويقي أو الإشعارات المعاملاتية، فإن قناة Cloud API هي نقطة البداية.

الانتقال من مزود WhatsApp خارجي. إذا كنت تنتقل إلى BotBat من مزود حلول أعمال WhatsApp آخر (BSP)، يمكنك نقل رقم WhatsApp الحالي الخاص بك باتباع عملية نقل الأرقام من Meta ثم ربطه من خلال إعداد هذه القناة. يحافظ النقل على تصنيف جودة رقمك ومستوى المراسلة.

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

المتطلبات المسبقة​

قبل البدء، تأكد من توفر العناصر التالية.

المتطلبالتفاصيل
حساب Meta Businessتم إنشاؤه على business.facebook.com مع اكتمال التحقق من النشاط التجاري
تطبيق مطور Metaتم إنشاؤه على developers.facebook.com مع إضافة منتج "WhatsApp"
رمز API دائمرمز مستخدم النظام (وليس رمز الاختبار المؤقت لمدة 24 ساعة) الذي تم إنشاؤه في إعدادات Meta Business
معرف رقم الهاتفيظهر في صفحة إعداد API لمنتج WhatsApp الخاص بك في بوابة مطوري Meta
معرف حساب WhatsApp Businessيظهر بجانب معرف رقم الهاتف في نفس صفحة إعداد API
رقم هاتف العملرقم غير مسجل بالفعل على تطبيق WhatsApp العادي أو لدى مزود BSP آخر

الخطوات​

1. أضف قناة WhatsApp في BotBat​

انتقل إلى القنوات > إضافة قناة > WhatsApp Cloud API. يطلب نموذج الإعداد ثلاث قيم: رمز API ومعرف رقم الهاتف ومعرف حساب WhatsApp Business. الصق كل قيمة في الحقل المقابل وانقر على "حفظ".

WhatsApp channel setup form showing API token, Phone Number ID, and Business Account ID fields

2. هيئ Webhook​

بعد الحفظ، يقوم BotBat بإنشاء عنوان URL فريد لـ Webhook ورمز تحقق. يتم عرض كلتا القيمتين في صفحة تهيئة القناة. انقر على زر النسخ بجانب كل قيمة.

Setup section showing the generated webhook URL and token with copy buttons

3. حدد Webhook في Meta​

افتح إعدادات منتج WhatsApp في تطبيق Meta الخاص بك وانتقل إلى التهيئة > Webhook. الصق عنوان URL الخاص بـ Webhook من BotBat في حقل "عنوان URL للاستدعاء الراجع" ورمز التحقق في حقل "رمز التحقق". انقر على "تحقق واحفظ". ثم اشترك في حقول Webhook التالية:

حقل Webhookالغرض
messagesيسلم الرسائل الواردة وتحديثات حالة الرسائل والأخطاء
messaging_postbacksيسلم أحداث النقر على الأزرار والردود السريعة
message_template_status_updateيُعلم عند الموافقة على قالب أو رفضه أو إيقافه مؤقتًا
Meta Developer portal webhook configuration showing the webhook URL field and subscribed fields

4. تحقق من الاتصال​

يرسل Meta طلب GET إلى عنوان URL الخاص بـ Webhook مع معلمة تحدي. إذا تطابق العنوان والرمز، ينجح التحقق. عد إلى BotBat وتأكد من أن حالة القناة تظهر "متصل" مع مؤشر أخضر.

WhatsApp channel detail showing Connected status with green indicator

5. سجل رقم هاتفك وتحقق منه​

إذا كنت تسجل رقمًا جديدًا، يتطلب Meta التحقق من الملكية من خلال رمز OTP يُرسل عبر SMS أو مكالمة صوتية إلى هاتف العمل. اتبع التعليمات في بوابة مطوري Meta لإكمال هذه الخطوة. الأرقام المنقولة من مزود BSP آخر تتخطى هذه الخطوة إذا تم النقل بنجاح.

6. أعد ملفك التعريفي للأعمال​

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

Channel settings showing business name, profile photo, about, and category fields

7. أرسل رسالة اختبار​

افتح WhatsApp على جهاز شخصي وأرسل رسالة إلى رقم عملك المسجل. انتقل إلى BotBat وتأكد من ظهور الرسالة في صندوق الوارد كمحادثة جديدة. يتحقق هذا من صحة خط الأنابيب بالكامل: تسليم Webhook وتحليل الرسائل وتوجيه صندوق الوارد.

Inbox showing a new conversation from a WhatsApp test message

ميزات خاصة بـ WhatsApp​

بعد الإعداد، تتوفر إمكانيات WhatsApp التالية من خلال BotBat.

الميزةالوصف
قوالب الرسائلإرسال رسائل قوالب معتمدة مسبقًا لبدء المحادثات خارج نافذة الجلسة المحددة بـ 24 ساعة. راجع القوالب وقوالب WhatsApp.
رسائل الوسائطإرسال واستقبال الصور ومقاطع الفيديو والمستندات والملفات الصوتية والملصقات ودبابيس الموقع.
الرسائل التفاعليةإرسال رسائل تحتوي على ما يصل إلى 3 أزرار رد سريع أو قوائم خيارات تحتوي على ما يصل إلى 10 أقسام لتفاعلات المستخدم المنظمة.
التفاعلاتعرض تفاعلات الرموز التعبيرية التي يضيفها جهات الاتصال على رسائلك.
إيصالات القراءةتتبع حالة تسليم الرسالة (مرسلة، مستلمة، مقروءة) في الوقت الفعلي.

الأخطاء الشائعة​

استخدام رمز مؤقت. توفر بوابة مطوري Meta رمز اختبار مؤقت تنتهي صلاحيته خلال 24 ساعة. إذا استخدمت هذا الرمز لقناتك الإنتاجية، سينقطع الاتصال كل يوم. قم دائمًا بإنشاء رمز مستخدم نظام دائم في إعدادات Meta Business الخاصة بك.

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

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

رقم الهاتف مسجل بالفعل في مكان آخر. لا يمكن تسجيل رقم هاتف WhatsApp إلا لدى مزود Business API واحد في كل مرة. إذا كان رقمك نشطًا حاليًا على تطبيق WhatsApp العادي أو لدى مزود BSP آخر، يجب عليك إلغاء تسجيله أو نقله قبل ربطه بـ BotBat.

حدود الإرسال على الأرقام الجديدة. تبدأ أرقام WhatsApp Business المسجلة حديثًا بحد إرسال يومي يبلغ 250 محادثة يبدأها النشاط التجاري. يزداد هذا الحد تلقائيًا مع الحفاظ على تصنيف جودة سليم. لا تقم بجدولة حملة واسعة النطاق على رقم جديد.

تلميح

احتفظ ببيانات اعتماد تطبيق Meta الخاص بك (رمز API ومعرف حساب الأعمال) مخزنة في مدير أسرار آمن وشاركها فقط مع أعضاء الفريق الذين يديرون تهيئات القنوات. قم بتدوير الرمز بشكل دوري وقم بتحديثه في إعدادات قناة BotBat فور التدوير.

  • نموذج إعداد WhatsApp
  • تكوين Webhook
  • الملف التجاري
  • حالة الاتصال