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

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

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

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

يوضح مثال كود PHP لإرسال الرسائل القصيرة أدناه كيفية إرسال الرسائل القصيرة باستخدام واجهة برمجة تطبيقات HTTP Rest الخاصة بـ Ozeki SMS Gateway باستخدام مكتبة 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://192.168.0.113:9509/api";
		
		$msg = new Message();
		
		$msg -> ToAddress = "+36201111111";
		$msg -> Text = "Hello, World!";
			
		$api = new MessageApi($configuration);
		
		$result = $api -> SendSingle($msg);	
		
		echo strval($result);
}

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

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

تحميل SendSMS.php

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

ما الموجود في ملف SendSMS.zip؟

يحتوي ملف SendSMS.zip على مكتبة Ozeki.Libs.Rest.Php، والتي تمنحك جميع الأدوات اللازمة لإرسال واستقبال رسائل SMS. ستجد أيضًا مشروع SendSMS في الملف المضغوط، والذي يحتوي على كود المثال ليوضح لك كيفية إرسال رسالة SMS. تم سرد كود المثال هذا أدناه.

الشكل 2 - ما الموجود داخل SendSMS.zip

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

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

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

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

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

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

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

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

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

HTTP request received from 192.168.0.113:62101
POST /api?action=sendmsg HTTP/1.1
Content-Length: 433
Content-Type: application/json
Accept: */*
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 192.168.0.113:9509

{
  "messages": [
    {
      "message_id": "f259f9de-bc27-4794-8d2b-691af76b551b",
      "from_connection": null,
      "from_address": null,
      "from_station": null,
      "to_connection": null,
      "to_address": "+36201111111",
      "to_station": null,
      "text": "Hello, World!",
      "create_date": "2021-06-15 15:10:16",
      "valid_until": "2021-06-22 15:10:16",
      "time_to_send": "2021-06-15 15:10:16",
      "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.118 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Mon, 14 Jun 2021 07:43:45 GMT
Server: 10/10.3.118
Transfer-Encoding: chunked

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "Messages queued for delivery.",
  "data": {
    "total_count": 1,
    "success_count": 1,
    "failed_count": 0,
    "messages": [
      {
        "message_id": "a451446c-db80-4009-b51d-31d0675e28c4",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Hello, World!",
        "create_date": "2021-06-15 15:10:16",
        "valid_until": "2021-06-22 15:10:16",
        "time_to_send": "2021-06-15 15:10:16",
        "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 للرسائل القصيرة: Send_Message.php

الشكل 2 - Send_Message.php

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

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

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

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

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

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

لتشغيل التسجيل في مستخدم HTTP، يجب عليك اتباع نفس التعليمات.

أفكار أخيرة

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

هناك المزيد من المقالات لمساعدتك، لذا تأكد من قراءتها. ابدأ بتلك التي تحمل عنوان كيفية إرسال رسائل متعددة من PHP وضاعف فرصك.

ابدأ باستخدام بوابة Ozeki للرسائل القصيرة الآن! كل شيء موجود لإعدادها وتشغيلها في دقائق معدودة.

More information