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

البدء السريع

في هذا الدليل تقرن هاتفًا بحسابك، وتنشئ مفتاح API، وترسل رسالة من شيفرتك، ثم تتابعها في البوابة حتى تُسلَّم.

  • حساب في SMSFabric. أنشئه من https://app.smsfabric.com/register (دليل الحساب).
  • هاتف Android فيه شريحة SIM وتطبيق SMSFabric مثبت (تثبيت التطبيق).
  • طرفية فيها curl، أو Node.js بالإصدار 20 أو أحدث.
  1. في البوابة، افتح الأجهزة ثم انقر إقران هاتف.

  2. يظهر رمز QR صالح لمرة واحدة ولمدة 10 دقائق.

  3. على الهاتف، افتح SMSFabric واضغط مسح رمز QR، ثم وجّه الكاميرا نحو الرمز. لا توجد كاميرا؟ اضغط إدخال الرمز يدويًا واكتب الرمز الظاهر تحت رمز QR.

    اضغط مسح رمز QR.
    اضغط متابعة واسمح باستخدام الكاميرا.
  4. تؤكد البوابة أن الهاتف اقترن وتعرض شرائحه، ويعرض الهاتف أن البوابة متصلة.

    البوابة متصلة.

اسمح للتطبيق بتجاهل تحسين البطارية عندما يطلب ذلك، حتى لا يوقفه Android ليلًا (السبب).

  1. افتح مفاتيح API تحت المطوّرون في الشريط الجانبي، ثم انقر إنشاء مفتاح API.

  2. سمِّ المفتاح باسم ما يستخدمه، واختر تجريبي · بيئة اختبار أو إنتاج · رسائل حقيقية.

  3. حدّد messages:send وmessages:read، ثم انقر إنشاء المفتاح.

  4. انسخ السر واحفظه في مدير الأسرار أو في ملف .env، فهو لا يظهر إلا مرة واحدة. ثم انقر حفظته.

احفظه في متغير بيئة للخطوة التالية:

نافذة طرفيّة
export SMSFABRIC_API_KEY="sf_test_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

أرسل إلى رقم هاتفك بالصيغة الدولية (E.164)، مثل +201001234567.

نافذة طرفيّة
curl -X POST https://api.smsfabric.com/v1/messages \
-H "X-Api-Key: $SMSFABRIC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: quickstart-001" \
-d '{"to": "+201001234567", "body": "Hello from SMSFabric"}'

يرد SMSFabric بـ 201 Created ورسالة لكل مستلم بالحالة queued:

{
"data": [
{
"id": "msg_8k2m9xdp4lw1",
"direction": "outbound",
"to": "+201001234567",
"body": "Hello from SMSFabric",
"status": "queued",
"segments": 1,
"encoding": "GSM7",
"createdAt": "2026-11-19T09:41:00.000Z"
}
]
}

تجعل ترويسة Idempotency-Key إعادة المحاولة آمنة: إرسال الطلب نفسه مرة أخرى خلال 24 ساعة يعيد النتيجة الأولى بدل رسالة ثانية (منع التكرار).

استورد مجموعة جاهزة، واضبط المتغير apiKey، وشغّل Messages › Send a message. الخطوات في صفحة Postman وInsomnia.

22 طلبًا جاهزًا بالترتيب الذي تجربها به، من أول إرسال إلى الحملات وخطافات الويب وباقتك.

  1. افتح الرسائل. تظهر رسالتك في الأعلى، وتتحدث حالتها مباشرة.

  2. انقر الرسالة لفتحها.

  3. يعرض السجل الزمني كل خطوة: في الطابور، ثم التوجيه، ثم الإرسال، ثم التسليم، مع الهاتف والشريحة اللذين أرسلاها.

تستطيع شيفرتك قراءة السجل الزمني نفسه عبر GET /v1/messages/:id، أو تلقي كل تغيير فور حدوثه عبر webhook. راجع تتبع التسليم.

5. تلقَّ تحديثات التسليم عبر webhook

Section titled “5. تلقَّ تحديثات التسليم عبر webhook”

أضف عنوان HTTPS في Webhooks، واشترك في message.delivered وmessage.failed، وتحقق من ترويسة SMSFabric-Signature في كل استدعاء. يشرح دليل webhooks الإعداد كاملًا مع شيفرة التحقق.

ليس لديك عنوان عام بعد؟ شغّل smsfabric listen لتصلك الأحداث نفسها على جهازك وتُرسل إلى خادم محلي:

نافذة طرفيّة
smsfabric listen --forward-to http://localhost:3000/hooks/sms --events message.delivered,message.failed