المصادقة

تستخدم واجهة نبّه مفاتيح Bearer Token عبر Laravel Sanctum. أنشئ المفتاح من لوحة التحكم: الإعدادات → API، واختر اسماً وصلاحيات المفتاح. يظهر المفتاح كاملاً مرة واحدة فقط بعد الإنشاء — احفظه في مكان آمن.

إرسال المفتاح

أضف المفتاح في ترويسة Authorization بنوع Bearer:

curl
curl -X POST "https://nabbih.com/api/v1/whatsapp/messages/send-template"
  -H "Authorization: Bearer {YOUR_API_KEY}"
  -H "Content-Type: application/json"

الصلاحيات (Abilities)

لكل مفتاح صلاحيات تحدد ما يمكنه فعله:

الصلاحية الوصف
whatsapp:consent:writeتسجيل دليل موافقة العميل على رسائل واتساب
whatsapp:send إرسال رسائل واتساب (قوالب ونصوص) والاستعلام عن حالة رسالة.
whatsapp:templates:read عرض قوالب واتساب الخاصة بالنشاط.

إدارة المفاتيح

  • أنشئ مفتاحاً منفصلاً لكل نظام أو تكامل.
  • ألغِ أي مفتاح مشتبه به فوراً — الإلغاء يوقف كل الطلبات التي تستخدمه في الحال.
  • لا تضع المفتاح في كود الواجهة الأمامية أو تطبيقات الجوال أبداً.

خطأ مصادقة

المفتاح المفقود أو الملغى يُرجع:

401 unauthorized
{
  "error": {
    "code": "unauthenticated",
    "message": "Unauthenticated."
  }
}