۰۲۱-۹۱۰۹۰۲۶۲ سوالات متداول مستندات API
همه‌ی سرویس‌ها فعال‌اند · آپتایم ۹۹٫۹٪
وب‌سرویس پیامک

چند خط کد تا اولین پیامک

وب‌سرویس API پیامک خط ارسال مدرن، ساده و مستند است. نمونه کد آماده برای Laravel، PHP، Node.js و Python داریم و اتصال سایت یا نرم‌افزار شما به سامانه پیامکی معمولاً کمتر از یک ساعت طول می‌کشد.

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

چند خط کد تا اولین پیامک

وب‌سرویس API پیامک خط ارسال مدرن، ساده و مستند است. نمونه کد آماده برای Laravel، PHP، Node.js و Python داریم و اتصال سایت یا نرم‌افزار شما به سامانه پیامکی معمولاً کمتر از یک ساعت طول می‌کشد.

// app/Http/Controllers/AuthController.php
namespace App\Http\Controllers;

use Linesend\Facades\SMS;
use Illuminate\Support\Facades\Cache;

class AuthController extends Controller
{
    public function sendOtp(Request $request)
    {
        $request->validate([
            'mobile' => ['required', 'iran_mobile'],
        ]);

        $code = random_int(100000, 999999);

        Cache::put("otp:{$request->mobile}", $code, now()->addMinutes(5));

        SMS::pattern('login_otp_145')
            ->to($request->mobile)
            ->data([
                'code' => $code,
                'name' => 'کاربر عزیز',
            ])
            ->dispatch();   // صف می‌شود — غیرهمزمان

        return response()->json(['sent' => true], 202);
    }
}
// send_otp.php — بدون هیچ فریم‌ورکی
$client = new Linesend\Client(getenv('LINESEND_API_KEY'));

$code = str_pad(random_int(0, 999999), 6, '0', STR_PAD_LEFT);

$res = $client->messages->send([
    'to'      => $mobile,
    'pattern' => 'login_otp_145',
    'data'    => ['code' => $code, 'name' => 'کاربر عزیز'],
]);

if ($res->status === 'queued') {
    error_log("msg_id={$res->message_id}");
}
// sendOtp.mjs
import { Linesend } from '@linesend/node';

const linesend = new Linesend({
  apiKey: process.env.LINESEND_API_KEY,
});

export async function sendOtp(mobile, name) {
  const code = Math.floor(100000 + Math.random() * 900000);

  const res = await linesend.messages.send({
    to: mobile,
    pattern: 'login_otp_145',
    data: { code, name },
  });

  return res.message_id;  // msg_8f21c4d9
}
# send_otp.py
import os
from linesend import Client

client = Client(api_key=os.environ["LINESEND_API_KEY"])

def send_otp(mobile: str, name: str) -> str:
    code = f"{secrets.randbelow(1000000):06d}"

    res = client.messages.send(
        to=mobile,
        pattern="login_otp_145",
        data={"code": code, "name": name},
    )

    return res.message_id   # 202 Accepted
curl -X POST https://api.linesend.ir/v1/messages/send \
  -H "Authorization: Bearer $LINESEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "09121234567",
    "pattern": "login_otp_145",
    "data": { "code": "483921", "name": "کاربر عزیز" }
  }'
POST /v1/messages/send auth: Bearer · rate-limit: 100 rps
پاسخ API202 Accepted · 0.21s
{
  "message_id": "msg_8f21c4d9",
  "status":     "queued",
  "to":         "09121234567",
  "pattern":    "login_otp_145",
  "channel":    "service_shared",
  "created_at": "2026-10-04T14:02:11+03:30"
}
وب‌هوک وضعیت تحویلPOST /webhooks/linesend
X-Linesend-Signature: t=1791112931,v1=9f86d081…

{
  "event":      "message.delivered",
  "message_id": "msg_8f21c4d9",
  "status":     "delivered",
  "latency_ms": 2810,
  "dlr":        "success"
}

نمونه کد ارسال پیامک در Laravel و افزونه‌های وردپرس

پکیج رسمی laravel/sms یک Facade ساده در اختیار شما می‌گذارد: الگوی پیامک را انتخاب کنید، شماره و متغیرها را بدهید و دستور dispatch() را صدا بزنید تا پیامک در صف قرار بگیرد. اگر سایت شما وردپرس یا ووکامرس است، افزونه‌های آماده فقط با درج کلید API راه‌اندازی می‌شوند و نیازی به کدنویسی نیست.

افزونه‌های آماده وردپرس، ووکامرس، دیجیتس و اپن‌کارت بدون کدنویسی
مستندات فارسی مستندات کامل API به همراه مستندات Swagger تعاملی
یکپارچه‌سازی

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

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

LINESend API وب‌سرویس RESTful · احراز هویت Bearer · وب‌هوک · مستندات Swagger
PHPکلاینت PSR-4
Laravelپکیج رسمی facade
Node.jsپکیج @linesend/node
Pythonپکیج PyPI
WordPressافزونه رسمی
WooCommerceسبد خرید وردپرس
REST APIمستندات Swagger
Webhookگزارش تحویل لحظه‌ای

افزونه‌های آماده: دیجیتس، اپن‌کارت، WHMCS و جوملا نمونه کد: PHP · Laravel · Node.js · Python · cURL

پایش لحظه‌ای

وضعیت لحظه‌ای سامانه پیامکی

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

دفترچه‌ی پیامک‌های ارسالی همه‌ی سرویس‌ها فعال‌اند
requests / min
0
delivered today
0%
avg otp latency
2.8s
queue depth
0
آخرین پیامک‌های ارسال‌شده در سامانه پیامکی خط ارسال
timerequest idroute typelatencystatus

همین حالا پنل پیامکی خود را راه‌اندازی کنید

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

پشتیبانی تلفنی و تیکت · ۰۲۱-۹۱۰۹۰۲۶۲ · پاسخ‌گویی در ساعات اداری
مشاوره رایگان تلفنی