وب سرویس دریافت پیامک تحت سرویس REST API برای دریافت آرایه ای از متن های ارسال شده به شماره پنل اس ام اس استفاده و فراخوانی می شود.

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

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

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

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

وب سرویس دریافت پیامک تحت سرویس REST API :

 

دو متد مربوط به دریافت پیامک در وب سرویس rest وجود دارد :

ReceiveMessage -ByLastID

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

ReceiveMessage -ByDate

توسط تاریخ شمسی و در بازه ماهانه می توانید پیام کوتاه های دریافت شده در پنل اس ام اس خود را دریافت نمایید. برای مثال می توانید دریافتی خود را از تاریخ 1/06/1397 تا 31/06/1397 درخواست نمایید. البته امکان دریافت در روز خاصی مانند 03/06/1397 الی 04/06/1397 را نیز دارید. دقت داشته باشید با توجه به آرشیو ماهانه اطلاعات و پیام کوتاه های ارسالی و دریافتی، تنها می توانید در قالب یک ماه تاریخ شمسی را وارد نمایید.

 

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

در هر صورت مقدار بازگشتی به صورت زیر است :

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

برای مثال دو مقدار به صورت آرایه در پاسخ بازگردانده شده است :

شماره صفر( اولین متن دریافتی ) :

{

[0]=> object(stdClass)#3 (7)

{

[“ID”]=> int(*****)

[“LineNumber”]=> string(14) “*******”

[“SMSMessageBody”]=> string(21) “*****

” [“MobileNo”]=> string(10) “*******”

[“ReceiveDateTime”]=> string(19) “1397/06/24 18:02:00”

[“LatinReceiveDateTime”]=> string(22) “2018-09-15T18:02:00.61”

[“TypeOfMessage”]=> string(29) “پیامهای دریافتی

” }

و مقدار دوم بازگردانده شده در پیامک دریافتی :

 

[1]=> object(stdClass)#4 (7)

{

[0]=> object(stdClass)#3 (7)

{

[“ID”]=> int(*****)

[“LineNumber”]=> string(14) “*******”

[“SMSMessageBody”]=> string(17) “*****

” [“MobileNo”]=> string(10) “*******”

[“ReceiveDateTime”]=> string(19) “1397/06/24 18:02:00”

[“LatinReceiveDateTime”]=> string(22) “2018-09-15T18:02:00.61”

[“TypeOfMessage”]=> string(29) “پیامهای دریافتی

” }