كيفية إرسال رسائل SMS من C# باستخدام HTTP

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

ما هو واجهة برمجة تطبيقات SMS لـ C#؟

واجهة برمجة تطبيقات SMS لـ C# هي أداة رائعة تمكنك من إرسال رسائل SMS من أي نوع من المشاريع أو التطبيقات المستندة إلى C# عن طريق بدء طلبات HTTP وإرسالها إلى بوابة SMS.

المتطلبات الأساسية

• Visual Studio 2019 Community Edition مثبت
• Ozeki 10 SMS Gateway مثبت
• حساب مستخدم HTTP API مُهيأ

إرسال رسائل SMS من C#

إذا كنت ترغب في إرسال رسائل SMS من C#، يمكنك استخدام واجهة برمجة تطبيقات HTTP SMS الخاصة بـ Ozeki SMS Gateway.

لإرسال رسائل SMS من C#:

1. افتح https://localhost:9515 في متصفحك وقم بتسجيل الدخول
2. قم بإنشاء مستخدم جديد لواجهة برمجة تطبيقات HTTP
3. تحقق من رقم منفذ خدمة واجهة برمجة تطبيقات HTTP
4. ابدأ Visual Studio
5. قم بإنشاء مشروع وحدة تحكم جديد بـ C#
6. أرسل رسائل SMS من C# عن طريق كتابة الكود المصدري أدناه
7. شغل مشروع تطبيق وحدة التحكم
8. عرض الرسائل SMS المرسلة من مشروع C# على هاتفك المحمول

فيديو كيفية إرسال رسائل SMS من C#

مثال على الكود المصدري لـ C# SMS

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

using System;
using System.Net.Http;
using System.Text;
using System.Web;
namespace HttpApiTester
{
    class Program
    {
        static async System.Threading.Tasks.Task Main(string[] args)
        {
            var username = "john";
            var password = "Xc3ffs";
            var messagetype = "SMS:TEXT";
            var httpUrl = "https://127.0.0.1:9508/";
            var recipient = HttpUtility.UrlEncode("+36201324567", Encoding.UTF8);
            var messagedata = HttpUtility.UrlEncode("TestMessage", Encoding.UTF8);
            
            var sendString = $"{httpUrl}api?action=sendmessage&username=" +
                             $"{username}&password={password}" +
                             $"&recipient={recipient}&messagetype=" +
                             $"{messagetype}&messagedata={messagedata}";

            Console.WriteLine("Sending request: " + sendString);

            var handler = new HttpClientHandler();
            handler.ServerCertificateCustomValidationCallback = 
                (sender, cert, chain, sslPolicyErrors) => { return true; };

            using var client = new HttpClient(handler);

            try
            {
                var response = await client.GetStringAsync(sendString);
                Console.WriteLine("Http response received: ");
                Console.WriteLine(response);

            } catch(Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
    }
}

الخطوة 1 - افتح Visual Studio

الخطوة الأولى لإنشاء التطبيق الذي يمكنه إرسال رسائل SMS هي فتح Visual Studio. إذا لم تقم بتنزيل Visual Studio بعد، ما عليك سوى اتباع الرابط في قسم المتطلبات الأساسية أعلاه لتنزيل أحدث إصدار. إذا كان لديك Visual Studio مثبتًا على جهازك، كل ما عليك فعله هو النقر على أيقونته (الشكل 1) على سطح المكتب لفتح Visual Studio.

الخطوة 2 - إنشاء مشروع جديد

بعد فتح Visual Studio، ستظهر لك نافذة الافتتاح كما تراها في الشكل 2. هنا يمكنك رؤية حلولك، يمكنك فتح حل موجود، استنساخ مستودع أو فتح مجلد محلي. الآن، لمتابعة الدليل، تحتاج إلى النقر على زر 'إنشاء مشروع جديد' لإنشاء مشروع لإرسال SMS.

الخطوة 3 - اختيار تطبيق الكونسول

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

الخطوة 4 - تكوين المشروع

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

الخطوة 5 - نسخ كود المثال

بعد إنشاء مشروع تطبيق الكونسول، تحتاج الآن إلى إعداد كود المثال الذي تحتاج إلى تنفيذه. لهذا، قم بالتمرير لأعلى في هذه الصفحة للعثور على قسم كود المثال وحدد الكود المصدري بالكامل كما يوضح الشكل 5. ثم اضغط فقط على Ctrl+C على لوحة المفاتيح لنسخ الكود المصدري.

الخطوة 6 - لصق الكود المصدري في مشروعك

في Visual Studio، يحتوي المشروع المنشئ على ملف مصدري أولي Program.cs. في هذه المرحلة، هذا هو الملف الذي يجب عليك استخدامه لتنفيذ برنامج المثال. هنا، أولاً، حدد الكود في هذا الملف واحذفه. بعد ذلك، كما يوضح الشكل 6، اضغط على Ctrl+V على لوحة المفاتيح للصق كود المثال في ملف Program.cs الخاص بك. الآن، المشروع جاهز للاستخدام.

الخطوة 7 - تنفيذ مشروع المثال

الخطوة الأخيرة من هذا الدليل هي تنفيذ برنامج المثال. في Visual Studio، من السهل جدًا تشغيل المشروع، كل ما عليك فعله هو النقر على زر التشغيل كما يمكنك رؤيته في الشكل 7. بعد بدء البرنامج، تظهر نافذة كونسول، تعرض طلب HTTP الذي أرسله البرنامج إلى بوابة الرسائل القصيرة. كما تعرض أيضًا الرد من بوابة الرسائل القصيرة الذي يوضح ما إذا كان إرسال الرسالة ناجحًا أم لا.

الخطوة 8 - التحقق من نتيجة الإرسال في سجل Ozeki

في Ozeki 10 SMS Gateway، يمكنك التحقق بسهولة من الرسائل التي أرسلها تطبيقك، حيث يقوم خدمة HTTP API بتسجيل كل حدث يحدث أثناء فترة تمكينها. لذا، إذا فتحت بوابة الرسائل القصيرة، وحددت تفاصيل خدمة HTTP API، ستتمكن من رؤية الأحداث. كما يمكنك رؤيته في الشكل 8، قامت الخدمة بتسجيل حدث، عندما أرسل برنامج C# المثال طلب HTTP إلى الخدمة.

يمكن أيضًا عرض عملية إرسال الرسائل من خلال الأحداث. لهذا، افتح اتصال مستخدم HTTP API، الذي كان عليك تكوينه مسبقًا. الشكل 9 يوضح كيف يتعامل الاتصال مع طلب HTTP ويرسل الرسالة إلى المستلم الذي حددته في برنامج C# الخاص بك.

الختام

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

بوابة Ozeki للرسائل القصيرة هي أداة يمكن التحكم فيها باستخدام طلبات HTTP. لمعرفة المزيد عنها، لا تتردد في زيارة المقال حول استقبال الرسائل القصيرة باستخدام واجهة برمجة تطبيقات HTTP للرسائل القصيرة بلغة C#، أو الحصول على معلومات حول اللغات الأخرى المدعومة، مثل PHP.

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