كيف يعمل
يقع SMSFabric بين شيفرتك وهواتفك. تتواصل شيفرتك مع الواجهة البرمجية عبر HTTPS، وتُبقي هواتفك اتصالًا آمنًا مفتوحًا مع SMSFabric وترسل كل رسالة عبر إحدى شرائحها.
مسار الرسالة الصادرة
Section titled “مسار الرسالة الصادرة”-
ترسل طلبًا. يستدعي خادمك
POST /v1/messagesبمفتاح API، أو يضغط أحدهم إرسال في البوابة. يتحقق SMSFabric من المفتاح والمستلمين والقائمة السوداء، ويحفظ الرسالة مشفرة، ويرد بـ201 Createdوالحالةqueued. -
يختار SMSFabric هاتفًا وشريحة. يختار الموجّه الجهاز أو الشريحة أو المجموعة التي طلبتها، أو شريحتك الافتراضية، مع احترام الحد اليومي لكل شريحة وفترة الانتظار بين الرسائل. تصبح الحالة
routed. -
يرسلها الهاتف. يتلقى الهاتف المهمة عبر اتصاله المباشر. وإذا كان الاتصال خاملًا، يوقظه إشعار فوري أولًا. يسلّم الهاتف الرسالة إلى نظام Android الذي يرسلها عبر شركة الاتصالات. تنتقل الحالة إلى
sendingثمsent. -
تعيد شركة الاتصالات التقرير. عندما يستقبل هاتف المستلم الرسالة، ترسل شركة الاتصالات تقرير تسليم إلى الهاتف، فيمرره الهاتف إلى SMSFabric. تصبح الحالة
delivered، أوfailedمع رمز خطأ. -
يصلك الخبر. يُكتب كل تغيير في السجل الزمني للرسالة، ويظهر مباشرة في البوابة، ويُرسل إلى webhooks الخاصة بك على شكل
message.sentأوmessage.deliveredأوmessage.failed.
queuedroutedsendingsentdeliveredfailedblocked
الرسالة إلى رقم في القائمة السوداء أو رقم ألغى اشتراكه لا تغادر SMSFabric أبدًا، وتُحفظ بالحالة blocked.
الرسائل الواردة
Section titled “الرسائل الواردة”عندما يرسل أحدهم رسالة إلى إحدى شرائحك، يقرؤها تطبيق Android (إصدار direct) ويرسلها إلى SMSFabric. تظهر في الرسائل باتجاه وارد وحالة received، ويرسل SMSFabric حدث webhook باسم message.received. وإذا كان النص STOP يُضاف الرقم إلى قائمتك السوداء. راجع الرسائل الواردة.
عندما ينقطع الهاتف
Section titled “عندما ينقطع الهاتف”ترسل الهواتف نبضة دورية. فإذا توقف هاتف عن إرسالها، تعرضه البوابة غير متصل وتبقى رسائله المنتظرة في الطابور. وإذا كان الهاتف ضمن مجموعة، ينقل SMSFabric تلك الرسائل إلى هاتف متصل آخر في المجموعة نفسها. أما إذا كان وحده، فتُرسل فور عودة اتصاله.
وضع الاختبار
Section titled “وضع الاختبار”مفاتيح API التي تبدأ بـ sf_test_ لا تصل إلى أي شركة اتصالات. يستقبل جهاز افتراضي رسائلها ويبلغ عنها بأنها سُلّمت، فتستطيع بناء تكاملك واختباره قبل إقران هاتف حقيقي. راجع بيئة الاختبار.