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

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

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

در ملی پیامک، این روش برای ارسال پیامک ساده و ارسال پیامک پترن قابل استفاده است. برای استفاده از آن نیز باید یک حساب فعال داشته باشید و داده‌ها وب‌سرویس، مانند نام کاربری و رمز عبور یا API Key، در اختیار شما باشد.

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

به‌همین‌دلیل، پیام مستقیماً از مرورگر یا نرم‌افزار شما به اپراتور تلفن همراه فرستاده نمی‌شود و ابتدا باید توسط وب‌سرویس پردازش شود.

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

فرض کنید در نرم‌افزار حسابداری یک فاکتور نوین برای مشتری ثبت می‌کنید.

نرم‌افزار می‌تواند پس از ثبت فاکتور، شماره موبایل مشتری و متن پیام را در یک درخواست URL قرار دهد و آن را برای وب‌سرویس ارسال کند. سپس وب‌سرویس درخواست را پردازش کرده و پیامکی مانند این برای مشتری می‌فرستد:

در این حالت لازم نیست کاربر هر بار وارد پنل پیامکی شود و پیام را به‌صورت دستی ارسال کند.

عبارت‌هایی مثل «ارسال پیامک با URL»، «SMS Link» و «لینک داخل پیامک» شبیه هم هستند، اما کاربرد متفاوتی دارند. برای جلوگیری از اشتباه، بهتر است تفاوت آن‌ها را بدانید.

در این روش، یک نرم‌افزار یا سیستم با فراخوانی URL وب‌سرویس، درخواست ارسال پیامک را ثبت می‌کند. گزارش‌های مانند شماره گیرنده، متن پیام و مشخصات حساب در این درخواست قرار می‌گیرند و وب‌سرویس پس از پردازش آن، پیامک را ارسال می‌کند.

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

لینک sms: برای باز کردن برنامۀ پیامک گوشی استفاده می‌شود. برای مثال:

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

این حالت زمانی است که یک آدرس اینترنتی را داخل متن SMS قرار می‌دهید؛ برای مثال لینک صفحۀ محصول، پرداخت، فرم یا سایت:

سفارش شما آمادۀ پرداخت است:

کاربر با لمس این لینک وارد صفحۀ موردنظر می‌شود.

بنابراین مبحث این مقاله ارسال پیامک از طریق URL وب‌سرویس است، نه لینک sms و نه قرار دادن لینک داخل متن پیامک.

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

برای ساخت URL ارسال پیامک، باید گزارش‌های را در اختیار وب‌سرویس قرار دهید تا مشخص شود پیام از چه حسابی، برای چه شماره‌ای و با چه متنی ارسال شود.

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

همۀ این پارامترها در هر نوع ارسال استفاده نمی‌شوند. برای مثال، در ارسال پیامک ساده معمولاً به from و text نیاز دارید؛ اما در ارسال پیامک پترن، شناسۀ الگو یا bodyId و مقادیر متغیرهای همان پترن اهمیت بیشتری دارند.

در بخش‌های بعدی، ساختار هر دو روش را جداگانه با مثال مرور می‌کنیم.

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

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

آدرس ارسال پیامک ساده از طریق URL در ملی پیامک به شکل زیر است:

سپس پارامترهای موردنیاز را به انتهای این آدرس اضافه می‌کنید.

ساختار کلی درخواست به این شکل خواهد بود:

فرض کنید می‌خواهید این پیام را برای مشتری ارسال کنید:

گزارش‌ها فرضی ما به این شکل است:

در خروجی، ساختار درخواست ما به شکل زیر خواهد بود:

https://api.payamak-panel.com/post/sendsms.ashx?username=username&password=APIKey&to=09121234567&from=5000XXXX&text=MESSAGE

در این مثال:

در ارسال پترن، متن دقیق پیام را هر بار در URL نمی‌نویسید. ابتدا یک الگو در پنل پیامکی تعریف و تأیید می‌شود و هنگام ارسال فقط شناسۀ الگو، شماره گیرنده و مقادیر متغیرهای آن را برای وب‌سرویس می‌فرستید.

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

برای مثال، یک پترن می‌تواند چنین مفهومی داشته باشد:

در هر ارسال فقط مقدار «نام» و «مبلغ» تغییر می‌کند. برای آشنایی دقیق با ساخت و تأیید الگو می‌توانید مقاله ارسال پیامک طبق الگو را مطالعه کنید.

هر پترنی که در سامانه ثبت و تأیید می‌شود، یک شناسۀ عددی به نام BodyId دارد. این کد به وب‌سرویس می‌گوید قرار است از کدام الگوی تأییدشده برای ارسال پیام استفاده شود.

فرض کنید پترن مربوط به اطلاع‌رسانی فاکتور دارای این شناسه باشد:

در این صورت مقدار bodyId در درخواست شما برابر با 12345 خواهد بود.

برای ارسال مستقیم پترن از طریق URL، متد SendByBaseNumber2 انتخاب ساده‌تری است؛ چون BodyId و مقادیر متغیرها را به‌صورت جداگانه دریافت می‌کند.

ساختار آن به شکل زیر است:

https://api.payamak-panel.com/post/Send.asmx/SendByBaseNumber2?username=YourUsername&password=APIkey&text=Message1;Message2,...&to=Number&bodyId=BodyId

پارامترهای اصلی این درخواست عبارت‌اند از:

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

فرض کنید پترن شما دو متغیر دارد:

و می‌خواهیم مقادیر زیر را جایگزین کنیم:

نام: علی

مبلغ: 300000

مقدار پارامتر text به این شکل نوشته می‌شود:

علی;300000

ترتیب مقادیر اهمیت دارد. اگر در پترن ابتدا نام و سپس مبلغ تعریف شده باشد، در URL نیز باید ابتدا مقدار نام و بعد مبلغ قرار گیرد.

در برآیند، یک نمونۀ آموزشی از درخواست می‌تواند چنین ساختاری داشته باشد:

http://api.payamak-panel.com/post/Send.asmx/SendByBaseNumber2?username=username&password=ApiKey&text=علی;300000&to=09121234567&bodyId=12345

اطلاعات این مثال ساختگی هستند و باید با داده‌ها واقعی پنل، شمارۀ مشتری و BodyId پترن خودتان جایگزین شوند.

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

text=علی

اگر دو متغیر داشته باشد:

text=علی;300000

و اگر سه متغیر، مثلاً نام، شماره سفارش و مبلغ داشته باشد:

text=علی;45821;300000

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

بله. اگر Endpoint موردنظر فرصت دریافت درخواست از طریق URL را داشته باشد، می‌توانید برای تست اولیه، آدرس مفصل را در نوار مرورگر وارد کنید و برآیند را ببینید.

برای مثال، در یک تست ساده مسیر به این شکل است:

مرورگر → URL → وب‌سرویس → ارسال پیامک

این روش برای ارزیابی با سرعت درست بودن پارامترهایی مثل شماره گیرنده، متن پیام و داده‌ها حساب مناسب است.

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

دلیلش هم ساده است: در استفادۀ واقعی، داده‌های مثل نام کاربری، رمز عبور یا API Key نباید هر بار به‌صورت دستی در مرورگر وارد شوند. علاوه‌بر این، نرم‌افزار می‌تواند ارسال پیامک را طبق یک رویداد مشخص، مثل ثبت سفارش یا صدور فاکتور، به‌صورت خودکار انجام دهد.

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

در نرم‌افزار هلو می‌توان آدرس وب‌سرویس، نام کاربری، رمز عبور یا API Key، شماره فرستنده و پارامترهای موردنیاز را در تنظیمات سرویس‌دهنده وارد کرد.

بعد از انجام تنظیمات، بعضی رویدادهای حسابداری می‌توانند به ارسال پیامک منجر شوند. برای مثال:

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

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

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

در خروجی، کاربر با اجرای دستور ارسال، URL مربوط به وب‌سرویس را فراخوانی می‌کند و پیام برای مخاطب موردنظر ارسال می‌شود.

مثلاً:

شماره مشتری + متن پیام + داده‌ها حساب

↓

اجرای دستور

↓

وب‌سرویس پیامکی

↓

ارسال SMS

برای آموزش دقیق این روش، به مقالۀ ارسال پیامک از اکسل مراجعه کنید.

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

برای مثال:

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

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

برای مثال:

سرور از دسترس خارج شد

↓

نرم‌افزار مانیتورینگ URL را فراخوانی می‌کند

↓

وب‌سرویس درخواست را پردازش می‌کند

↓

مدیر شبکه پیامک هشدار دریافت می‌کند

در این کاربرد، مزیت اصلی این است که هشدار پیامکی می‌تواند به‌صورت خودکار و بدون نیاز به حضور کاربر در پنل ارسال شود.

برای هر بار ارسال پیامک از طریق URL، لازم نیست وارد محیط پنل ملی پیامک شوید. نرم‌افزار می‌تواند با استفاده از شرح وب‌سرویس، درخواست ارسال را مستقیماً برای سامانه ارسال کند.

اما این مبحث به معنی ارسال پیامک بدون داشتن پنل نیست. برای استفاده از وب‌سرویس، باید حساب فعال داشته باشید و گزارش‌ها لازم برای احراز هویت، مانند نام کاربری و رمز عبور یا API Key را در اختیار نرم‌افزار قرار دهید.

به زبان ساده:

بدون ورود به پنل ≠ بدون داشتن پنل

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

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

برای مثال، اگر متن پیام شما شامل علامت & باشد و آن را بدون Encoding در URL قرار دهید، وب‌سرویس ممکن است ادامه متن را به‌عنوان یک پارامتر نوین در نظر بگیرد. در چنین شرایطی، مشکل از خود متن پیام نیست؛ بلکه باید نحوۀ قرار گرفتن آن در URL اصلاح شود.

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

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

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

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

فرض کنید در نرم‌افزار حسابداری، فاکتور نوینی صادر می‌شود. نرم‌افزار می‌تواند در همان لحظه URL وب‌سرویس را با شماره مشتری و متن موردنظر فراخوانی کند تا پیامک بدون ورود دستی به پنل ارسال شود.

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

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

اگر نرم‌افزار شما توانایی فراخوانی URL داشته باشد، پس از انجام تنظیمات اولیه دیگر لازم نیست برای هر پیام وارد پنل شوید و فرآیند ارسال می‌تواند از داخل همان نرم‌افزار انجام شود.

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

سوالات متداول

چرا ارسال پیامک از طریق URL؛ آموزش کامل ارسال ساده و پترن با آدرس اینترنتی اهمیت دارد؟

این موضوع به دلیل اطلاعات و کاربردهای مرتبط، مورد توجه کاربران قرار گرفته است.

مهم‌ترین نکات درباره پیامک چیست؟

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

آخرین اطلاعات درباره ارسال چیست؟

جدیدترین اطلاعات و تغییرات مربوط به ارسال در این گزارش ارائه شده است.

برچسب ها: