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

ارسال منطقه‌ای به بانک شماره موبایل(متد دوم)

آخرین به روز رسانی: 10 دی 1404

متد AddBulk2

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

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

نام پارامترنوع پارامترتوضیحات
username String نام کاربری مربوط به حساب شما در سامانه
password String APIKey مربوط به حساب شما در سامانه
from String سرشمارۀ فرستنده (مثال ۱۰۰۰۰۱۲۳)
branch Int کد شاخۀ دریافت‌شده از متد GetBranchs
bulkType Byte تصادفی: 1 | ترتیبی: 2
title String عنوان ارسال (در متن پیامک ارسال نخواهد شد، صرفاً جهت تفکیک رکوردهای مختلف است)
message String متن پیامک (را با «لغو11» بنویسید)
rangeFrom Int از شماره موبایل، مثلاً 912280
rangeTo Int تا شماره موبایل، مثلاً 912289
DateToSend String تاریخ و زمان میلادی برای ارسال منطقه‌ای را با فرمت زیر وارد کنید:
(دقیقه:)(ساعت) (عدد روز میلادی) . (عدد ماه میلادی) . (عدد سال میلادی)،) به‌عنوان مثال: 2026.5.27T11:56
requestCount Int تعداد شماره‌های درخواستی که نباید بیشتر از شماره‌های موجود باشد
rowFrom Int تعیین ردیف درخواستی (به‌صورت پیشفرض می‌توانید از ردیف 0 درخواست کنید)

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

نام پارامترنوع پارامترتوضیحات
ReturnValue Int یک عدد: این عدد شناسۀ بستۀ ارسال (کد ارسال در ماژول منطقه، هدفمند) است. (این مقدار را جهت مشاهدۀ وضعیت ارسال می‌بایست ذخیره کنید)
0: نام کاربری یا APIKey حساب کاربری صحیح نیست.
AddBulk2
//بدون نیاز به پکیج گیت هاب Procedural PHP نمونه کدهای 
ini_set("soap.wsdl_cache_enabled", 0);

try {
    $client = new SoapClient(
        "https://api.payamak-panel.com/post/actions.asmx?wsdl",
        ["encoding" => "UTF-8"]
    );
    
    // تنظیم تاریخ ارسال با فرمت مخصوص AddBulk2
    // فرمت: دقیقه:ساعت روز.ماه.سال (مثال: 30:14T17.7.2024)
    $dateToSend = "30:14T17.7.2025"; // ۱۴:۳۰ روز ۱۷ جولای ۲۰۲5
    
    $data = [
        "username"    => "نام_کاربری_شما",    // نام کاربری پنل
        "password"    => "رمز_عبور_شما",      // رمز عبور پنل
        "from"        => "10000123",           // شماره فرستنده
        "branch"      => 123,                  // کد شاخه
        "bulkType"    => 1,                    // نوع ارسال (۱=تصادفی، ۲=ترتیبی)
        "title"       => "عنوان ارسال پیامک",  // عنوان گروه پیامک
        "message"     => "متن پیامک",          // متن پیام
        "rangeFrom"   => 912280,               // شروع رنج شماره‌ها
        "rangeTo"     => 912289,               // پایان رنج شماره‌ها
        "DateToSend"  => $dateToSend,          // زمان ارسال
        "requestCount"=> 10,                   // تعداد شماره‌های درخواستی
        "rowFrom"     => 0                     // شروع از ردیف
    ];
    
    $result = $client->AddBulk2($data)->AddBulk2Result;
    
    var_dump($result);
    
} catch (SoapFault $fault) {
    // خطاهای مرتبط با سرویس SOAP
    echo "خطا در ارتباط با سرویس:
";
echo "کد: " . $fault->faultcode . "
";
echo "پیام: " . $fault->faultstring; } catch (Exception $e) { // سایر خطاها echo "خطا: " . $e->getMessage(); }