ملی پیامک مستندات وب‌سرویس پیامک
ملی پیامک مستندات وب‌سرویس پیامک
ملی پیامک مستندات وب‌سرویس پیامک

ارسال پیامک به مخاطبین دفترچه تلفن

آخرین به روز رسانی: 7 بهمن 1404

متد SendSmsToContact

این متد برای ارسال پیامک به مخاطبین گروه دفترچه تلفن پنل پیامکی ملی پیامک است. در هنگام استفاده از این متد می‌توانید 1 تا 5 گروه دفترچه تلفن را انتخاب کنید.

پارامتر های ورودی

نام پارامترنوع پارامترتوضیحات
username String نام کاربری شما در سامانه
password String APIKey شما در سامانه
title String عنوان ارسال انبوه(این عبارت در متن پیامک ارسال نخواهد شد و صرفاً جهت تفکیک رکوردهای ارسال انبوه به دفترچه تلفن است)
message String متن پیامک (متن پیامک را به‌همراه عبارت «لغو11» در انتهای آن بنویسید)
from String سرشمارۀ فرستندۀ اختصاصی
groupId String گروه دفترچه تلفن که با کاما (,) می‌توانید جدا کنید. (حدأکثر 5 گروه در هر بار ارسال امکان‌پذیر است)
dateToSend String زمان ارسال، فرمت قابل قبول:
2026-01-04 15:20:00

مقدار بازگشتی

نام پارامترنوع پارامترتوضیحات
ReturnValue String bulkId: کد ارسال انبوه به دفترچه تلفن
1- : ارسال تکراری، (در بازۀ زمانی 30 ثانیه نسبت به رکورد قبلی؛ فاصلۀ زمانی رکوردهای مختلف را بیشتر از 30 ثانیه تنظیم کنید)
0 : نام کاربری یا APIKey صحیح نیست.
1 : حدأقل تعداد گیرندگان 10 عدد شماره موبایل است.
2 : اعتبار پنل پیامکی برای این درخواست کافی نیست.
3 : ساعت نامناسب ارسال (بازۀ زمانی مجاز برای این نوع ارسال انبوه، از ساعت 8 الی 22 است)
4 : تاریخ انتخاب‌شده صحیح نیست.
5 : سرشمارۀ فرستنده نامعتبر است.
6 : گروه دفترچه تلفن مقداردهی نشده است.
7 : در هر بار فراخوانی امکان ارسال به حدأکثر 5 گروه دفرتچه تلفن، امکان‌پذیر است.

URL ارسال پیامک به مخاطبین دفترچه تلفن با استفاده از متد SendSmsToContact:

https://api.payamak-panel.com/post/newbulks.asmx/SendSmsToContact?username=&password=&message=&title=&from=&groupId=&dateToSend=

SendSmsToContact
//بدون نیاز به پکیج گیت هاب Procedural PHP نمونه کدهای 
ini_set("soap.wsdl_cache_enabled",0);
$sms = new SoapClient("https://api.payamak-panel.com/post/newbulks.asmx?wsdl",array("encoding"=>"UTF-8"));
$data = array(
"username"=>"" ,
"password"=>"",
"title"=>"",
"message"=>"",
"from"=>"",
"groupId"=>"",
"dateToSend"=>""
);
$result = $sms->SendSmsToContact($data)->SendSmsToContactResult;
echo $result;