notification-send

الوصول والصلاحيات

Authorization: Bearer <access_token>

يمكن لواجهة ERP الداخلية استخدام الجلسة الحالية مع CSRF. هوية المستخدم وصلاحياته وقواعد العملية تحدد الوصول إلى البيانات.

مصادقة الإضافات

Authorization: HarplinkPlugin <client-uuid>.<secret>

يمكن استخدام Bearer للمستخدم المخوّل أو اعتماد الإضافة لهذه العملية. اعتماد الإضافة يتطلب النطاقات التالية إضافة إلى صلاحيات مستخدم ERP:

{
  "id": 101,
  "channel": "internal",
  "created": true
}

internal وemail يتطلبان recipient_user_id من شركة المستخدم؛ email يتطلب بريداً للمستلم. sms وwhatsapp يتطلبان recipient برقم هاتف وإعداد مزود فعال.

reference يساعد منع تكرار الإشعار الداخلي فقط؛ لا توجد آلية عامة لمنع تكرار إرسال البريد أو الهاتف.

استجابة email: channel وaccepted؛ الهاتف يضيف external_id. قبول المزود لا يضمن وصول الرسالة للمستلم.

400 عند نقص بيانات المستلم أو عدم تهيئة القناة. فشل مزود خارجي قد يعيد خطأ خادم؛ لا تكرر الإرسال تلقائياً دون معرفة حالة التسليم.

التعامل مع الأخطاء