فئة رسائل SMS API لـ C#

فئة رسائل SMS في Client.Send() عندما ترغب في إرسال رسالة SMS عبر واجهة برمجة تطبيقات SMS لـ C#/Net.

واجهة برمجة تطبيقات SMS لـ C# / معرف رسالة SMS

المعرف: يُستخدم معرف الرسالة لتحديد الرسالة القصيرة. يتم إرجاع هذا المعرف لتقارير إرسال الرسائل القصيرة وتقارير تسليمها.

واجهة برمجة تطبيقات SMS لـ C# / معرف مرسل SMS

FromConnection: اسم اتصال شبكة الهاتف المحمول للرسائل القصيرة الذي دخلت منه الرسالة إلى بوابة Ozeki للرسائل القصيرة. على سبيل المثال، إذا اتصلت بشبكة الهاتف المحمول باستخدام بوابة SMS لنظام Android، فسيكون هذا "Vodafone UK" إذا دخلت الرسالة عبر بطاقة SIM التي تخدم شبكة Vodafone.

FromAddress: معرف المرسل لرسالة SMS. إذا تم إرسال الرسالة من هاتف محمول بالرقم +44123467، فستحتفظ هذه الخاصية بالقيمة +44123467. إذا كنت ترغب في تحديد معرف مرسل مخصص لرسالة SMS ترغب في إرسالها، فهذه هي الخاصية التي يجب عليك تعيينها. يمكنك وضع رقم هاتف في هذا الحقل، معرف مرسل أبجدي رقمي يحدد واجهة برمجة تطبيقات SMS لـ C#.

FromStation: هذا هو معرف جهاز كمبيوتر بوابة SMS الذي استقبل الرسالة. كل بوابة Ozeki للرسائل القصيرة لها معرف فريد عالمي (GUID). إذا كانت واجهة برمجة التطبيقات لـ C# الخاصة بك تتصل بعدة بوابات SMS، فإن هذا المعرف مفيد لتحديد مصدر رسالة SMS.

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

ToConnection: استخدم هذا الحقل إذا كنت ترغب في تجاوز جدول توجيه SMS في بوابة SMS. يمكنك تحديد اسم اتصال شبكة الهاتف المحمول للرسائل القصيرة الذي تريد استخدامه لتسليم الرسالة في هذا الحقل.

ToAddress: رقم الهاتف الذي يجب إرسال الرسالة إليه. إذا كنت ترغب في إرسال رسالة نصية إلى الهاتف المحمول +3620123456، فضع +3620123456 في هذا الحقل. هذا الحقل إلزامي للرسائل الصادرة.

ToStation: يمكن استخدام هذا الحقل إذا كنت ترغب في توجيه رسالتك عبر بوابة SMS معينة. هذا الحقل ذو صلة فقط إذا كنت تعمل مع عدة بوابات SMS. يمكنك تركه فارغًا بأمان.

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

Text: هذا هو الحقل الذي يجب عليك وضع نص الرسالة فيه. يمكن أن يحتوي هذا الحقل على رسائل تصل إلى 65536 حرفًا. إذا كان طول الرسالة أكثر من 160 حرفًا، فسيتم إرسال رسالتك كرسالة SMS متعددة الأجزاء. هذا الحقل إلزامي لكل رسالة SMS.

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

CreateDate: يتم تعيين هذه الطابع الزمني تلقائيًا إلى التاريخ والوقت الحاليين عند إنشاء مثيل لفئة الرسائل.

ValidUntil: قم بتعيين هذا الوقت في تنفيذ واجهة برمجة تطبيقات SMS لـ C# لتحديد تاريخ انتهاء صلاحية الرسالة. إذا انتهت صلاحية رسالتك، فسيتم إزالتها من مجلد الصادر. يُستخدم هذا التاريخ أيضًا في تحديد فترة الصلاحية للرسالة قبل إرسالها إلى شبكة الهاتف المحمول.

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

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

IsSubmitReportRequested: قم بتعيين هذا إلى "صحيح" إذا كنت ترغب في استلام تقرير SubmitAccepted في تنفيذ واجهة برمجة تطبيقات SMS لـ C#.

IsDeliveryReportRequested: قم بتعيين هذا إلى "صحيح" إذا كنت ترغب في استلام تقرير تسليم في تنفيذ واجهة برمجة تطبيقات SMS لـ C#.

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

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

Tags: علامات الرسالة هي حقول اختيارية. يمكنك تحديد الحقول بتنسيق الاسم/القيمة. يمكن استخدام هذه القائمة من المعلمات الإضافية لتحديد قيم مخصصة تُستخدم في إرسال SMS، مثل PDU الخام، ومخطط ترميز البيانات، وأرقام منافذ SMS، وقيم أخرى مماثلة يمكن استخدامها للترميز.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace OZX
{
    public class OzxMessage : IOzxMessage
    {
        public string ID { get; set; }

        public string FromConnection { get; set; }
        public string FromAddress { get; set; }
        public string FromStation { get; set; }

        public string ToConnection { get; set; }
        public string ToAddress { get; set; }
        public string ToStation { get; set; }

        public string Text { get; set; }

        public DateTime CreateDate { get; set; }
        public DateTime ValidUntil { get; set; }
        public DateTime TimeToSend { get; set; }

        public bool IsSubmitReportRequested { get; set; }
        public bool IsDeliveryReportRequested { get; set; }
        public bool IsViewReportRequested { get; set; }

        //**********************************************
        // العلامات الاختيارية
        //**********************************************

        static Dictionary<string, string> _tags;
        static Dictionary<string, string> Tags
        {
            get { return _tags ?? (_tags = new Dictionary<string,string>()); }
        }
        
        public Dictionary<string, string> GetTags()
        {
            lock (Tags)
            {
                return Tags.ToDictionary(entry => entry.Key, entry => entry.Value);
            }
        }

        public void AddTag(string key, string value)
        {
            lock (Tags)
            {
                if (Tags.ContainsKey(key))
                    Tags[key] = value;
                else
                    Tags.Add(key, value);
            }
        }

        //**********************************************
        // البناء
        //**********************************************

        public OzxMessage()
        {
            ID = Guid.NewGuid().ToString();
            CreateDate = DateTime.Now;
            TimeToSend = DateTime.MinValue;
            ValidUntil = DateTime.Now.AddDays(7);
            IsSubmitReportRequested = true;
            IsDeliveryReportRequested = true;
            IsViewReportRequested = true;
        }


        //**********************************************
        // إلى سلسلة نصية
        //**********************************************
        public override string ToString()
        {
            var sb = new StringBuilder();
            if (!string.IsNullOrEmpty(FromAddress))
                sb.Append(FromAddress.ToString());
            else
                sb.Append(FromConnection);
            
            sb.Append("->");
            
            if (!string.IsNullOrEmpty(ToAddress))
                sb.Append(ToAddress.ToString());
            else
                sb.Append(ToConnection);

            if (Text != null)
            {
                sb.Append(" '");
                sb.Append(Text);
                sb.Append("'");
            }
            return sb.ToString();
        }

    }
}