حل المشكلات
ابدأ بالرسالة: افتحها في شاشة الرسائل في البوابة، أو استدع GET /v1/messages/:id واقرأ status وerrorCode والسجل الزمني events. معظم المشكلات تظهر هناك.
الرسائل عالقة في queued
Section titled “الرسائل عالقة في queued”| السبب | كيف تعرفه | الحل |
|---|---|---|
| لا يوجد هاتف متصل | يظهر GET /v1/devices كل الهواتف offline، وفي السجل الزمني wake_sent. |
افتح تطبيق SMSFabric على الهاتف، وتحقق من اتصاله، واستثنه من تحسين البطارية (البطارية). |
| مجدولة أو خارج نافذة الإرسال | scheduledAt في المستقبل، أو في تفضيلاتك sendWindow. |
انتظر، أو غيّر نافذة الإرسال من الإعدادات ← الإرسال. |
| الهاتف أو الشريحة معطلة | قيمة enabled للجهاز أو الشريحة false. |
فعّله من الأجهزة. |
| بلغت الشريحة حدها اليومي | dailyLimit مضبوط للشريحة. |
ارفع الحد، أو أرسل عبر مجموعة فيها شرائح أكثر. |
الرسائل عالقة في routed
Section titled “الرسائل عالقة في routed”طُلب من الهاتف الإرسال لكنه لم يؤكد. غالبا يكون نائما أو فقد الاتصال. تحقق من lastSeenAt للجهاز. في المجموعة تنتقل الرسالة إلى هاتف آخر بعد 10 ثوان، وخارجها تنتظر ذلك الهاتف.
الرسائل failed
Section titled “الرسائل failed”اقرأ errorCode:
errorCode |
الحل |
|---|---|
no_device_available |
اقرن هاتفا أو فعّل أحدها. |
radio_off |
الهاتف في وضع الطيران أو الشبكة اللاسلكية مطفأة. |
no_service |
لا توجد إشارة. انقل الهاتف أو افحص الشريحة. |
generic_failure |
غالبا لا يوجد رصيد، أو حظرت شركة الاتصالات الرسالة. جرّب الإرسال من تطبيق الرسائل في الهاتف نفسه. |
limit_exceeded |
بلغ Android حد الإرسال الخاص به. زد فترة الانتظار في التفضيلات، أو وزّع الحركة على هواتف أكثر. |
short_code_not_allowed وshort_code_never_allowed |
يمنع Android الإرسال إلى هذا الرقم المختصر. |
sim_not_found |
أُزيلت الشريحة. أعد إدخالها أو اختر شريحة أخرى. |
device_rejected وdevice_unavailable |
رفض الهاتف الرسالة أو عُطّل. افحص التطبيق على الهاتف. |
tenant_suspended |
تواصل مع الدعم. |
رسائل sent لا تصبح delivered
Section titled “رسائل sent لا تصبح delivered”قبلت شركة الاتصالات الرسالة لكن لم يعد تقرير تسليم. بعض الشبكات وبعض الأجهزة لا ترسل تقارير. إذا قال المستلم إنه لم يتلقها، تحقق من صحة الرقم ومن أنه ليس هاتفا أرضيا.
الرسائل blocked
Section titled “الرسائل blocked”قيمة errorCode هي blacklisted أو opted_out أو campaign_canceled. راجع القائمة السوداء: المستلم الذي رد بكلمة STOP موجود فيها بالمصدر opt_out، ولا يُزال إلا إذا رد بكلمة START.
تواقيع webhook لا تتطابق
Section titled “تواقيع webhook لا تتطابق”- تحققت من JSON بعد تحليله وإعادة تسلسله بدل المحتوى الخام. استخدم البايتات كما وصلت تماما (الطريقة).
- استخدمت سرا خاطئا. لكل نقطة نهاية سر
whsec_خاص بها. - ساعة خادمك منحرفة أكثر من 5 دقائق. زامنها عبر NTP.
- غيّر وكيل أمام تطبيقك المحتوى (مثلا بإعادة ترميزه).
Webhooks لا تصل
Section titled “Webhooks لا تصل”- نقطة النهاية غير مشتركة في ذلك الحدث، أو معطلة. تحقق من المطوّرون ← Webhooks.
- ترد نقطة النهاية بشيء غير
2xx، أو تستغرق أكثر من 10 ثوان. تظهر قائمة الطلباتlastStatusCodeوlastError. - نقطة النهاية تعيد التوجيه. إعادة التوجيه تُعد فشلا، فاستخدم الرابط النهائي.
- جدار حماية يمنع SMSFabric. اسمح بطلبات
POSTالواردة من الإنترنت على ذلك المسار، واعتمد على التوقيع للثقة.
أخطاء الواجهة البرمجية
Section titled “أخطاء الواجهة البرمجية”| الخطأ | الحل |
|---|---|
401 invalid_api_key |
تحقق من وجود مسافات أو قيمة مقطوعة في المفتاح، فربما أُلغي. |
403 missing_permission |
ينقص المفتاح صلاحية. أنشئ مفتاحا بها (المصادقة). |
403 api_key_not_allowed |
نفّذ العملية من البوابة، فنقطة النهاية للمستخدمين المسجلين فقط. |
404 not_found لمعرّف تعرفه |
المفتاح يتبع مؤسسة أخرى. |
400 validation_failed |
اقرأ errors[]، فكل مدخل يسمي الحقل. |
429 rate_limited |
انتظر Retry-After ثانية (حدود المعدل). |
القائمة الكاملة في الأخطاء. ولمشكلات تطبيق الهاتف انظر حل مشكلات تطبيق الهاتف.
التواصل مع الدعم
Section titled “التواصل مع الدعم”أرفق requestId من استجابة الخطأ، ومعرّف الرسالة أو الكائن، والوقت. لا ترسل أبدا مفتاح API أو سر webhook.