استقبال الرسائل
كل رسالة SMS تصل إلى شريحة في هاتف Android مقترن تُرفع إلى SMSFabric كرسالة واردة بالقيم direction: "inbound" وstatus: "received". استخدمها للردود، والدعم في الاتجاهين، ومعالجة الكلمات المفتاحية، أو لقراءة الرموز التي ترسلها الخدمات إلى أرقامك.
شكل الرسالة الواردة
Section titled “شكل الرسالة الواردة”| الحقل | القيمة |
|---|---|
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"]}'import { SMSFabric } from '@smsfabric/sdk';
const sf = new SMSFabric({ apiKey: process.env.SMSFABRIC_API_KEY });
const hook = await sf.webhooks.create({ url: 'https://acme.example/hooks/smsfabric', events: ['message.received'],});// Store this now: it is shown only once.console.log(hook.id, hook.signingSecret);import osimport requests
res = requests.post( "https://api.smsfabric.com/v1/webhooks", headers={"X-Api-Key": os.environ["SMSFABRIC_API_KEY"], "Idempotency-Key": "inbound-webhook-v1"}, json={"url": "https://acme.example/hooks/smsfabric", "events": ["message.received"]}, timeout=30,)res.raise_for_status()hook = res.json()print(hook["id"], hook["signingSecret"]) # store the secret now<?php$ch = curl_init('https://api.smsfabric.com/v1/webhooks');curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode([ 'url' => 'https://acme.example/hooks/smsfabric', 'events' => ['message.received'], ]), CURLOPT_HTTPHEADER => [ 'X-Api-Key: ' . getenv('SMSFABRIC_API_KEY'), 'Content-Type: application/json', 'Idempotency-Key: inbound-webhook-v1', ], CURLOPT_RETURNTRANSFER => true,]);$hook = json_decode(curl_exec($ch), true);echo $hook['id'] . ' ' . $hook['signingSecret'] . "\n"; // store the secret nowما تستلمه نقطة النهاية:
{ "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 }}تحقق دائما من التوقيع قبل أن تثق بالمحتوى.
عرض الرسائل الواردة
Section titled “عرض الرسائل الواردة”لتلحق بما فاتك بعد انقطاع، أو إذا لم تستخدم 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 للمزيد (انظر تقسيم الصفحات).
الرد من الشريحة نفسها
Section titled “الرد من الشريحة نفسها”لترد على الرقم الذي راسله العميل، أرسل مع simId الخاص بالرسالة الواردة:
{ "to": "+201001234567", "body": "Done. Your delivery is now on Thursday.", "simId": "sim_r2t4v6x8z1b3d5f7h9j2l4n6"}تحويل الرسائل الواردة
Section titled “تحويل الرسائل الواردة”من الإعدادات ← الإرسال (أو PATCH /v1/preferences)، ينسخ forwardInbound كل رسالة واردة دون كتابة شيفرة:
| الحقل | ما يحدث |
|---|---|
email |
بريد إلكتروني فيه المرسل ورقمك والنص. |
phone |
رسالة SMS إلى هذا الرقم بالشكل Fwd from <sender>: <text>، تُرسل عبر هواتفك. |
webhook |
طلب POST واحد غير موقّع يحمل حمولة message.received، دون إعادة محاولة. |
STOP وSTART
Section titled “STOP وSTART”عندما يكون نص الرسالة الواردة كله كلمة إيقاف، تلغي SMSFabric اشتراك المرسل نيابة عنك:
- كلمات الإيقاف:
STOPوSTOPALLوUNSUBSCRIBEوCANCELوENDوQUITوOPTOUT، وبالعربيةإيقافوإلغاءوتوقف. لا يهم حجم الأحرف ولا المسافات ولا علامات الترقيم في النهاية. - يُضاف الرقم إلى القائمة السوداء بالقيمة
source: "opt_out"، وتُعلَّم جهة الاتصال المطابقة كملغية الاشتراك، وتُحظر رسائل الحملات إليها التي لم يستلمها أي هاتف بعد معerrorCode: "opted_out". - الكلمات
STARTأوUNSTOPأوSUBSCRIBEأواشتراكتزيل مدخلopt_out. المدخل الذي أضفته يدويا يبقى.
تُحفظ الرسالة الواردة نفسها كالمعتاد وتطلق message.received.