✅ أفضل الممارسات
نصائح لإنتاجية أفضل وأمان أعلى عند استخدام Omdaa API.
🔐 المصادقة والأمان
- لا تضع JWT أو مفاتيح API في الكود المصدري أو المستودعات العامة. استخدم متغيرات البيئة أو خزائن الأسرار.
- استخدم مفاتيح API للعمليات الآلية طويلة الأمد، و JWT للجلسات التفاعلية (مثل لوحة التحكم).
- غيّر مفاتيح API بانتظام وألغِ المفاتيح غير المستخدمة.
- فعّل HTTPS فقط ولا ترسل بيانات حساسة عبر HTTP.
📱 إدارة الجلسات
- تحقق من حالة الجلسة قبل إرسال الرسائل لتجنب أخطاء «الجلسة غير متصلة».
- احفظ معرف الجلسة (sessionId) بشكل آمن واربطه بمستخدمك أو بيئتك.
- استخدم الويب هوك
session:open/session:closeلتحديث حالة الاتصال في تطبيقك.
✉️ إرسال الرسائل
- التزم بسياسات واتساب للأعمال (عدم سبام، قوالب للرسائل الأولى، إلخ).
- استخدم القوالب المعتمدة عند إرسال رسائل للعملاء الذين لم يردوا خلال 24 ساعة.
- تحقق من أرقام الهواتف بصيغة دولية (مثلاً 966xxxxxxxxx) دون رموز + أو مسافات في الطلب.
- للرسائل الجماعية، استخدم واجهة الـ bulk إن وُجدت بدلاً من إرسال طلبات منفصلة كثيرة.
🔗 الويب هوكس
- استخدم رابط ويب هوك يعمل عبر HTTPS وقادر على الرد خلال ثوانٍ (مثلاً 200 OK).
- تحقق من توقيع الطلب (إن وُجد) للتأكد أن الطلب من Omdaa وليس من مصدر آخر.
- عالج الأحداث بشكل غير متزامن (قائمة انتظار، workers) حتى لا تنتهي مهلة الطلب.
⚡ الأداء ومعدلات الطلبات
- احترم معدلات الطلبات (Rate Limits) واستخدم retry مع exponential backoff عند 429.
- خزّن البيانات التي لا تتغير كثيراً (مثل قوائم جهات الاتصال) لتقليل طلبات GET.
- استخدم الـ bulk أو الـ batch endpoints حيث متوفر لتقليل عدد الطلبات.
💡 ملخص سريع
احمِ مفاتيحك، تحقق من حالة الجلسة، التزم بسياسات واتساب، استخدم HTTPS للويب هوكس، واحترم معدلات الطلبات. راجع الأخطاء والأمان و معدلات الطلبات لمزيد من التفاصيل.