كيفية إرسال رسائل SMS متعددة من PHP

أبسط طريقة لإرسال رسائل SMS من PHP هي استخدام واجهة برمجة تطبيقات HTTP/Rest المدمجة في بوابة Ozeki SMS. عند استخدام هذه الواجهة، ستقوم بإرسال رسائل SMS عن طريق إرسال طلب HTTP Post إلى بوابة SMS. سيحتوي طلب HTTP Post على رسالة مُنسقة بتنسيق json. ستقوم بوابة SMS بإرسال هذه الرسالة إلى هاتف المستلم، وستعيد رد HTTP 200 OK لطلبك.

كيفية إرسال رسائل SMS متعددة من PHP
الشكل 1 - كيفية إرسال رسائل SMS متعددة من PHP

كود PHP لإرسال رسائل SMS إلى الهاتف المحمول

يوضح مثال كود PHP لرسائل SMS أدناه كيفية إرسال رسائل SMS باستخدام واجهة برمجة تطبيقات HTTP Rest الخاصة ببوابة Ozeki SMS باستخدام مكتبة PHP Ozeki.Libs.Rest. هذه المكتبة مقدمة لك مجانًا، ويمكنك استخدامها وتعديلها في أي من مشاريعك.

SendSMS.cs
namespace Ozeki_PHP_Rest
{
require 'MessageApi/MessageApi.php';

		$configuration = new Configuration();
		
		$configuration -> Username = "http_user";
		$configuration -> Password = "qwe123";
		$configuration -> ApiUrl = "http://127.0.0.1:9509/api"; 	
		$msg1 = new Message();
		$msg2 = new Message();
		
		$msg1 -> ToAddress = "+36201111111";
		$msg1 -> Text = "Hello, World 1!";
		$msg2 -> ToAddress = "+36202222222";
		$msg2 -> Text = "Hello, World 2!";
			
		$api = new MessageApi($configuration);
		
		$result = $api -> SendMultiple([$msg1,$msg2]);	
		
		echo strval($result);
}		

كيفية استخدام مثال PHP لرسائل SMS:

يمكن استخدام هذا مثال PHP لرسائل SMS في أي تطبيق PHP. لاستخدامه، يجب عليك إضافة مجلد MessageApi إلى مشروعك. يمكنك استخدام فئة Message لإنشاء الرسالة، ويمكنك استخدام فئة MessageApi لإرسال الرسالة إلى بوابة SMS. ستقوم بوابة SMS بإعادة توجيه رسالتك إلى شبكة الهاتف المحمول إما عبر اتصال لاسلكي أو عبر الإنترنت.

تحميل Send-multiple-SMS.php

يمكن تنزيل الكود المصدري الموضح في هذه المقالة واستخدامه وتعديله مجانًا.
تحميل: Send_multiple_SMS.zip (3.62Kb)

ما الموجود في ملف Send-multiple-SMS.js.zip؟

يحتوي ملف Send-multiple-SMS.zip على مكتبة Ozeki.Libs.Rest، والتي تمنحك جميع الأدوات اللازمة لإرسال واستقبال رسائل SMS. ستجد أيضًا ملف SendMultipleSms في المشروع، والذي يحتوي على الكود التوضيحي ليوضح لك كيفية إرسال رسالة SMS. هذا الكود التوضيحي مدرج أدناه.

مشروع توضيحي لإرسال رسائل SMS متعددة باستخدام PHP
الشكل 2 - دليل Send-multiple-SMS

كيفية إرسال رسائل SMS من PHP (خطوات سريعة)

لإرسال رسائل SMS من PHP:

  1. قم بتثبيت بوابة Ozeki SMS
  2. قم بتوصيل بوابة Ozeki SMS بشبكة الهاتف المحمول
  3. أرسل رسالة SMS تجريبية من واجهة Ozeki
  4. قم بإنشاء مستخدم لواجهة برمجة تطبيقات HTTP لرسائل SMS
  5. ابدأ تشغيل خادم Wamp
  6. قم بتنزيل المثال أعلاه
  7. قم بإنشاء الرسالة عن طريق إنشاء كائن Message جديد
  8. استخدم طريقة SendSingle لإرسال رسالتك
  9. اقرأ رد HTTP
  10. تحقق من السجلات في بوابة SMS

قم بتثبيت بوابة Ozeki SMS وإنشاء مستخدم لواجهة برمجة تطبيقات HTTP

لتتمكن من إرسال رسائل SMS من PHP، تحتاج أولاً إلى تثبيت بوابة Ozeki SMS. يمكن تثبيت بوابة SMS على نفس الكمبيوتر الذي تقوم فيه بتطوير كود PHP. بعد التثبيت، تكون الخطوة التالية هي توصيل بوابة Ozeki SMS بشبكة الهاتف المحمول. يمكنك إنشاء مستخدم لواجهة برمجة تطبيقات HTTP لرسائل SMS. قم بإنشاء مستخدم باسم مستخدم "http_user"، وكلمة مرور "qwe123" لجعل المثال يعمل دون تعديل.

بعد إعداد البيئة، يمكنك تشغيل كود PHP الخاص بك.

رابط واجهة برمجة تطبيقات HTTP لإرسال رسائل SMS من PHP

لإرسال رسائل SMS من PHP، سيتعين على PHP الخاص بك إرسال طلب HTTP إلى بوابة SMS. يظهر رابط واجهة برمجة التطبيقات أدناه. لاحظ أنه يجب استبدال عنوان IP (127.0.0.1) بعنوان IP الخاص ببوابة SMS. إذا كانت بوابة Ozeki SMS مثبتة على نفس الكمبيوتر الذي يعمل عليه تطبيق C# لرسائل SMS، يمكن أن يكون هذا 127.0.0.1. إذا كانت مثبتة على كمبيوتر مختلف، فيجب أن يكون عنوان IP الخاص بهذا الكمبيوتر.

http://127.0.0.1:9509/api?action=rest

رأس طلب HTTP لإرسال رسائل SMS من PHP

لإرسال رسائل SMS، تحتاج إلى تضمين الأسطر التالية كرؤوس في طلب HTTP. لاحظ أننا نضمن نوع المحتوى ورأس Authorization.

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

طلب HTTP لإرسال الرسائل القصيرة من PHP

لإرسال الرسالة القصيرة، سيقوم تطبيق PHP الخاص بك بإرسال طلب HTTP مشابه للطلب أدناه. لاحظ أن هذا الطلب يتكون من جزء رأس HTTP وجزء جسم HTTP. جسم HTTP هو سلسلة بيانات مشفرة بتنسيق JSON. يحتوي على رقم المستلم ونص الرسالة.

طلب HTTP تم استلامه من 127.0.0.1:55788
POST /api?action=sendmsg HTTP/1.1
Content-Length: 856
Content-Type: application/json
Accept: */*
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509

{
  "messages": [
    {
      "message_id": "973c88f2-ae30-4b46-a4cd-e497151d38f3",
      "from_connection": null,
      "from_address": null,
      "from_station": null,
      "to_connection": null,
      "to_address": "+36201111111",
      "to_station": null,
      "text": "مرحبًا بالعالم 1!",
      "create_date": "2021-06-16 12:18:04",
      "valid_until": "2021-06-23 12:18:04",
      "time_to_send": "2021-06-16 12:18:04",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    },
    {
      "message_id": "dd910a4f-9172-4f35-9231-8dc83a5fc401",
      "from_connection": null,
      "from_address": null,
      "from_station": null,
      "to_connection": null,
      "to_address": "+36202222222",
      "to_station": null,
      "text": "مرحبًا بالعالم 2!",
      "create_date": "2021-06-16 12:18:04",
      "valid_until": "2021-06-23 12:18:04",
      "time_to_send": "2021-06-16 12:18:04",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    }
  ]
}

استجابة HTTP المستلمة من مثال PHP لإرسال الرسائل القصيرة

بمجرد أن يستقبل بوابة الرسائل القصيرة هذا الطلب، ستقوم بإنشاء استجابة HTTP. ستحتوي استجابة HTTP على رمز حالة، للإشارة إلى ما إذا كان طلب إرسال الرسالة القصيرة ناجحًا أم لا. كما ستعود أيضًا بهيكل مشفر بتنسيق JSON لتزويدك بتفاصيل مفيدة حول إرسال الرسالة.

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.116 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Wed, 16 Jun 2021 10:04:01 GMT
Server: 10/10.3.116
Transfer-Encoding: chunked

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "تم وضع الرسائل في قائمة الانتظار للتسليم.",
  "data": {
    "total_count": 2,
    "success_count": 2,
    "failed_count": 0,
	"messages": [
      {
        "message_id": "63d2303d-9add-44d3-afd6-f27d6b6966ba",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "مرحبًا بالعالم 1!",
        "create_date": "2021-06-16 12:18:04",
        "valid_until": "2021-06-23 12:18:04",
        "time_to_send": "2021-06-16 12:18:04",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      },
      {
        "message_id": "f393dd6c-6d6c-4b87-b069-78166a25b894",
        "from_station": "%",
        "to_address": "+36202222222",
        "to_station": "%",
        "text": "مرحبًا بالعالم 2!",
        "create_date": "2021-06-16 12:18:04",
        "valid_until": "2021-06-23 12:18:04",
        "time_to_send": "2021-06-16 12:18:04",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}

كيفية إرسال الرسائل القصيرة من PHP باستخدام واجهة برمجة تطبيقات الرسائل القصيرة في PHP (فيديو تعليمي)

يُظهر لك هذا الفيديو كيفية تنزيل واستخدام مشروع SendSMS php. بمجرد إضافة الملفات المطلوبة إلى مشروعك، قد تلاحظ وجود ملف يسمى MessageApi.php. هذا هو الملف الذي يحتوي على MessageApi وكل الأشياء التي تحتاجها لإرسال رسالة قصيرة باستخدام PHP.

الفيديو 1 - كيفية إرسال الرسائل القصيرة من PHP باستخدام واجهة برمجة تطبيقات الرسائل القصيرة في PHP (فيديو تعليمي)

مثال PHP للرسائل القصيرة: Send_Message.php

الشكل 3 - Send_Message.php

كيفية التحقق من قبول HTTP user للرسالة القصيرة

بعد إرسال الرسالة القصيرة، من الجيد التحقق من بوابة الرسائل القصيرة الخاصة بك، لمعرفة ما تم استلامه. يمكنك التحقق من السجل عن طريق فتح تفاصيل HTTP user من وحدة تحكم إدارة بوابة Ozeki للرسائل القصيرة. يُظهر لك الفيديو التالي ما يجب البحث عنه.

الفيديو 2 - كيفية إرسال الرسائل القصيرة باستخدام كود PHP أعلاه (فيديو تعليمي)

كيفية التحقق من إرسال الرسالة القصيرة إلى شبكة الهاتف المحمول

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

الفيديو 3 - كيفية تفعيل التسجيل في بوابة Ozeki للرسائل القصيرة

لتفعيل التسجيل في HTTP user، يجب عليك اتباع نفس التعليمات.

ملخص

يحتوي هذا الدليل على جميع المعلومات الأساسية حول كيفية إرسال رسائل SMS متعددة من PHP باستخدام واجهة برمجة تطبيقات REST SMS عبر HTTP الخاصة بـ Ozeki SMS Gateway. ستجد استخدام واجهة برمجة تطبيقات SMS في PHP مفيدًا جدًا لأنها لا تعمل فقط مع مزودي خدمات SMS عبر الإنترنت؛ بل تعمل أيضًا مع بوابة SMS للأندرويد لتسمح لك بإرسال رسائل SMS لاسلكيًا. يمكن لهذه الخدمة جعل مراسلتك أكثر كفاءة لأنها تتيح لك إرسال معلومات قيمة إلى أكثر من هاتف محمول في وقت واحد.

يمكنك العثور على المزيد من الأدلة مثل هذا على موقع Ozeki الإلكتروني، فلنتعلم المزيد! اكتشف كيف يمكنك استخدام PHP لأغراض أخرى، ابدأ بإرسال رسائل SMS مجدولة.

قم بإعداد Ozeki SMS Gateway الآن وطبق ما تعلمته!

More information