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

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

البداية السريعة ١. نظرة عامة والمصادقة ٢. إرسال رسائل واتساب ٣. إرسال فواتير أونكس ٤. استقبال إشعارات Webhooks

١. المصادقة وتوليد المفتاح

تتم مصادقة كافة الطلبات البرمجية عبر ترويسة Authorization بنمط Bearer Token. يمكنك إنشاء وإدارة المفاتيح من إعدادات مساحة العمل في منصة WaselOne.

Authorization: Bearer wasel_live_98a72b10f54c3e8a...

POST /api/v1/messages/send-template

إرسال قالب رسالة معتمد من Meta إلى رقم هاتف العميل.

{
  "recipientPhone": "+966501234567",
  "templateName": "order_confirmation_v2",
  "language": "ar",
  "components": [
    {
      "type": "body",
      "parameters": [
        { "type": "text", "text": "سعود العتيبي" },
        { "type": "text", "text": "#ORD-9824" },
        { "type": "text", "text": "149.99 SAR" }
      ]
    }
  ]
}

POST /api/v1/onyx/dispatch-invoice

نقطة ربط يتم استدعاؤها آلياً بواسطة موديول أونكس برو فور حفظ الفاتورة الضريبية.

{
  "invoiceNumber": "INV-2026-9041",
  "customerPhone": "+966555123456",
  "pdfDownloadUrl": "https://cdn.waselone.sa/invoices/9041.pdf",
  "vatAmount": 19.50,
  "totalAmount": 149.50
}

٤. استلام إشعارات الأحداث عبر Webhooks

اضبط رابط الـ Webhook الخاص بنظامك لاستلام تقارير تسليم الرسائل فورياً، وإشعارات القراءة، والرسائل الواردة من العملاء.

message.delivered

message.read (Blue Checks)

customer.replied

onyx.invoice_delivered