كيفية إرسال الرسائل القصيرة من هاتف أندرويد عبر API

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

المفهوم

تقوم واجهات برمجة تطبيقات الرسائل القصيرة التقليدية (Twilio, MessageBird) بتوجيه الرسائل عبر شركات الاتصالات. أنت تستأجر رقم هاتف وتدفع مقابل كل رسالة بالإضافة إلى رسوم شهرية.

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

ما تحتاجه

• هاتف أندرويد (8.0+) مزود ببطاقة SIM نشطة
• حساب MySMSGate (مجاني الإنشاء)
• تطبيق MySMSGate للأندرويد
• اتصال Wi-Fi أو بيانات جوال للهاتف

الخطوة 1: إنشاء حسابك

اذهب إلى mysmsgate.net/auth/register وقم بالتسجيل. ستحصل على 10 رسائل قصيرة مجانية للاختبار — لا حاجة لبطاقة ائتمان.

بعد التسجيل، سترى مفتاح API الخاص بك في لوحة التحكم. قم بنسخه — ستحتاجه للتطبيق ولاستدعاءات API.

الخطوة 2: تثبيت تطبيق الأندرويد

قم بتنزيل وتثبيت تطبيق MySMSGate على هاتف أندرويد الخاص بك:

• تنزيل ملف APK مباشر
• جوجل بلاي (اختبار)

افتح التطبيق، انتقل إلى إعدادات البوابة (Gateway settings)، وأدخل مفتاح API الخاص بك. سيتصل التطبيق بالخادم وسيظهر "متصلاً" (online) في لوحة التحكم الخاصة بك.

الخطوة 3: إرسال الرسائل القصيرة عبر API

الآن يمكنك إرسال الرسائل القصيرة باستدعاء API واحد:

cURL

curl -X POST https://mysmsgate.net/api/v1/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+1234567890",
    "message": "Your appointment is tomorrow at 3 PM"
  }'

بايثون

import requests

response = requests.post(
    "https://mysmsgate.net/api/v1/send",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "to": "+1234567890",
        "message": "Your appointment is tomorrow at 3 PM"
    }
)
print(response.json())

جافاسكريبت (Node.js)

const response = await fetch("https://mysmsgate.net/api/v1/send", {
    method: "POST",
    headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        to: "+1234567890",
        message: "Your appointment is tomorrow at 3 PM"
    })
});
const data = await response.json();
console.log(data);

PHP

$ch = curl_init("https://mysmsgate.net/api/v1/send");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_KEY",
        "Content-Type: application/json"
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "to" => "+1234567890",
        "message" => "Your appointment is tomorrow at 3 PM"
    ]),
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($ch);
echo $response;

الخطوة 4: التحقق من حالة التسليم

تُرجع واجهة برمجة التطبيقات (API) معرف رسالة قصيرة (SMS ID) يمكنك استخدامه للتحقق من حالة التسليم:

curl https://mysmsgate.net/api/v1/sms?id=SMS_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

الحالات: pending ← sending ← sent (أو failed مع رسالة خطأ).

ميزات متقدمة: شريحتي اتصال وأجهزة متعددة

إذا كان هاتفك يحتوي على شريحتي اتصال (SIM cards)، يمكنك اختيار أي واحدة ترسل منها:

curl -X POST https://mysmsgate.net/api/v1/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+1234567890",
    "message": "Hello!",
    "sim_slot": 1
  }'

يمكنك أيضاً ربط عدة هواتف بالحساب نفسه وتوجيه الرسائل إلى أجهزة محددة:

{
  "to": "+1234567890",
  "message": "Hello!",
  "device_id": "your-device-id"
}

ماذا يحدث عندما يكون الهاتف غير متصل بالإنترنت؟

يتم وضع الرسائل في قائمة انتظار على الخادم. عندما يعيد الهاتف الاتصال بالإنترنت، فإنه يلتقط الرسائل المعلقة تلقائياً ويرسلها. يرسل الخادم أيضاً إشعار دفع (FCM) لإيقاظ الهاتف إذا كان في وضع السكون.

مقارنة التكلفة

لـ 500 رسالة قصيرة شهرياً:

هذا يوفر أكثر من 300 دولار أمريكي سنوياً — وتحتفظ برقم هاتفك الخاص.

جرّبها مجاناً — تتضمن 10 رسائل قصيرة، لا تتطلب بطاقة ائتمان.