صندوق Cloud
اقرأ وردّ على محادثات WhatsApp Cloud API الرسمية لرقم ثانٍ دون مغادرة WhatsApp Web.
أيقونة صندوق Cloud في الشريط تفتح صندوق وارد Cloud API — صندوقًا موحّدًا يجلب إلى web.whatsapp.com محادثات WhatsApp Cloud API الرسمية (منصة Meta للأعمال) لرقم ثانٍ. يراسل عملاؤك رقم عملك، وتقرأهم وتردّ عليهم من الشاشة نفسها التي تضم محادثاتك الشخصية — دون صندوق Meta، ودون تبديل علامات التبويب.
إنه طبقة عرض خالصة: محادثات حسابك الشخصي وبياناته لا تُمسّ أبدًا. تمر الردود عبر خادمنا الخلفي إلى Graph API من Meta، وليس عبر WhatsApp Web.
ما الذي تحتاجه
- تطبيق مطوّر من Meta مفعَّل فيه منتج WhatsApp (أي Cloud API). ستحتاج من لوحته إلى معرّف رقم الهاتف ورمز وصول دائم.
- رقم هاتف ثانٍ. رقم Cloud API يُلغى تسجيله من تطبيق واتساب الاستهلاكي، لذا فهو بالتعريف رقم مختلف عن الرقم المسجّل في WhatsApp Web.
اربط رقم Cloud API الخاص بك
عند فتح الصندوق لأول مرة يظهر نموذج ربط WhatsApp Cloud API (لاحقًا تجده خلف زر الإعدادات):
نموذج ربط WhatsApp Cloud API مع حقول بيانات الاعتماد.
| الحقل | إلزامي | من أين يأتي |
|---|---|---|
| معرّف رقم الهاتف | نعم | تطبيق Meta ← WhatsApp ← API Setup |
| رمز الوصول | نعم | تطبيق Meta — استخدم رمزًا دائمًا (System User)، لا رمز الاختبار ذا الـ 24 ساعة |
| رمز التحقق | نعم | أي سلسلة سرية تبتكرها — تعيدها Meta أثناء التحقق من الـ webhook |
| سر التطبيق | اختياري | تطبيق Meta ← App settings ← Basic؛ يفعّل فحص توقيع الـ webhook |
| الرقم المعروض | اختياري | تسمية تظهر في رأس الصندوق، مثل +91 98765 43210 |
أسفل الحقول يوجد عنوان URL لاستدعاء الـ webhook مع زر نسخ. في تطبيق Meta افتح WhatsApp ← Configuration، والصقه كـ Callback URL مع رمز التحقق الخاص بك، واشترك في حقل الـ webhook المسمى messages. ثم اضغط حفظ واتصال — يتزامن السجل الموجود وتمتلئ قائمة المحادثات.
القراءة والرد
- اللوحة الجانبية تسرد محادثات Cloud API بالاسم (أو الرقم) والوقت ومعاينة آخر رسالة وشارة غير المقروء. يعرض الرأس الرقم المتصل مع زرّي تحديث والإعدادات.
- لوحة المحادثة تعرض الحوار. فقاعات الصادر تحمل علامات الحالة: ساعة أثناء الانتظار، علامة واحدة أُرسلت، علامتان وُصلت، علامتان زرقاوان قُرئت، وأيقونة تنبيه إذا رفضت Meta الإرسال.
- اكتب في صندوق الكتابة واضغط Enter للإرسال (Shift+Enter لسطر جديد).
نافذة الرد ذات الـ 24 ساعة
لا تسمح Cloud API بالردود النصية الحرة إلا خلال 24 ساعة من آخر رسالة للعميل — هذه قاعدة منصة Meta، لا قاعدتنا. تعرض المحادثة المفتوحة عدًّا تنازليًا مباشرًا («تبقّى 23 س 41 د للرد بحرية»). وعند بلوغه الصفر يتحول الشريط إلى «أُغلقت نافذة الرد التي مدتها 24 ساعة — يمكن الآن إرسال رسالة قالب فقط»، وسترفض Meta النصوص الحرة حتى يكتب العميل مجددًا.
التحديثات المباشرة
تنتقل الإشعارات الفورية عبر قناة الوصول إلى API من التكاملات. مع رمز API متصل، تظهر رسائل Cloud الجديدة وعلامات الحالة فورًا. وبدونه يظل الصندوق يعمل بوضع السحب — يتحدّث كلما فتحت النافذة أو ضغطت تحديث.
معلومات مفيدة
- تُخزَّن المحادثات محليًا لكل حساب، فيفتح الصندوق فورًا ويصمد أمام إعادة التحميل.
- الإرسال لا يلمس أبدًا اتصال WhatsApp Web نفسه — فالرد عبر Cloud لا يمكن أن يمسّ سمعة رقمك الشخصي.
- رسائل الوسائط الواردة عبر Cloud API تظهر حاليًا كعنصر نائب
[نوع]في المحادثة؛ أما النص فمدعوم كليًا في الاتجاهين. - إذا فشل إرسال، يظهر خطأ Graph API الدقيق فوق صندوق الكتابة — وغالبًا يكون رمز وصول منتهي الصلاحية أو نافذة 24 ساعة مغلقة.