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

كيف يعمل

يقع SMSFabric بين شيفرتك وهواتفك. تتواصل شيفرتك مع الواجهة البرمجية عبر HTTPS، وتُبقي هواتفك اتصالًا آمنًا مفتوحًا مع SMSFabric وترسل كل رسالة عبر إحدى شرائحها.

  1. ترسل طلبًا. يستدعي خادمك POST /v1/messages بمفتاح API، أو يضغط أحدهم إرسال في البوابة. يتحقق SMSFabric من المفتاح والمستلمين والقائمة السوداء، ويحفظ الرسالة مشفرة، ويرد بـ 201 Created والحالة queued.

  2. يختار SMSFabric هاتفًا وشريحة. يختار الموجّه الجهاز أو الشريحة أو المجموعة التي طلبتها، أو شريحتك الافتراضية، مع احترام الحد اليومي لكل شريحة وفترة الانتظار بين الرسائل. تصبح الحالة routed.

  3. يرسلها الهاتف. يتلقى الهاتف المهمة عبر اتصاله المباشر. وإذا كان الاتصال خاملًا، يوقظه إشعار فوري أولًا. يسلّم الهاتف الرسالة إلى نظام Android الذي يرسلها عبر شركة الاتصالات. تنتقل الحالة إلى sending ثم sent.

  4. تعيد شركة الاتصالات التقرير. عندما يستقبل هاتف المستلم الرسالة، ترسل شركة الاتصالات تقرير تسليم إلى الهاتف، فيمرره الهاتف إلى SMSFabric. تصبح الحالة delivered، أو failed مع رمز خطأ.

  5. يصلك الخبر. يُكتب كل تغيير في السجل الزمني للرسالة، ويظهر مباشرة في البوابة، ويُرسل إلى webhooks الخاصة بك على شكل message.sent أو message.delivered أو message.failed.

  1. queued
  2. routed
  3. sending
  4. sent
  5. deliveredfailedblocked
تنتهي كل رسالة صادرة بإحدى الحالات النهائية: delivered أو failed أو blocked.

الرسالة إلى رقم في القائمة السوداء أو رقم ألغى اشتراكه لا تغادر SMSFabric أبدًا، وتُحفظ بالحالة blocked.

عندما يرسل أحدهم رسالة إلى إحدى شرائحك، يقرؤها تطبيق Android (إصدار direct) ويرسلها إلى SMSFabric. تظهر في الرسائل باتجاه وارد وحالة received، ويرسل SMSFabric حدث webhook باسم message.received. وإذا كان النص STOP يُضاف الرقم إلى قائمتك السوداء. راجع الرسائل الواردة.

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

مفاتيح API التي تبدأ بـ sf_test_ لا تصل إلى أي شركة اتصالات. يستقبل جهاز افتراضي رسائلها ويبلغ عنها بأنها سُلّمت، فتستطيع بناء تكاملك واختباره قبل إقران هاتف حقيقي. راجع بيئة الاختبار.