Cloud API

WhatsApp Cloud API: كيف يعمل الربط الرسمي؟

دليل مبسط لفهم WhatsApp Cloud API، الإرسال عبر Graph API، استقبال الأحداث عبر Webhooks، ومتطلبات الربط مع أوتوربلاي.

تم التحقق من المصادر الرسمية: 4 أغسطس 2026
الإجابة المختصرة: WhatsApp Cloud API هو واجهة Meta المستضافة لإرسال رسائل واتساب للأعمال واستقبالها. الإرسال يتم عبر Graph API، بينما تصل الرسائل الواردة وحالات التسليم والقراءة إلى عنوان Webhook آمن بتنسيق JSON.

كيف تمر الرسالة؟

عند الإرسال، يرسل النظام طلب HTTPS إلى واجهة Cloud API. وعند ورود رسالة أو تغير حالتها، ترسل Meta حدث Webhook إلى الخادم المسجل. تقوم أوتوربلاي بتحويل هذه الأحداث إلى محادثات قابلة للعمل داخل صندوق الفريق.

العناصر الأساسية في الربط

يشمل الربط رقم الأعمال، حساب WhatsApp Business، تطبيق الأعمال، رموز الوصول والصلاحيات، وWebhook صالحًا. يجب حفظ الأسرار خارج الواجهة وعدم وضعها في JavaScript أو صفحات عامة.

لماذا Webhooks مهمة؟

لأنها تنقل الرسائل الواردة وتحديثات الحالات إلى نظامك دون الاستعلام المتكرر. توصي البنية العملية بالتحقق من الطلب، الرد سريعًا، ثم معالجة الحدث بصورة غير متزامنة لتجنب التكرار أو انتهاء المهلة.

اختبار التكامل

ابدأ برسالة اختبار، ثم تحقق من وصول الرسالة الواردة وحالات sent وdelivered وread عند توفرها. اختبر أيضًا التكرار، فشل المعالجة، وتجديد بيانات الوصول قبل تشغيل الرقم على العملاء.

أسئلة شائعة

هل أحتاج خادمًا عامًا؟

نعم إذا كنت تبني التكامل بنفسك لاستقبال Webhooks، أو يمكنك استخدام منصة تدير هذه الطبقة عنك.

هل تأتي الرسائل الواردة عبر Graph API؟

الإرسال يتم بطلبات API، أما الرسائل الواردة وتحديثات الحالات فتصل عبر Webhooks.

هل يجب كشف رمز الوصول في الموقع؟

لا. يجب الاحتفاظ به في الخادم أو مدير أسرار آمن.

المصادر الرسمية

تمت مراجعة هذه الصفحة مقابل المصادر التالية في 4 أغسطس 2026:

قد تتغير الأهلية والخصائص والسياسات. المصدر الرسمي وحالة الحساب وقت التنفيذ هما المرجع النهائي.