كيفية جدولة رسالة SMS في دلفي

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

كيفية جدولة رسالة sms في دلفي
الشكل 1 - كيفية جدولة رسالة SMS في دلفي

كود دلفي لإرسال رسالة SMS إلى الهاتف المحمول

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

SendScheduledSms.delphi 
program SendScheduledSms;

{$APPTYPE CONSOLE}

{$R *.res}

uses
  System.SysUtils,
  Ozeki.Libs.Rest in 'Ozeki.Libs.Rest.pas';

var configuration : Ozeki.Libs.Rest.Configuration;
var msg : Ozeki.Libs.Rest.Message;
var api : Ozeki.Libs.Rest.MessageApi;
var result : MessageSendResult;
var read : string;

begin
  try
    configuration := Ozeki.Libs.Rest.Configuration.Create;
    configuration.Username := 'http_user';
    configuration.Password := 'qwe123';
    configuration.ApiUrl := 'http://127.0.0.1:9509/api';

    msg := Ozeki.Libs.Rest.Message.Create;
    msg.ToAddress := '+36201111111';
    msg.Text := 'Hello world!';
    msg.TimeToSend := StrToDateTime('7/27/21 4:00:00 PM');

    api := Ozeki.Libs.Rest.MessageApi.Create(configuration);

    result := api.SendMessage( msg );

    Writeln(result.ToString());

    Readln(read);
  except
    on E: Exception do
      Writeln(E.ClassName, ': ', E.Message);
  end;
end.

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

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

تحميل SendScheduledSms.delphi

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

ما الموجود في ملف SendScheduledSms.delphi.zip؟

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

إرسال رسائل sms متعددة دليل دلفي
الشكل 2 - ما الموجود داخل SendScheduledSms.delphi.zip

كيفية إرسال SMS من دلفي (إرشادات بسيطة)

لإرسال SMS من دلفي:

  1. تثبيت مستخدم HTTP API
  2. تمكين تسجيل أحداث الاتصال في علامة التبويب المتقدمة
  3. إعداد Embarcadero Delphi Studio
  4. تنزيل ثم استخراج ملف SendScheduledSms.delphi.zip
  5. فتح ملف SendScheduledSms.dproj في Delphi Studio بالنقر عليه مرتين
  6. تشغيل تطبيق Ozeki SMS Gateway
  7. تشغيل كود دلفي SendScheduledSms.dpr في Delphi Studio
  8. التحقق من السجلات لمعرفة ما إذا تم إرسال الرسالة

تثبيت Ozeki SMS Gateway وإنشاء مستخدم HTTP API

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

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

رابط HTTP API لاستخدام إرسال SMS من دلفي

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

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

مصادقة HTTP لإرسال الرسائل القصيرة من دلفي

لمصادقة عميل الرسائل القصيرة في دلفي، تحتاج إلى إرسال اسم المستخدم وكلمة المرور في سلسلة مشفرة بـ base64 إلى الخادم عبر طلب HTTP. التنسيق المستخدم هو: base64(اسم المستخدم+":"+كلمة المرور). في دلفي يمكنك استخدام الكود التالي لإجراء هذا التشفير: 

var usernamePassword := username + ':' + password;
var Encoder := TBase64Encoding.Create();
var usernamePasswordEncoded := Encoder.Encode(usernamePassword);
result := Format('Basic %s', [usernamePasswordEncoded]);

على سبيل المثال، إذا قمت بتشفير اسم المستخدم 'http_user' وكلمة المرور 'qwe123'، ستحصل على السلسلة المشفرة التالية بـ base64: aHR0cF91c2VyOnF3ZTEyMw==. للإرسال

رأس طلب HTTP لإرسال الرسائل القصيرة من دلفي

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

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

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

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

POST /api?action=sendmsg HTTP/1.0
Connection: keep-alive
Content-Type: application/json
Content-Length: 412
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
Accept: application/json
User-Agent: Mozilla/3.0 (compatible; Indy Library)

{
	"messages": [ 
		{
			"message_id": "910663ad-85d8-44cc-aad3-8a5da4024148",
			"from_connection": "",
			"from_address": "",
			"from_station": "",
			"to_connection": "",
			"to_address": "+36201111111",
			"to_station": "",
			"text": "Hello world!",
			"create_date": "2021-07-27T15:35:39",
			"valid_until": "2021-08-03T15:35:39",
			"time_to_send": "2021-07-27T14:00:00",
			"submit_report_requested": true,
			"delivery_report_requested": true,
			"view_report_requested": true
		}
	]
}

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

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

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf8
Last-Modified: Tue, 27 Jul 2021 15:09:55 GMT
Server: 10/10.3.123 Microsoft-HTTPAPI/2.0
User-Agent: OZEKI 10.3.123 (myozeki.com)
Date: Tue, 27 Jul 2021 13:35:39 GMT
Connection: close

{
  "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": "910663ad-85d8-44cc-aad3-8a5da4024148",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Hello world!",
        "create_date": "2021-07-27 15:35:39",
        "valid_until": "2021-08-03 15:35:39",
        "time_to_send": "2021-07-27 14:00:00",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}

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

يُظهر لك هذا الفيديو كيفية تنزيل ملف SendScheduledSms.delphi.zip من هذه الصفحة، وكيفية تنزيل محتوياته في استوديو دلفي. إذا شاهدت الفيديو، ستلاحظ أن محتويات ملف SendScheduledSms.delphi.zip موضوعة على سطح مكتب Windows. ستلاحظ أيضًا أننا نضغط مرتين على ملف المشروع SendScheduledSms.dproj لفتح المشروع.

الفيديو 1 - كيفية تنزيل وتشغيل مشروع المثال (فيديو تعليمي)

مثال دلفي للرسائل القصيرة: SendScheduledSms.dproj

في هذا الحل يوجد مشروع واحد فقط: SendScheduledSms.dproj، وملفان: SendScheduledSms.dpr و Ozeki.Libs.Rest.pas.

الشكل 3 - SendScheduledSms.dproj

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

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

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

خلاصة القول

هذه المقالة كُتبت لتعليمك كيفية إرسال رسائل SMS مجدولة من دلفي باستخدام مستخدم واجهة برمجة التطبيقات (API) HTTP لبوابة Ozeki للرسائل القصيرة. يمكن استخدام مثال دلفي هذا في أي تطبيق دلفي، للتأكد من أنه يلبي توقعاتك. يقدم طرق استدعاء مكتوبة بشكل صحيح لإرسال رسالة SMS وفئة SMS مصممة جيدًا تسمح لك بتكوين معلمات الرسالة.

إذا وجدت هذه المقالة مفيدة - وأنا متأكد من ذلك - لا تتوقف هنا، ابحث عن المزيد لقراءته على صفحة Ozekي الإلكترونية. تحقق من برنامج دلفي التعليمي حول كيفية استلام رسالة SMS.

للاستفادة مما تعلمته، قم بتنزيل بوابة Ozeki للرسائل القصيرة الآن!

More information