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

استقبال الرسائل

كل رسالة SMS تصل إلى شريحة في هاتف Android مقترن تُرفع إلى SMSFabric كرسالة واردة بالقيم direction: "inbound" وstatus: "received". استخدمها للردود، والدعم في الاتجاهين، ومعالجة الكلمات المفتاحية، أو لقراءة الرموز التي ترسلها الخدمات إلى أرقامك.

الحقل القيمة
direction inbound
status received
from المرسل، بصيغة E.164 إذا كان رقم هاتف، أو اسم مرسل نصي مثل ACME
to رقم شريحتك إذا كان الهاتف يعرفه، وإلا نص فارغ
deviceId وsimId الهاتف والشريحة اللذان وصلت إليهما
provider device
body النص

استلام الرسائل الواردة عبر webhook

Section titled “استلام الرسائل الواردة عبر webhook”

اشترك بنقطة نهاية في message.received. تُرسل كل رسالة واردة إليها موقّعة، وتُعاد المحاولة حتى ترد نقطة النهاية بـ 2xx.

نافذة طرفيّة
curl https://api.smsfabric.com/v1/webhooks \
-H "X-Api-Key: $SMSFABRIC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: inbound-webhook-v1" \
-d '{"url": "https://acme.example/hooks/smsfabric", "events": ["message.received"]}'

ما تستلمه نقطة النهاية:

{
"id": "evt_d8f1h3j5l7n9p2r4t6v8x1z3",
"type": "message.received",
"createdAt": "2026-11-19T11:02:41.903Z",
"orgId": "org_n5q8t1w4z7c0f3i6l9o2r5u8",
"data": {
"id": "msg_h3j5l7n9q2s4u6w8y1a3c5e7",
"direction": "inbound",
"to": "+201009876543",
"from": "+201001234567",
"body": "Can I change my delivery to Thursday?",
"status": "received",
"segments": 1,
"encoding": "GSM7",
"deviceId": "dev_m4p7s2v5y8b1e4h7k0n3q6t9",
"simId": "sim_r2t4v6x8z1b3d5f7h9j2l4n6",
"provider": "device",
"errorCode": null,
"createdAt": "2026-11-19T11:02:41.880Z",
"sentAt": null,
"deliveredAt": null,
"metadata": null
}
}

تحقق دائما من التوقيع قبل أن تثق بالمحتوى.

لتلحق بما فاتك بعد انقطاع، أو إذا لم تستخدم webhooks، اعرضها:

نافذة طرفيّة
curl "https://api.smsfabric.com/v1/messages?direction=inbound&from=2026-11-19T00:00:00Z" \
-H "X-Api-Key: $SMSFABRIC_API_KEY"

يعيد GET /v1/messages النتائج من الأحدث إلى الأقدم، تابع nextCursor للمزيد (انظر تقسيم الصفحات).

لترد على الرقم الذي راسله العميل، أرسل مع simId الخاص بالرسالة الواردة:

{
"to": "+201001234567",
"body": "Done. Your delivery is now on Thursday.",
"simId": "sim_r2t4v6x8z1b3d5f7h9j2l4n6"
}

من الإعدادات ← الإرسال (أو PATCH /v1/preferences)، ينسخ forwardInbound كل رسالة واردة دون كتابة شيفرة:

الحقل ما يحدث
email بريد إلكتروني فيه المرسل ورقمك والنص.
phone رسالة SMS إلى هذا الرقم بالشكل Fwd from <sender>: <text>، تُرسل عبر هواتفك.
webhook طلب POST واحد غير موقّع يحمل حمولة message.received، دون إعادة محاولة.

عندما يكون نص الرسالة الواردة كله كلمة إيقاف، تلغي SMSFabric اشتراك المرسل نيابة عنك:

  • كلمات الإيقاف: STOP وSTOPALL وUNSUBSCRIBE وCANCEL وEND وQUIT وOPTOUT، وبالعربية إيقاف وإلغاء وتوقف. لا يهم حجم الأحرف ولا المسافات ولا علامات الترقيم في النهاية.
  • يُضاف الرقم إلى القائمة السوداء بالقيمة source: "opt_out"، وتُعلَّم جهة الاتصال المطابقة كملغية الاشتراك، وتُحظر رسائل الحملات إليها التي لم يستلمها أي هاتف بعد مع errorCode: "opted_out".
  • الكلمات START أو UNSTOP أو SUBSCRIBE أو اشتراك تزيل مدخل opt_out. المدخل الذي أضفته يدويا يبقى.

تُحفظ الرسالة الواردة نفسها كالمعتاد وتطلق message.received.