LiSco SMSالتوثيق
لوحة التحكمEnglish
  • مقدمة
  • البدء السريع
  • المصادقة
  • الأخطاء
  • الحدود
  • أرقام الهواتف
  • الرسائل
  • حالات الرسائل
  • رموز التحقق
  • الأجهزة
  • Webhooks
  • سجل التغييرات

© 2026 LiSco SMS

الشروطالخصوصيةحذف الحسابتواصل معنا

حالات الرسائل

pending → claimed → sent → delivered
            ↘ failed      ↘ (expired before it was sent)
الحالةالمعنىنهائية؟
pendingتنتظر في الطابور هاتفًا.لا
claimedأخذها هاتف وهو يرسلها.لا
sentأرسلها الهاتف وقبلتها شبكة الجوال.غالبًا؛ وتصبح delivered إذا وصل تقرير تسليم
deliveredأبلغت الشبكة بتسليمها إلى جهاز المستلم.نعم
failedتعذّر إرسالها؛ يبيّن error السبب.نعم، إلا في حالة sent المتأخرة (أدناه)
expiredانقضت ttlSec قبل أن يرسلها أي هاتف.نعم، إلا في حالة sent المتأخرة (أدناه)

لا ترسل كل الشبكات تقارير تسليم، فقد تبقى الرسالة sent نهائيًا مع أنها وصلت: اعتبر sent نجاحًا وdelivered تأكيدًا.

التحويل بين الشرائح والهواتف#

الفشل لا يعني failed فورًا:

  1. شريحة أخرى. يجرّب الهاتف ذو الشريحتين الرسالة على شريحته الأخرى قبل أن يُبلغ بالفشل.
  2. هاتف آخر. إذا كان في مساحة عملك هاتف آخر متصل لم يجرّب هذه الرسالة بعد، يُسجَّل الفشل بالنوع attempt_failed وتعود الرسالة إلى الطابور لذلك الهاتف. ولا تصبح failed إلا بعد أن تجرّبها كل الهواتف المتصلة.
  3. هاتف صامت. إذا توقف الهاتف الذي يحمل رسالة عن السحب أكثر من دقيقتين، تعود الرسالة إلى الطابور (requeued) للهواتف الأخرى.

بعض الأخطاء تتكرر بالطريقة نفسها على كل هاتف، فتكون نهائية فورًا: invalid_phone وmissing_text وtext_too_long وunknown_template وmissing_var.

والرسالة المرسلة مع deviceId لا تنتقل أبدًا إلى هاتف آخر.

انتهاء الصلاحية#

الرسالة التي لا تُرسل خلال ttlSec (الافتراضي 24 ساعة، و5 دقائق لرموز التحقق ما لم تختر غير ذلك) تصبح expired مع error: "expired". ويُفحص انتهاء الصلاحية كل 30 ثانية، سواء أكان هناك هاتف متصل أم لا.

«أُرسلت» المتأخرة#

قد يُبلغ الهاتف بالنجاح بعد أن تكون الرسالة قد احتُسبت failed أو expired، كأن يكون منقطعًا أثناء الإرسال. وتُقبل sent المتأخرة دائمًا: تصبح الرسالة sent لأن الرسالة خرجت فعلًا. ولا تُخفَّض حالة delivered أبدًا.

كل تغيير إلى sent أو delivered أو failed أو expired يُرسل أيضًا عبر Webhook.

السابقالرسائلالتاليرموز التحقق