راهنمای کامل ارسال پیامک در سی شارپ C# ( کد تایید ، پیامک تکی و … )

شاید برای شما هم جالب باشد که ارسال پیامک با سی شارپ امکان دارد یا خیر؟ هر برنامه می تواند قابلیت ارسال پیامک داشته باشد. ارسال پیامک با سی شارپ یکی از قابلیت های این زبان برنامه نویسی است که در نرم افزار های مختلفی کاربرد دارد.

کسب و کارها برای رونق گرفتن نیاز به تعامل و ارتباط بیشتر و بهتر با مشتریان دارند، ارسال پیامک، ایجاد ارتباط با مشتری را سریع تر و راحت تر فراهم می کند. سامانه های پیامکی هم امکان ارسال پیامک تبلیغاتی به صورت انبوه را دارد و هم قابلیت اتصال به زبان های برنامه نویسی برای ارسال پیامک دارند.

در این مقاله همراه ما باشید تا با ارسال پیامک با سی شارپ در پنل اس ام اس آشنا شوید.

سی شارپ چیست؟

زبان برنامه نویسی سی شارپ بر پایه زبان c برای محیط ویندوز و net. طراحی شده است و یکی از پر استفاده ترین زبان برنامه نویسی دنیاست که از جاوا و دلفی تاثیر گرفته است. زبان #c در عین سادگی ، مدرن ، همه منظوره و شی گرا ساخته شده است.

یکی از قابلیت هایی که سی شارپ دارد ارسال پیامک است. برای ارسال پیامک c# ابتدا باید به یکی پنل اس ام اس دسترسی داشته باشید تا امکان ارسال پیامک با سی شارپ از سامانه پیامکی برای شما مقدور شود.

سامانه پیامکی پیام رسان با ثبت نام اولیه، دسترسی به وب سرویس پیامکی را برای ارسال پیامک با سی شارپ را برای شما فراهم می کند.

وب سرویس ارسال پیامک سازگار با زبان سی شارپ

شما می‌توانید از زبان برنامه‌نویسی C# برای ارسال پیامک از طریق وب‌سرویس‌ ارسال پیامک پیام‌رسان استفاده کنید. برای این کار نیاز به استفاده از وب‌سرویسی دارید که امکان ارسال پیامک را از طریق آن فراهم کند. سامانه پیامکی پیام رسان ، APIهایی برای ارسال پیامک از طریق C# و دیگر زبان‌های برنامه‌نویسی ارائه می‌دهند.

متد ارسال یک متن به یک یا چند شماره با متد (Send )

این متد مربوط به ارسال پیامک می باشد ، این متد این قابلیت را دارد که در یک بار فراخوانی به حداکثر 99 شماره پیام ارسال نماید، به این معنی که نیازی نیست به ازای هر شماره یک بار متد را فراخوانی نمائید، می توانید شماره ها را به دسته های 99 تایی تقسیم نموده و هر دسته را توسط یک آرایه به این متد ارسال نمائید.

var client = new RestClient("https://api.sms-webservice.com/api/V3/Send?ApiKey=123456&Text=test&Sender=123654&Recipients=9121112222");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

متد ارسال یک متن به یک یا چند شماره با متد (SendBulk )

این متد مربوط به وب سرویس ارسال پیامک رایگان می باشد، این متد این قابلیت را دارد که در یک بار فراخوانی به حد اکثر 99 شماره پیام ارسال نماید، به این معنی که نیازی نیست به ازای هر شماره یک بار متد را فراخوانی نمائید، می توانید شماره ها را به دسته های 99 تایی تقسیم نموده و هر دسته را توسط یک آرایه شامل شماره دریافت کننده و کد پیگیری به این متد ارسال نمائید.

این متد بصورت post فراخوانی می شود و پارامترهای ورودی در بدنه درخواست ارسال می شوند.

var client = new RestClient("https://api.sms-webservice.com/api/V3/SendBulk");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
var body = @"{""ApiKey"": ""string"",""Text"": ""string"",""Sender"": 0,""Recipients"": [{""Destination"": 0,""UserTraceId"": 0}]}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

متد ارسال چند متن به چند گیرنده (SendMultiple)

اگر قصد دارید به هر گیرنده متن جداگانه ای را ارسال کنید، این متد چاره کار شماست. با استفاده از این متد نیازی نیست که به ازای هر گیرنده یک بار درخواست ارسال کنید و می توانید پیامک های خود را در گروه های 100 تایی با یک درخواست به سامانه ارسال کنید. همچنین این متد به شما این قابلیت را می دهد تا به ازای هر شماره گیرنده یک متن و شماره ارسال کننده مجزا معرفی کنید.

var client = new RestClient("https://api.sms-webservice.com/api/V3/SendMultiple");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
var body = @"{""ApiKey"": ""123456"",""Recipients"": [{""Sender"": 0,""Text"": ""test"",""Destination"": 0,""UserTraceId"": 0}]}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

متد ارسال به یک شماره با استفاده از الگوی تعریف شده (SendTokenSingle)

برای ارسال با استفاده از الگو ازاین متد می توانید استفاده نمایید، پس از تعریف الگو در سامانه پیامکی و در صورت نیاز تعریف پارامترها در آن و تایید آن توسط پشتیبانی سامانه، با فراخوانی این متد، مقادیر مربوط به پارامتر ها که در متن الگو تعریف شده، جایگزین و به شماره دریافت کننده ارسال می گردد.

همانطور که در درخواست مشخص است، شماره ارسال کننده وارد نمی شود و سامانه سریعترین خط خدماتی را در لحظه انتخاب و ارسال را با استفاده از آن ثبت می کند.

همانطور که در درخواست مشخص است، در ورودی این متد به ازای هر شماره دریافت کننده متن پیام و شماره ارسال کننده و شماره پیگیری تعریف شده توسط کاربر نیز ارسال می گردد.

• ApiKey : کلید اختصاصی هر کاربر
• Text : متن پیامک
• Sender : شماره ارسال کننده
• Recipients : شماره های دریافت کننده

var client = new RestClient("https://api.sms-webservice.com/api/V3/SendTokenSingle?ApiKey=123456&TemplateKey=123654&Destination=9121111111&p1=125&p2=45&p3=name");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Content-Type", "application/json");
var body = @"{""ApiKey"": ""123456"",""Recipients"": [{""Sender"": 0,""Text"": ""test"",""Destination"": 0,""UserTraceId"": 0}]}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

متد ارسال یک الگو با متن های مختلف به چند شماره (SendTokenMulti)

اگر قصد دارین پیام هایی با متن متفاوت اما در قالب یک الگو را برای افراد مختلف ارسال نمایید، نیاز نیست متد قبل را چندین بار فراخوانی نمایید کافیست ازاین متد استفاده نمایید. متد post بوده و به ازای هر شماره دریافت کننده، لیست پارامترهای مربوط به آن دریافت کننده را نیز دریافت خواهد کرد.

پارامتر های این متد GET عبارت است از :

• ApiKey : کلید اختصاصی هر کاربر
• TemplateKey : کلید تعریف الگو
• Destination : شماره دریافت کننده
• P1 : پارامتر اول
• P2 : پارامتر دوم
• P3 : پارامتر سوم

 var client = new RestClient("https://api.sms-webservice.com/api/V3/SendTokenMulti");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
var body = @"{""ApiKey"": ""string"",""TemplateKey"": ""string"",""Recipients"": [{""Destination"": 0,""UserTraceId"": 0,""Parameters"": [""string""]}]}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);S

متد دریافت لیست الگوهای تعریف شده در پنل (TokenList)

در صورتیکه بخواهید لیست الگوهای تعریف شده در پنل را مشاهده نمایید، می توانید ازین متد استفاده نمایید.

متد این درخواستpost بوده و مقدار ورودی در بدنه درخواست ارسال می شود. مقدار ورودی این متد، کلید اختصاصی پنل شماست.

 var client = new RestClient("https://api.sms-webservice.com/api/V3/TokenList");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@"  ""ApiKey"": ""123456""
" + "\n" +
@"}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

متد دریافت وضعیت پیام های ارسالی (StatusById)

زمانیکه بخواهیم پس از ارسال پیام، وضعیت پیام ارسالی را داشته باشیم، نیاز است ازاین متد استفاده نماییم، در یک درخواست می توان از وضعیت بیش از یک پیام استعلام گرفت.

این متد نیز post بوده و پارامترهای ورودی از طریق بدنه متد ارسال میشوند، بدنه متد شامل شناسه پنل پیامکی و لیستی از شناسه پیامک های ارسالی که می خواهیم وضعیت آنها را داشته باشیم.

var client = new RestClient("https://api.sms-webservice.com/api/V3/StatusById");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
var body = @"{""ApiKey"": ""string"",""Ids"": [0]}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

متد دریافت وضعیت پیام های ارسالی (StatusByTraceId)

زمانیکه بخواهیم پس از ارسال پیام، وضعیت پیام ارسالی را داشته باشیم، و شناسه های پیامک های ارسالی را در اختیار نداشته باشیم، می توانیم ازاین متد استفاده نماییم، در یک درخواست می توان از وضعیت بیش از یک پیام استعلام گرفت.

پارامترهای ورودی از طریق بدنه متد ارسال میشوند، بدنه متد شامل شناسه پنل و لیستی از شناسه پیامک های ارسالی که قبلا توسط سیستم شما ایجاد شده و به سامانه ارسال شده، می باشد.

var client = new RestClient("https://api.sms-webservice.com/api/V3/StatusByUserTraceId");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
var body = @"{""ApiKey"": ""string"",""UserTraceIds"": [0]}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

متد دریافت مقدار اعتبار و لیست خطوط ارسال کننده فعال در پنل (AccountInfo)

در صورتیکه بخواهید از مقدار اعتبار باقیمانده در پنل و یا لیست خطوط فعال در پنل خود گزارشی داشته باشید، ازین متد می توانید استفاده نمایید، برای فراخوانی این متد کافیست کد شناسه پنل خود را در بدنه متد ارسال نمایید.

پارامترهای ورودی از طریق بدنه متد ارسال میشوند، بدنه متد شامل شناسه پنل و لیستی از شناسه پیامک های ارسالی که قبلا توسط سیستم شما ایجاد شده و به سامانه ارسال شده، می باشد.

var client = new RestClient("https://api.sms-webservice.com/api/V3/AccountInfo");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
var body = @"{""ApiKey"": ""123456""}";
request.AddParameter("application/json", body,  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);