خانه › ارسال پیامک
ارسال پیامک با متغیر (شخصیسازیشده) — وب سرویس پیامک فراز اس ام اس
POST https://api.iranpayamak.com/ws/v1/sms/keywords
کاربرد: ارسال انبوهِ شخصیسازیشده؛ متغیرها (مثل نام مخاطب) داخل `%...%` در متن جای میگیرند.
Send a message containing variable keywords. The keywords (attributes) must be wrapped inside % signs within the text (E.g: Hello %first_name%)
احراز هویت
این سرویس به هدر Api-Key نیاز دارد — کلید را از پنل فراز اس ام اس بگیرید. نام هدر حساس به حروف بزرگ و کوچک است و کلید نباید در query string برود.
فیلدهای درخواست
text(string) — الزامیline_number(string) — الزامیrecipients(array) — الزامیnumber_format(string) — اختیاری
نکات مهم این سرویس
- متغیرها را داخل علامت % در متن بگذار (مثلاً سلام %first_name%).
- مقدار متغیرها از ویژگیهای مخاطبین/دفترتلفن پر میشود.
- بدون +۹۸؛ number_format را درست بده.
نمونه بدنه
{
"text": "test %var1% text",
"line_number": "50002178584000",
"recipients": [
{
"mobile": "09120000000",
"var1": "value1"
},
{
"mobile": "09130000000",
"var1": "value2"
}
],
"number_format": "english"
}
پاسخها
201— SMS request is enqueued successfully.
سرویسهای مرتبط در دستهٔ «ارسال پیامک»
POST /ws/v1/sms/pattern— ارسال پیامک پترن (قالبدار)POST /ws/v1/sms/simple— ارسال پیامک ساده (گروهی) از طریق وبسرویسPOST /ws/v1/lbs— ساخت ارسال موقعیتمحور (LBS)GET /ws/v1/lbs— فهرست ارسالهای موقعیتمحور (LBS)PUT /ws/v1/lbs/{lbsId}— ویرایش ارسال موقعیتمحور (LBS)GET /ws/v1/lbs/{lbsId}— جزئیات ارسال موقعیتمحور (LBS)PATCH /ws/v1/lbs/{lbsId}/cancel— لغو ارسال موقعیتمحور (LBS)POST /ws/v1/sms/bank— ارسال پیامک به بانک شماره