تصل الردود إلى رقم الهاتف المحمول الذي تعرفه جهة الاتصال لديك بالفعل.
SMSMobileAPI / API
تم استلام SMS API · يبقى هاتفك صندوق الوارد
حوّل كل SMS تستقبله على هاتفك إلى بيانات قابلة للاستخدام في تطبيقك.
يرسل جهة الاتصال رسالة SMS عادية إلى رقم هاتفك الحالي. تصل الرسالة أولاً إلى الهاتف المتصل، ثم يقوم SMSMobileAPI بمزامنة البيانات المدعومة بشكل آمن حتى تتمكن تطبيقاتك من استرداد الرد وتصنيفه ومعالجته.
لا يستبدل أي رقم استقبال افتراضي هاتفك: يظل هاتفك المحمول، شريحة SIM والرقم الحالي في قلب التبادل.
Aجهة اتصال ترسل SMS
«هل يمكنك معاودة الاتصال بي؟»
+1 555 012 9841
هل يمكنك معاودة الاتصال بي؟
/getsms/200sms.received
number+15550129841
deviceهاتف المبيعات
statusجاهز
يستخدمه برنامجك
استرجع المُرسل، الرسالة، الهاتف المستلم، الطابع الزمني، GUID وalias الاختياري.
جَمّع الردود مركزيًا مع الاحتفاظ بمعلومية أي هاتف متصل استلم كل SMS.
الشرح البسيط
لا يستبدل API هاتفك. إنه يجعل SMS الواردة إليه قابلة للاستخدام.
يضيف SMSMobileAPI طبقة برمجية آمنة حول صندوق وارد الهاتف الحقيقي. وهذا يمنح نظام إدارة علاقات العملاء (CRM)، منصة الدعم أو التطبيق الداخلي لديك إمكانية الوصول إلى بيانات الرسائل المستلمة المؤهَلة دون تغيير الرقم الذي يستخدمه جهات الاتصال لديك.
جهة اتصال ترسل SMS
تكتب جهة الاتصال إلى الرقم الحقيقي المرتبط بشريحة SIM الخاصة بك.
يستقبله هاتفك المحمول.
تصل SMS عبر مزود خدمة الهاتف المحمول إلى الهاتف المتصل.
يقوم التطبيق بمزامنتها
مع الإذن المطلوب وإمكانية الوصول في الخلفية، يرسل التطبيق الرسمي بيانات الرسائل المدعومة إلى حسابك بأمان.
يستخدمه برنامجك
استرجعها باستخدام REST API، استلم حدث Webhook V2 أو اعرضها في تكامل متوافق.
استجابة يمكن لتطبيقك استخدامها
طلب واحد يعيد الرسالة والسياق اللازم لمعالجتها.
استخدم GET /getsms/ لسرد SMS الواردة والمتزامنة. صفِّها حسب الهاتف المستلم، اطلب الرسائل غير المقروءة فقط أو استرجع الرسائل بعد طابع زمني Unix.
- number
- المرسل بالصيغة الدولية عند توفرها.
- message
- نص SMS الذي تمت مزامنته من الهاتف المتصل.
- sIdentifiantPhone
- الهاتف المتصل الذي استلم SMS.
- timestamp_unix
- وقت الرسالة، جاهز للفرز والمزامنة التدريجية.
- guid
- مرجع رسالة ثابت لحالة القراءة وعمليات المتابعة.
- alias
- تسمية اختيارية لجهة الاتصال أو للتطبيق.
{
"result": {
"error": "",
"sms": [{
"sIdentifiantPhone": "508b004b4aadacc4",
"timestamp_unix": 1774041814,
"message": "Can you call me back?",
"number": "+15550129841",
"guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
"alias": "Alex Morgan"
}]
}
}اختر نمط التسليم المناسب
استرجع الرسائل عن طريق API — أو تفاعل فورًا باستخدام Webhook V2.
تستخدم الطريقتان نفس بيانات الهاتف المتصل. اختر وفقاً لطريقة عمل تطبيقك، أو اجمع بينهما لاستجابات سريعة واستعادة موثوقة.
يطلب تطبيقك الرسائل عندما يكون جاهزًا.
- بناء صندوق وارد أو مزامنة مجدولة
- التصفية حسب الهاتف أو الوقت أو حالة عدم القراءة
- استعادة الرسائل بعد انقطاع
SMSMobileAPI يرسل حدث sms.received إلى وجهة HTTPS الخاصة بك.
- تفاعل دون حلقة استطلاع
- استخدم تسليمًا مضمونًا وإعادة محاولات تلقائية
- ابدأ سير عمل بمجرد توفر الحدث
أكثر من مجرد قائمة رسائل
أنشئ سير عمل كامل لاستلام SMS.
/getsms/عرض SMS المستلمة
استخدم فلاتر الهاتف والطابع الزمني وحالة عدم القراءة لاسترجاع ما يحتاجه تطبيقك فقط.
/getsms/set-read/وضع علامة كمُعالَج
حدّث حالة القراءة في SMSMobileAPI API بعد أن يتعامل تطبيقك مع الرسالة.
/getsms/update/أرفق alias
ربط اسم جهة اتصال أو تسمية تطبيق برسالة مستلمة.
/conversation/sms/list/إنشاء محادثات
تجميع الرسائل الواردة والصادرة حسب رقم الهاتف لإنشاء تسلسل زمني للدعم أو إدارة علاقات العملاء.
وضع علامة 'مقروء' على رسالة عبر API لا يغيّر حالة قراءتها داخل تطبيق الرسائل على الهاتف.
ماذا يمكنك بناءه؟
من رد واحد إلى عملية أعمال متكاملة.
إنشاء صندوق وارد SMS مشترك
توجيه الردود من عدة هواتف مصرح لها إلى عرض دعم واحد مع الحفاظ على الهاتف المتلقي.
أكمل السجل الزمني لجهة الاتصال
أضف الردود الواردة إلى سجل العميل جنبًا إلى جنب مع SMS الصادرة ونشاط المكالمات المدعوم.
التعرف على التأكيدات تلقائيًا
كشف التأكيدات أو الإلغاءات أو طلبات إعادة الجدولة وتحديث الخطوة التالية.
تصعيد الرسائل المهمة
إخطار الشخص المناسب، استدعاء API أو بدء أتمتة Workflow Studio عندما تتطابق الشروط.
من الصفر إلى أول استجابة API
استلم أول SMS عبر API في أربع خطوات منظمة.
- 1
تثبيت وإقران الهاتف المحمول
ثبت تطبيق SMSMobileAPI الرسمي الأحدث وقم بربط الهاتف المتوافق بحسابك.
- 2
تمكين الوصول إلى الرسائل المستلمة عبر SMS
في تطبيق الهاتف، قم بتفويض مزامنة الرسائل المستلمة عبر SMS والتشغيل في الخلفية المطلوب لسير عملك.
- 3
أرسل رسالة اختبار فريدة
أرسل SMS من رقم آخر إلى الهاتف المتصل وتحقق منه في سجل لوحة التحكم للـ SMS المستلمة.
- 4
اتصل بنقطة النهاية بشكل آمن
احتفظ بمفتاح API على خادمك، استدعِ /getsms/ واحتفظ بالـ GUID حتى يتمكن تطبيقك من تجنّب المعالجة المكررة.
الأسئلة الشائعة حول استلام SMS بواسطة API
الأسئلة التي يطرحها المطوّرون وفرق التشغيل أولاً.
هل يستقبل API الـ SMS بدلاً من هاتفي المحمول؟
لا. يستقبل هاتفك المتوافق المتصل والبطاقة SIM الـ SMS أولاً. ثم يقوم SMSMobileAPI بمزامنة بيانات الرسالة المدعومة ليتمكن برنامجك من استرجاعها.
هل يمكن لعدة هواتف أن تزود نفس التطبيق؟
نعم. يمكن توصيل عدة هواتف مرخّصة إلى حساب واحد، ومعرّف الهاتف المستلم يمكّن تطبيقك من الحفاظ على مصدر كل رسالة.
هل أستخدم الاستطلاع أم Webhook V2؟
استخدم GET /getsms/ عندما يتحكّم تطبيقك في جدول الاسترجاع أو يحتاج إلى استرداد. استخدم حدث Webhook V2 الخاص بـ sms.received عندما تريد لوجهة HTTPS أن تتفاعل فور توافر الحدث. تدمج العديد من أنظمة الإنتاج بين الطريقتين.
كيف أتجنب معالجة نفس الرسالة مرتين؟
خزن معرّف GUID للرسالة في تطبيقك واجعل المعالجة متسقة (idempotent). بعد المعالجة الناجحة، يمكنك أيضاً تحديث حالة القراءة API الخاصة بـ SMSMobileAPI.
هل يؤدي تمييز رسالة كمقروءة إلى تغيير صندوق الوارد في الهاتف؟
لا. يقوم نقطة النهاية بتغيير حالة القراءة على جانب API المستخدمة في سير عمل SMSMobileAPI؛ لكنه لا يعلّم الرسالة كمقروءة داخل تطبيق الرسائل على الهاتف.
هل يمكنني الرد من تطبيقي؟
نعم. يمكن لتطبيقك استدعاء نقطة إرسال SMS ليقوم هاتف متصل محدد بإرسال الرد عبر بطاقته SIM ورقم هاتفه.
اجعل برنامجك يفهم كل رد مفيد يصل عبر هاتفك المحمول.
قم بتوصيل هاتف واحد، وفّعل مزامنة received-SMS واختبر رحلة الرسائل الكاملة قبل توسيعها إلى نظام CRM أو منصة الدعم أو أتمتة العمليات.
