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

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

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

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

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

ارسال پیامک از طریق URL چیست و چگونه کار می‌کند؟

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

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

یک مثال ساده از عملکرد ارسال پیامک با URL

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

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

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

تفاوت ارسال پیامک از طریق URL با SMS Link چیست؟

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

ارسال پیامک از طریق URL یا HTTP API

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

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

لینک sms: یا Click-to-Text چیست؟

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

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

حتماً بخوانید: تعرفه تبلیغات در پیام‌رسان بله ۱۴۰۵؛ هزینه ارسال پیام انبوه و تبلیغاتی 

لینک داخل متن پیامک چیست؟

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

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

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

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

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

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

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

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

پارامتر	کاربرد
username	نام کاربری پنل پیامکی
password یا APIKey	احراز هویت و تأیید دسترسی به وب‌سرویس
to	شماره موبایل گیرنده پیامک
from	شماره خط فرستنده
text	متن پیامک
bodyId	شناسه پترن یا الگوی پیامک (برای ارسال پیامک با وب‌سرویس خدماتی الگو)

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

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

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

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

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

آدرس وب‌سرویس ارسال پیامک ساده

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

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

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

پارامترهای URL ارسال پیامک ساده چه هستند؟

هر قسمت از URL اطلاعات مشخصی را به وب‌سرویس می‌دهد:

پارامتر	کاربرد
username	نام کاربری حساب شما در ملی پیامک
password	اطلاعات احراز هویت حساب
to	شماره موبایل گیرنده
from	شماره خطی که پیامک از آن ارسال می‌شود
text	متن پیامک

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

نمونه کامل ارسال یک پیامک ساده با URL

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

حتماً بخوانید: وب سرویس REST چیست؟ | آشنایی کامل با REST و کاربردهای آن

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

• نام کاربری: username
• رمز عبور یا APIKey :demoPassword
• شماره گیرنده: 09121234567
• شماره فرستنده: 5000XXXX
• متن: سفارش شما با موفقیت ثبت شد. لغو11

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

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

در این مثال:

• username با نام کاربری واقعی شما جایگزین می‌شود.
• demoPassword با API Key معتبر جایگزین می‌شود.
• 09121234567 شماره مشتری است.
• 5000XXXX خط فرستندۀ شماست.
• MESSAGE همان متن پیامک است.

آموزش ارسال پیامک پترن از طریق URL

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

پیامک پترن چیست؟

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

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

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

BodyId چیست و از کجا دریافت می‌شود؟

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

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

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

آدرس ارسال پیامک پترن از طریق URL

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

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

حتماً بخوانید: ارسال پیامک تشکر با سایت؛ نمونه متن پیامک تشکر از مشتری

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

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

پارامتر	کاربرد
username	نام کاربری پنل
password	رمز عبور یا در صورت الزام امنیتی حساب، API Key
text	مقادیر متغیرهای پترن
to	شماره موبایل گیرنده
bodyId	شناسه پترن تأییدشده

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

متغیرهای پترن را چگونه در URL وارد کنیم؟

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

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

نام: علی

مبلغ: 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

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

آیا می‌توان ارسال پیامک از URL را در مرورگر تست کرد؟

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

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

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

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

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

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

ارسال پیامک از طریق URL در نرم‌افزارهای مختلف چگونه انجام می‌شود؟

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

ارسال پیامک از نرم‌افزار حسابداری هلو با URL

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

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

حتماً بخوانید: ۵ روش افزایش امنیت API پنل پیامکی | آموزش جلوگیری از هک پنل صدور فاکتور → فراخوانی URL وب‌سرویس → ارسال پیامک برای مشتری

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

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

ارسال مستقیم پیامک از اکسل با URL

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

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

مثلاً:

شماره مشتری + متن پیام + اطلاعات حساب

↓

اجرای دستور

↓

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

↓

ارسال SMS

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

اتصال CRM و نرم‌افزارهای سازمانی

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

برای مثال:

حتماً بخوانید: 8 ویژگی جالب بازاریابی پیامکی

• یک لید جدید ثبت می‌شود → پیام خوش‌آمدگویی ارسال می‌شود.
• وضعیت سفارش تغییر می‌کند → مشتری پیامک دریافت می‌کند.
• فاکتور صادر می‌شود → اطلاعات پرداخت برای مشتری ارسال می‌شود.
• زمان پیگیری مشتری می‌رسد → پیام یادآوری برای کارشناس یا مشتری فرستاده می‌شود.

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

استفاده از URL در نرم‌افزارهای مانیتورینگ

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

برای مثال:

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

↓

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

↓

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

↓

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

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

آیا برای ارسال پیامک با URL باید وارد پنل شویم؟

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

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

به زبان ساده:

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

حتماً بخوانید: هر آن‌چه باید در مورد نظرسنجی پیامکی بدانید!

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

خطاهای رایج در ارسال پیامک از طریق URL و روش رفع آن‌ها

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

مشکل	علت احتمالی	راه‌حل پیشنهادی
درخواست ارسال نمی‌شود	نام کاربری، رمز عبور یا API Key اشتباه است	اطلاعات احراز هویت را بررسی کنید و مطمئن شوید حساب شما فعال است.
متن پیام ناقص یا به‌هم‌ریخته ارسال می‌شود	متن به‌درستی URL Encode نشده است	متن پیام را قبل از قرار دادن در URL، Encode کنید.
پیامک پترن ارسال نمی‌شود	BodyId اشتباه است یا مقادیر متغیرها با الگو تطابق ندارند	شناسۀ پترن و تعداد متغیرهای تعریف‌شده را در پنل بررسی کنید.
متغیرهای پترن جابه‌جا نمایش داده می‌شوند	ترتیب مقادیر در درخواست درست نیست	مقادیر را دقیقاً به همان ترتیبی ارسال کنید که متغیرها در پترن تعریف شده‌اند.
پیامک به شماره مقصد نمی‌رسد	شماره گیرنده اشتباه است یا شرایط ارسال برای آن شماره وجود ندارد	فرمت شماره موبایل و وضعیت ارسال را بررسی کنید.
URL داخل نرم‌افزار اجرا نمی‌شود	ساختار URL یا تنظیمات اتصال نرم‌افزار اشتباه است	Endpoint، نام پارامترها و تنظیمات وب‌سرویس در نرم‌افزار را دوباره بررسی کنید.
بخشی از متن بعد از & یا ? حذف می‌شود	کاراکترهای خاص بدون Encoding داخل متن قرار گرفته‌اند	مقدار text را به‌صورت کامل URL Encode کنید.
درخواست ارسال می‌شود اما پترن صحیح انتخاب نمی‌شود	BodyId مربوط به الگوی دیگری است	شناسۀ الگوی تأییدشده موردنظر را از پنل بردارید و در درخواست قرار دهید.

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

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

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

برای کسب اطلاعات بیشتر دربارۀ این موارد از خطاها، به بخش «لیست خطاهای ویسرویس» بروید.

چه زمانی ارسال پیامک از طریق URL انتخاب مناسبی است؟

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

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

• ثبت فاکتور → ارسال پیامک برای مشتری
• رسیدن موعد قسط → ارسال پیامک یادآوری
• ثبت سفارش → ارسال پیامک تأیید سفارش
• بروز خطای سرور → ارسال پیامک هشدار برای مدیر سیستم

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

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

جمع‌بندی؛ چگونه اولین پیامک را از طریق URL ارسال کنیم؟

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

1. حساب فعال و اطلاعات وب‌سرویس خود را آماده کنید.
2. آدرس مربوط به ارسال پیامک ساده یا ارسال پیامک پترن را انتخاب کنید.
3. پارامترهایی مثل نام کاربری، شماره گیرنده، متن پیام یا BodyId را با اطلاعات خودتان جایگزین کنید.
4. متن و مقادیر دارای کاراکترهای خاص را در صورت نیاز URL Encode کنید.
5. درخواست را ابتدا با اطلاعات آزمایشی تست کنید.
6. پاسخ وب‌سرویس را بررسی کنید تا از موفق بودن ارسال مطمئن شوید.

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

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