رحلة الرسالة
بعد الإرسال، يدخل كل مستلم قائمة الانتظار وتُحتسب تكلفته (queued)، ثم يُسلَّم إلى مسار شركة الاتصالات (sent). لاحقًا تُبلغ شركة الاتصالات بما إذا كان الهاتف قد استلمها (delivered) أم لا (failed).
متى تصل التقارير
تصل معظم التقارير خلال ثوانٍ إلى بضع دقائق. بعض شركات الاتصالات تتأخر في الإبلاغ أو لا تُبلغ إطلاقًا؛ والرسالة التي لا يصلها تقرير تبقى في حالة sent.
الاسترداد
تُسترد قيمة الرسالة الفاشلة إلى رصيدك تلقائيًا. يمكنك رؤية كل عملية استرداد في سجل رصيدك، مع معرّف الرسالة.
استقبال Webhooks
أضف عنوان https في صفحة مفتاح API. عندما تُسلَّم رسالة أو تفشل، نرسل بطريقة POST محتوى JSON يتضمن معرّف الرسالة والرقم والحالة والسعر وقيمة ref الخاصة بك. ردّ بأي حالة 2xx؛ وإلا نعيد المحاولة حتى 8 مرات على مدى ساعتين تقريبًا.
التحقق من التوقيع
يحمل كل Webhook الترويسة X-PortSMS-Signature: t=<time>,v1=<hex>. احسب HMAC-SHA256 للنص t.body باستخدام سر التوقيع الخاص بك وقارنه بـ v1. ارفض الطلبات الأقدم من خمس دقائق حتى لا يمكن إعادة تشغيل طلب قديم.
