Klasa wiadomości SMS w C# API

Klasa wiadomości SMS w C# SMS API odpowiada za przenoszenie wiadomości między aplikacją C# SMS API a Ozeki SMS Gateway. Jest to klasa, którą przekazujesz do metody Client.Send(), gdy chcesz wysłać SMS przez C#/Net SMS API.

C# SMS API / ID wiadomości SMS

ID: ID wiadomości służy do identyfikacji SMS-a. To ID jest zwracane w raportach wysłania i dostarczenia SMS-a.

C# SMS API / Nadawca SMS

FromConnection: Nazwa połączenia z siecią komórkową, przez które SMS dotarł do Ozeki SMS Gateway. Na przykład, jeśli łączysz się z siecią komórkową przy użyciu połączenia klienta SMPP, będzie to "SMPPClient1", gdy SMS przyjdzie przez to połączenie. Jeśli używasz bramki SMS dla Androida, będzie to "Vodafone UK", jeśli SMS przyszedł przez kartę SIM obsługującą sieć Vodafone.

FromAddress: ID nadawcy wiadomości SMS. Jeśli SMS został wysłany z telefonu komórkowego o numerze +44123467, ta właściwość będzie zawierać wartość +44123467. Jeśli chcesz określić niestandardowe ID nadawcy dla SMS-a, który chcesz wysłać, to jest właściwość, którą powinieneś ustawić. Możesz wpisać tutaj numer telefonu, krótki kod SMS powiązany z C# SMS API, lub alfanumeryczne ID nadawcy identyfikujące C# SMS API.

FromStation: To ID komputera bramki SMS, który odebrał SMS. Każda bramka Ozeki SMS Gateway ma unikalne globalne ID (GUID). Jeśli Twoje C# API łączy się z wieloma bramkami SMS, to ID jest przydatne do identyfikacji źródła wiadomości SMS.

C# SMS API / Odbiorca SMS

ToConnection: Użyj tego pola, jeśli chcesz zastąpić tabelę routingu SMS w bramce SMS. Możesz określić nazwę połączenia z siecią komórkową, które ma być użyte do dostarczenia SMS-a.

ToAddress: Numer telefonu, na który ma zostać wysłany SMS. Jeśli chcesz wysłać wiadomość tekstową na telefon komórkowy +3620123456, wpisz +3620123456 w to pole. To pole jest obowiązkowe dla wychodzących wiadomości SMS.

ToStation: To pole może być użyte, jeśli chcesz przesłać SMS przez konkretną bramkę SMS. To pole jest istotne tylko wtedy, gdy pracujesz z wieloma bramkami SMS. Można je bezpiecznie pozostawić puste.

C# SMS API / Tekst SMS

Text: To pole, w którym należy umieścić tekst wiadomości. To pole może zawierać wiadomości do 65 536 znaków. Jeśli długość wiadomości przekracza 160 znaków, Twój SMS zostanie wysłany jako wiadomość wieloczęściowa. To pole jest obowiązkowe dla każdej wiadomości SMS.

C# SMS API / Daty

CreateDate: Ten znacznik czasu jest automatycznie ustawiany na Datetime.Now, gdy tworzona jest instancja klasy wiadomości.

ValidUntil: Ustaw ten czas w swojej implementacji C# SMS API, aby określić datę wygaśnięcia SMS-a. Jeśli Twój SMS wygaśnie, zostanie usunięty z folderu wychodzących. Ta data jest również używana do ustawienia okresu ważności SMS-a przed wysłaniem go do sieci komórkowej.

TimeToSend: Aby zaplanować wysłanie SMS-a w przyszłości w swoim C# SMS API, ustaw tę datę na przyszły punkt w czasie. Twoja wiadomość SMS pozostanie w skrzynce nadawczej bramki SMS, aż nadejdzie czas jej wysłania. (Pamiętaj, że Ozeki SMS Gateway to serwer SMS, co oznacza, że może przechowywać i przesyłać Twoje wiadomości SMS).

C# SMS API / Żądanie raportu dostawy

IsSubmitReportRequested: Ustaw na true, jeśli chcesz otrzymać raport SubmitAccepted w swojej implementacji C# SMS API.

IsDeliveryReportRequested: Ustaw na true, jeśli chcesz otrzymać raport dostawy w swojej implementacji C# SMS API.

IsViewReportRequested: Ustaw na true, jeśli chcesz otrzymać raport przeglądania w swojej implementacji C# SMS API. Pamiętaj, że raporty przeglądania dla wiadomości SMS nie są zwracane przez sieć komórkową. Raport przeglądania jest używany, jeśli wysyłasz wiadomości do odbiorcy czatu, a odbiorca przegląda Twoje wiadomości w aplikacji czatu.

C# SMS API / Tagi

Tags: Tagi wiadomości to pola opcjonalne. Możesz określić pola w formacie nazwa/wartość. Ta lista dodatkowych parametrów może być używana do określenia niestandardowych wartości używanych w transmisji SMS, takich jak surowe PDU, schemat kodowania danych, numery portów SMS i inne podobne wartości, które mogą być używane do kodowania.

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; }

        //**********************************************
        // Opcjonalne tagi
        //**********************************************

        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);
            }
        }

        //**********************************************
        // Konstrukcja
        //**********************************************

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


        //**********************************************
        // Na string
        //**********************************************
        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();
        }

    }
}