التوثيق البرمجي والـ Webhooksدليل الربط البرمجي الشامل

دليل المطورين والربط البرمجي

دليل متكامل يوضح كيفية إرسال رسائل التحقق واستقبال تقارير التسليم اللحظية عبر Meta WhatsApp Cloud API v21.0.

1. المصادقة وتفويض الطلبات

تعتمد المنصة على نظام التوثيق المعياري Bearer Token. يتم إرسال رمز الوصول الدائم System User Token في ترويسة الطلب:

Authorization: Bearer EAAG_LIVE_PERMANENT_ACCESS_TOKEN

2. إرسال رسالة تحقق أو قالب معتمد

استدعاء الـ Endpoint المباشر لإرسال القوالب إلى المستلمين:

POSThttps://graph.facebook.com/v21.0/{phone_number_id}/messages
نموذج الطلب البرمجي:
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+962770405454",
  "type": "template",
  "template": {
    "name": "rowmini_auth_otp",
    "language": {
      "code": "ar"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "849201"
          }
        ]
      },
      {
        "type": "button",
        "sub_type": "url",
        "index": "0",
        "parameters": [
          {
            "type": "text",
            "text": "849201"
          }
        ]
      }
    ]
  }
}

3. استقبال إشعارات الـ Webhooks

ترسل سيرفرات ميتا إشعارات لحظية عند تغير حالة الرسالة (تم الإرسال، تم التسليم، تمت القراءة). يدعم نظامنا التحقق التلقائي السريع.

// Webhook Verification Endpoint:
GET https://api.rowmini.com/api/whatsapp/webhook
// Inbound Events Endpoint:
POST https://api.rowmini.com/api/whatsapp/webhook