تخطَّ إلى المحتوى

حل المشكلات

ابدأ بالرسالة: افتحها في شاشة الرسائل في البوابة، أو استدع GET /v1/messages/:id واقرأ status وerrorCode والسجل الزمني events. معظم المشكلات تظهر هناك.

السبب كيف تعرفه الحل
لا يوجد هاتف متصل يظهر GET /v1/devices كل الهواتف offline، وفي السجل الزمني wake_sent. افتح تطبيق SMSFabric على الهاتف، وتحقق من اتصاله، واستثنه من تحسين البطارية (البطارية).
مجدولة أو خارج نافذة الإرسال scheduledAt في المستقبل، أو في تفضيلاتك sendWindow. انتظر، أو غيّر نافذة الإرسال من الإعدادات ← الإرسال.
الهاتف أو الشريحة معطلة قيمة enabled للجهاز أو الشريحة false. فعّله من الأجهزة.
بلغت الشريحة حدها اليومي dailyLimit مضبوط للشريحة. ارفع الحد، أو أرسل عبر مجموعة فيها شرائح أكثر.

طُلب من الهاتف الإرسال لكنه لم يؤكد. غالبا يكون نائما أو فقد الاتصال. تحقق من lastSeenAt للجهاز. في المجموعة تنتقل الرسالة إلى هاتف آخر بعد 10 ثوان، وخارجها تنتظر ذلك الهاتف.

اقرأ 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 تواصل مع الدعم.

قبلت شركة الاتصالات الرسالة لكن لم يعد تقرير تسليم. بعض الشبكات وبعض الأجهزة لا ترسل تقارير. إذا قال المستلم إنه لم يتلقها، تحقق من صحة الرقم ومن أنه ليس هاتفا أرضيا.

قيمة errorCode هي blacklisted أو opted_out أو campaign_canceled. راجع القائمة السوداء: المستلم الذي رد بكلمة STOP موجود فيها بالمصدر opt_out، ولا يُزال إلا إذا رد بكلمة START.

  • تحققت من JSON بعد تحليله وإعادة تسلسله بدل المحتوى الخام. استخدم البايتات كما وصلت تماما (الطريقة).
  • استخدمت سرا خاطئا. لكل نقطة نهاية سر whsec_ خاص بها.
  • ساعة خادمك منحرفة أكثر من 5 دقائق. زامنها عبر NTP.
  • غيّر وكيل أمام تطبيقك المحتوى (مثلا بإعادة ترميزه).
  • نقطة النهاية غير مشتركة في ذلك الحدث، أو معطلة. تحقق من المطوّرون ← 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 ثانية (حدود المعدل).

القائمة الكاملة في الأخطاء. ولمشكلات تطبيق الهاتف انظر حل مشكلات تطبيق الهاتف.

أرفق requestId من استجابة الخطأ، ومعرّف الرسالة أو الكائن، والوقت. لا ترسل أبدا مفتاح API أو سر webhook.