Classe de message SMS API C#

La classe des messages SMS dans l'API SMS C# est responsable du transport d'un message entre l'application API SMS C# et la Passerelle SMS Ozeki. C'est la classe que vous passez à la méthode Client.Send() lorsque vous souhaitez envoyer un SMS via l'API SMS C#/Net.

API SMS C# / ID du message SMS

ID : L'ID du message est utilisé pour identifier le SMS. Cet ID est retourné pour les rapports d'envoi de SMS et les rapports de livraison de SMS.

API SMS C# / ID de l'expéditeur SMS

FromConnection : Le nom de la connexion au réseau mobile SMS par laquelle le SMS est arrivé dans la passerelle SMS Ozeki. Par exemple, si vous vous connectez au réseau mobile en utilisant une connexion client SMPP, ce sera "SMPPClient1" lorsqu'un SMS arrive sur cette connexion. Si vous utilisez une passerelle SMS Android, ce sera "Vodafone UK" si le SMS est arrivé via la carte SIM desservant le réseau Vodafone.

FromAddress : L'ID de l'expéditeur du message SMS. Si le SMS a été envoyé depuis un téléphone mobile avec le numéro +44123467, cette propriété contiendra la valeur +44123467. Si vous souhaitez spécifier un ID d'expéditeur personnalisé pour un SMS que vous souhaitez envoyer, c'est cette propriété que vous devez définir. Vous pouvez mettre un numéro de téléphone dans ce champ, un code court SMS associé à l'API SMS C#, ou un ID d'expéditeur alphanumérique identifiant l'API SMS C#.

FromStation : C'est l'ID de l'ordinateur de la passerelle SMS qui a reçu le SMS. Chaque passerelle SMS Ozeki a un ID global unique (GUID). Si votre API C# se connecte à plusieurs passerelles SMS, cet ID est utile pour identifier d'où provient le message SMS.

API SMS C# / Destinataire du SMS

ToConnection : Utilisez ce champ si vous souhaitez outrepasser la table de routage SMS dans la passerelle SMS. Vous pouvez spécifier le nom de la connexion au réseau mobile SMS à utiliser pour la livraison du SMS dans ce champ.

ToAddress : Le numéro de téléphone auquel le SMS doit être envoyé. Si vous souhaitez envoyer un message texte au téléphone mobile +3620123456, mettez +3620123456 dans ce champ. Ce champ est obligatoire pour les messages SMS sortants.

ToStation : Ce champ peut être utilisé si vous souhaitez transférer votre SMS via une passerelle SMS particulière. Ce champ n'est pertinent que si vous travaillez avec plusieurs passerelles SMS. Il est sûr de le laisser vide.

API SMS C# / Texte du SMS

Text : Ce champ est celui où vous devez mettre le texte du message. Ce champ peut contenir des messages jusqu'à 65 536 caractères. Si la longueur du message dépasse 160 caractères, votre SMS sera envoyé sous forme de message SMS multipart. Ce champ est obligatoire pour chaque message SMS.

API SMS C# / Dates

CreateDate : Ce timestamp est automatiquement défini sur Datetime.Now lorsque une instance de la classe des messages est créée.

ValidUntil : Définissez cette heure dans votre implémentation de l'API SMS C# pour spécifier une date d'expiration pour le SMS. Si votre SMS est expiré, il sera supprimé du dossier outbox. Cette date est également utilisée pour définir la période de validité du SMS avant qu'il ne soit envoyé au réseau mobile.

TimeToSend : Pour programmer un SMS pour une livraison future dans votre API SMS C#, définissez cette date à un moment futur. Votre message SMS restera dans la boîte d'envoi de la passerelle SMS jusqu'au moment de l'envoyer. (Notez que la passerelle SMS Ozeki est un serveur SMS ce qui signifie qu'il est capable de stocker et de transférer vos messages SMS).

API SMS C# / Demande de rapport de livraison

IsSubmitReportRequested : Définissez ceci sur true si vous souhaitez recevoir un rapport SubmitAccepted dans votre implémentation de l'API SMS C#.

IsDeliveryReportRequested : Définissez ceci sur true si vous souhaitez recevoir un rapport de livraison dans votre implémentation de l'API SMS C#.

IsViewReportRequested : Définissez ceci sur true si vous souhaitez recevoir un rapport de visualisation dans votre implémentation de l'API SMS C#. Notez que les rapports de visualisation pour les messages SMS ne sont pas retournés par le réseau mobile. Le rapport de visualisation est utilisé si vous envoyez vos messages à un destinataire de chat, et que le destinataire visualise vos messages dans l'application de chat.

API SMS C# / Étiquettes

Tags : Les étiquettes de message sont des champs facultatifs. Vous pouvez spécifier des champs au format nom/valeur. Cette liste de paramètres supplémentaires peut être utilisée pour spécifier des valeurs personnalisées utilisées dans la transmission SMS, telles que les PDU bruts, le schéma de codage des données, les numéros de port SMS et d'autres valeurs similaires, qui peuvent être utilisées pour l'encodage.

C# api SMS classe de message source 

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

        //**********************************************
        // Tags optionnels
        //**********************************************

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

        //**********************************************
        // Construction
        //**********************************************

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


        //**********************************************
        // Conversion en chaîne
        //**********************************************
        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();
        }

    }
}

More information