تعليمات إعداد SMS API: دليل خطوة بخطوة لـ MySMSGate

لا يجب أن يكون إعداد واجهة برمجة تطبيقات الرسائل القصيرة (SMS API) مسعى معقدًا أو مكلفًا. يقدم هذا الدليل الشامل تعليمات واضحة خطوة بخطوة لإعداد SMS API خصيصًا لـ MySMSGate، مما يمكّن المطورين والشركات الصغيرة من دمج إمكانيات الرسائل القصيرة القوية في تطبيقاتهم وسير عملهم. تعلم كيفية الاستفادة من هواتف Android الخاصة بك للحصول على مراسلات موثوقة وفعالة من حيث التكلفة.

الخطوة 1: فهم ميزة MySMSGate

قبل الغوص في الإعداد الفني، من الضروري فهم سبب تميز MySMSGate. على عكس بوابات الرسائل القصيرة التقليدية التي تعتمد على رموز قصيرة مشتركة أو تسجيل 10DLC صارم، يحوّل MySMSGate هواتف Android الخاصة بك وبطاقات SIM الخاصة بها إلى بوابات رسائل قصيرة شخصية. يقدم هذا النهج فوائد كبيرة:

• فعالية التكلفة: أرسل الرسائل القصيرة بسعر 0.03 دولار فقط للرسالة، بدون رسوم شهرية أو عقود. غالبًا ما يكون هذا أرخص بكثير من المنافسين مثل Twilio (0.05 دولار - 0.08 دولار / رسالة قصيرة بالإضافة إلى الرسوم).
• لا يلزم تسجيل المرسل: تجنب عمليات 10DLC المعقدة، وعمليات موافقة شركات الاتصالات، والرسوم المرتبطة بها. أنت تستخدم بطاقة SIM المحلية الخاصة بك.
• الموثوقية: يضمن الإرسال المباشر عبر بطاقة SIM بهاتفك قابلية تسليم عالية، خاصة للجهات المحلية.
• المرونة: قم بتوصيل عدد غير محدود من الأجهزة، واستخدم بطاقتي SIM، وقم بإدارة كل شيء من لوحة تحكم ويب واحدة.

تم تصميم MySMSGate من أجل التطبيق العملي وفعالية التكلفة، مما يجعله خيارًا مثاليًا للشركات الصغيرة والمستقلين والمطورين المستقلين.

الخطوة 2: إنشاء حسابك على MySMSGate

الخطوة الأولى في إعداد SMS API الخاص بك هي إنشاء حساب على منصة MySMSGate. هذه العملية سريعة ومباشرة.

1. انتقل إلى صفحة التسجيل في MySMSGate.
2. أدخل عنوان بريدك الإلكتروني واختر كلمة مرور آمنة.
3. أكد عنوان بريدك الإلكتروني.
4. بمجرد التسجيل، ستتم إعادة توجيهك إلى لوحة تحكم MySMSGate الشخصية الخاصة بك.

لوحة التحكم الخاصة بك هي المركز الرئيسي لإدارة أجهزتك المتصلة، وعرض سجلات الرسائل، والوصول إلى مفتاح API الخاص بك. ستتلقى أيضًا رصيدًا صغيرًا لاختبار الخدمة فور التسجيل.

الخطوة 3: توصيل هاتف (هواتف) Android الخاص بك

هنا يأتي دور نهج MySMSGate الفريد. ستقوم بتوصيل هاتف (هواتف) Android الخاص بك ليعمل كأجهزة إرسال واستقبال الرسائل القصيرة.

1. تثبيت تطبيق MySMSGate لنظام Android: على هاتف Android الخاص بك، ابحث عن "MySMSGate" في Google Play Store وقم بتثبيت التطبيق الرسمي.
2. مسح رمز الاستجابة السريعة (QR Code): من لوحة تحكم الويب الخاصة بـ MySMSGate، حدد قسم "Connect Device" (توصيل الجهاز). ستظهر لك رمز QR فريد. افتح تطبيق MySMSGate على هاتف Android الخاص بك واضغط على زر "Scan QR Code" (مسح رمز QR). وجّه كاميرا هاتفك نحو رمز QR على شاشة الكمبيوتر الخاص بك.
3. التأكيد: بمجرد مسح رمز QR بنجاح، سيتصل هاتفك على الفور بحساب MySMSGate الخاص بك. ستظهر لك قائمه بجهازك في لوحة التحكم، بالإضافة إلى بطاقات SIM المتاحة فيه.

يمكنك تكرار هذه العملية لعدد ما تحتاجه من هواتف Android. يعمل كل هاتف متصل كبوابة رسائل قصيرة مستقلة، ويمكنك اختيار الجهاز وحتى فتحة بطاقة SIM التي ستستخدمها لكل رسالة مباشرة من لوحة التحكم الخاصة بك أو عبر API.

الخطوة 4: تحديد موقع مفتاح API الخاص بك ومعرفات الأجهزة

لإرسال الرسائل القصيرة عبر API، ستحتاج إلى معلومتين حاسمتين: مفتاح API الخاص بك ومعرف الجهاز الذي ترغب في الإرسال منه.

1. مفتاح API: في لوحة تحكم MySMSGate الخاصة بك، انتقل إلى قسم "API Settings" (إعدادات API) أو "Developer" (المطور). سيتم عرض مفتاح API الفريد الخاص بك هناك. حافظ على أمان هذا المفتاح، حيث يقوم بمصادقة جميع طلبات API الخاصة بك.
2. معرفات الأجهزة (Device IDs): ضمن قسم "Devices" (الأجهزة) في لوحة التحكم الخاصة بك، سترى قائمة بجميع هواتف Android المتصلة لديك. سيكون لكل هاتف "معرف جهاز" (Device ID) فريد. دوّن معرف الجهاز الذي تنوي استخدامه لإرسال الرسائل القصيرة. إذا كان هاتفك يحتوي على بطاقتي SIM، فسترى أيضًا خياري "SIM Slot 1" و "SIM Slot 2" لتحديد بطاقة SIM التي ستستخدمها.

ستُستخدم هذه البيانات في كل طلب API لمصادقة حسابك وتوجيه رسائلك إلى جهاز الإرسال الصحيح.

الخطوة 5: إرسال أول رسالة نصية قصيرة (SMS) عبر API

بعد إعداد حسابك، وتوصيل الهاتف، والحصول على بيانات الاعتماد، أنت جاهز لإرسال أول رسالة نصية قصيرة (SMS) باستخدام واجهة برمجة تطبيقات REST الخاصة بـ MySMSGate. تم تصميم واجهة برمجة التطبيقات (API) للبساطة، وتتطلب نقطة نهاية POST واحدة فقط.

نقطة النهاية لإرسال الرسائل هي: https://mysmsgate.net/api/v1/send

يجب أن يكون نص الطلب بصيغة JSON وأن يتضمن:

• api_key: مفتاح API الفريد الخاص بك في MySMSGate.
• device_id: معرف هاتف Android المتصل الذي سيتم استخدامه.
• number: رقم هاتف المستلم (مع رمز الدولة، على سبيل المثال، +12345678900).
• message: محتوى الرسالة النصية القصيرة الخاصة بك.
• sim_slot (اختياري): حدد 1 أو 2 إذا كنت تستخدم هاتفًا ببطاقتي SIM. القيمة الافتراضية هي 1.

فيما يلي أمثلة بلغات برمجة مختلفة:

مثال cURL

curl -X POST https://mysmsgate.net/api/v1/send \   -H "Content-Type: application/json" \   -d '{     "api_key": "YOUR_API_KEY",     "device_id": "YOUR_DEVICE_ID",     "number": "+12345678900",     "message": "Hello from MySMSGate API!",     "sim_slot": 1   }'

مثال Python

import requests  api_key = "YOUR_API_KEY" device_id = "YOUR_DEVICE_ID" recipient_number = "+12345678900" message_text = "Hello from MySMSGate in Python!" sim_slot = 1  url = "https://mysmsgate.net/api/v1/send" headers = {"Content-Type": "application/json"} data = {     "api_key": api_key,     "device_id": device_id,     "number": recipient_number,     "message": message_text,     "sim_slot": sim_slot }  try:     response = requests.post(url, json=data, headers=headers)     response.raise_for_status() # Raise an exception for HTTP errors (4xx or 5xx)     print("SMS sent successfully:", response.json()) except requests.exceptions.RequestException as e:     print(f"An error occurred: {e}")     if response is not None:         print("Response content:", response.text)

مثال Node.js

const axios = require('axios'); // or use node-fetch or native http/https  const apiKey = "YOUR_API_KEY"; const deviceId = "YOUR_DEVICE_ID"; const recipientNumber = "+12345678900"; const messageText = "Hello from MySMSGate in Node.js!"; const simSlot = 1;  const url = "https://mysmsgate.net/api/v1/send"; const headers = {"Content-Type": "application/json"}; const data = {   api_key: apiKey,   device_id: deviceId,   number: recipientNumber,   message: messageText,   sim_slot: simSlot, };  axios.post(url, data, { headers })   .then(response => {     console.log("SMS sent successfully:", response.data);   })   .catch(error => {     console.error("An error occurred:", error.response ? error.response.data : error.message);   });

للمزيد من المعلومات التفصيلية وأمثلة الأكواد الإضافية (PHP, Go, Ruby)، يرجى الرجوع إلى وثائق MySMSGate API الرسمية.

الخطوة 6: استقبال الرسائل القصيرة وتتبع حالة التسليم

لا يقتصر دور MySMSGate على إرسال الرسائل فحسب؛ بل يقوم أيضًا بإعادة توجيه جميع الرسائل القصيرة الواردة التي تتلقاها هواتف Android المتصلة بك مباشرةً إلى لوحة تحكم الويب الخاصة بك. للتكامل في الوقت الفعلي مع تطبيقاتك، يمكنك استخدام webhooks.

الرسائل القصيرة الواردة

يتم تسجيل جميع الرسائل المستلمة على هواتفك المتصلة تلقائيًا في لوحة تحكم MySMSGate الخاصة بك ضمن قسم "المحادثات". يمكنك عرضها في واجهة تشبه الدردشة، وحتى الرد عليها مباشرة من متصفحك.

تتبع التسليم عبر Webhooks

للحصول على تحديثات في الوقت الفعلي حول حالة تسليم الرسائل (مثل: مرسلة، تم تسليمها، فشلت)، يمكنك إعداد webhooks. في "API Settings" (إعدادات API) بلوحة تحكم MySMSGate الخاصة بك، يمكنك تحديد عنوان URL حيث سترسل MySMSGate طلبات POST مع تحديثات الحالة لكل رسالة. يتيح هذا لتطبيقك التفاعل فورًا مع أحداث الرسائل.

يقوم MySMSGate أيضًا برد رصيدك تلقائيًا لأي رسائل قصيرة فاشلة، مما يضمن أنك تدفع فقط مقابل الرسائل التي تم تسليمها بنجاح.

الخطوة 7: استكشاف الميزات المتقدمة وعمليات الدمج

بالإضافة إلى إرسال الرسائل القصيرة الأساسي، يقدم MySMSGate مجموعة من الميزات وعمليات الدمج لتحسين سير عمل رسائلك.

• المحادثات عبر الويب: أدر جميع محادثات الرسائل القصيرة الخاصة بك مباشرة من متصفحك، مما يسهل على المستخدمين غير التقنيين التفاعل مع العملاء.
• إدارة الأجهزة المتعددة: إذا كان لديك فروع أو أرقام متعددة، قم بتوصيل جميع هواتف Android الخاصة بك وإدارتها من لوحة تحكم واحدة وموحدة. اختر الجهاز وفتحة بطاقة SIM للإرسال منها لكل محادثة.
• عمليات دمج بدون أكواد: يتكامل MySMSGate بسلاسة مع منصات الأتمتة الشائعة مثل Zapier و Make.com و n8n. يتيح لك هذا أتمتة المهام مثل إرسال تذكيرات بالمواعيد، أو تأكيدات الطلبات، أو كلمات المرور لمرة واحدة (OTPs) دون كتابة أي كود. يمكنك العثور على أدلة مفصلة على صفحة التكاملات الخاصة بنا.
• تطبيق Android كبرنامج مراسلة: يعمل تطبيق MySMSGate لنظام Android أيضًا كبرنامج مراسلة رسائل قصيرة كامل الميزات، مما يوفر واجهة مألوفة لإدارة الرسائل مباشرة على الهاتف.

تجعل هذه الميزات MySMSGate أداة متعددة الاستخدامات لكل من المطورين الذين يبحثون عن وصول قوي إلى API والشركات التي تحتاج إلى واجهة ويب بديهية لاتصالاتهم عبر الرسائل القصيرة.

لماذا MySMSGate هو الخيار الذكي لاحتياجاتك من SMS API

عند النظر في تعليمات إعداد SMS API، يؤثر اختيار المزود بشكل كبير على التكلفة والتعقيد والامتثال. يقدم MySMSGate بديلاً مقنعًا للمزودين التقليديين، خاصة للشركات الصغيرة والمتوسطة والمطورين الأفراد.

يلغي نموذج MySMSGate المتاعب والتكاليف المرتفعة المرتبطة بواجهات برمجة تطبيقات الرسائل القصيرة التقليدية، ويوفر حلاً موثوقًا وسهل الاستخدام للمطورين لجميع احتياجات المراسلة الخاصة بك.

الأسئلة المتكررة

هل إعداد MySMSGate API صعب؟

لا، تم تصميم MySMSGate API للبساطة. بفضل تعليمات إعداد SMS API الواضحة، يمكنك توصيل هاتف Android الخاص بك عبر رمز QR والبدء في إرسال الرسائل باستخدام نقطة نهاية REST API واحدة في غضون دقائق. نحن نقدم أمثلة أكواد للغات الشائعة لجعل التكامل أسهل.

هل أحتاج إلى رقم هاتف خاص لـ MySMSGate؟

لا، يستخدم MySMSGate هاتف (هواتف) Android الحالي وبطاقات SIM الخاصة بهم. لا تحتاج إلى شراء أو توفير أرقام جديدة. يتم إرسال رسائلك مباشرة من بطاقة SIM بهاتفك، مما يمنحك تحكمًا كاملاً في هوية المرسل.

ما هي التكاليف المرتبطة بـ MySMSGate؟

يعمل MySMSGate بنموذج الدفع حسب الاستخدام بسعر 0.03 دولار لكل رسالة نصية قصيرة، مع باقات مثل 100 رسالة مقابل 3 دولارات، 500 رسالة مقابل 12 دولارًا، أو 1000 رسالة مقابل 20 دولارًا. لا توجد رسوم شهرية، ولا عقود، ويتم استرداد رصيدك تلقائيًا لأي رسائل فاشلة، مما يضمن أنك تدفع فقط مقابل الرسائل التي تم تسليمها بنجاح.

هل يمكنني استقبال الرسائل القصيرة عبر MySMSGate API؟

نعم، يتم إعادة توجيه جميع رسائل SMS الواردة التي تتلقاها هواتف Android المتصلة بك تلقائيًا إلى لوحة تحكم الويب الخاصة بـ MySMSGate. للمعالجة في الوقت الفعلي في تطبيقك، يمكنك تكوين webhooks لتلقي الإشعارات كلما وصلت رسالة جديدة أو تغيرت حالة التسليم.

هل MySMSGate مناسب للرسائل القصيرة الجماعية أو الحملات التسويقية؟

بينما يمكن لـ MySMSGate التعامل مع احتياجات المراسلة المتنوعة، إلا أنه مصمم بشكل أساسي للرسائل القصيرة للمعاملات، والإشعارات، والاتصالات المخصصة حيث تكون الفعالية من حيث التكلفة والإرسال المباشر عبر بطاقة SIM أمرًا بالغ الأهمية. بالنسبة للتسويق بكميات كبيرة جدًا والتواصل البارد، قد يقدم مزودو الرسائل القصيرة الجماعية التقليديون ميزات مختلفة، لكن MySMSGate يتفوق في السيناريوهات التي تتطلب اتصالًا ثنائي الاتجاه موثوقًا ومباشرًا وبأسعار معقولة دون متاعب 10DLC أو تسجيل المرسل.