حالات الرسائل
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 فورًا:
- شريحة أخرى. يجرّب الهاتف ذو الشريحتين الرسالة على شريحته الأخرى قبل أن يُبلغ بالفشل.
- هاتف آخر. إذا كان في مساحة عملك هاتف آخر متصل لم يجرّب هذه الرسالة بعد، يُسجَّل الفشل بالنوع
attempt_failedوتعود الرسالة إلى الطابور لذلك الهاتف. ولا تصبحfailedإلا بعد أن تجرّبها كل الهواتف المتصلة. - هاتف صامت. إذا توقف الهاتف الذي يحمل رسالة عن السحب أكثر من دقيقتين، تعود الرسالة إلى الطابور (
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.