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

با استفاده از وب‌سرویس پیامکی سیگنال می‌توانید وب‌سایت، اپلیکیشن، CRM ،CMS، برنامه‌های تحت وب، دستگاه‌های صنعتی و هر چیزی که قابل برنامه‌نویسی است را به سامانه پیامکی سیگنال متصل کنید و برای خود و کاربران‌تان به صورت خودکار یا زمانبندی‌شده پیامک خدماتی (اطلاع رسانی) یا تبلیغاتی ارسال کنید. مجهز کردن سایت به ابزار پیامک، برگ برنده شما برای مدیریت بهتر فعالیت‌ها و سفارشات و جلب رضایت مشتریان خواهد بود.

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

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

معرفی و امکانات

ارائه مستندات و نمونه کدها

افزونه‌های پیامکی

ارسال کد یک‌بار مصرف (OTP)

ارسال به دفترچه تلفن

ارسال تکی و گروهی

ارسال با الگو

دریافت پیامک

گزارش وضعیت تکی و گروهی

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

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

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

اتصال ساده و سریع فقط با چند خط کد

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

مستندات جامع + نمونه‌کد برای زبان‌های مختلف برنامه‌نویسی

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

import requests
import json

url = "https://transmitor.signalads.com/api_v1/sms/send"

payload = json.dumps({
  "from": "9890005274",
  "message": "YOUR TEXT",
  "numbers": [
    "09120000000"
  ],
  "send_at": "2026-07-01T08:37:35.302Z"
})
headers = {
  'accept': 'application/json',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

const axios = require('axios');
let data = JSON.stringify({
  "from": "9890005274",
  "message": "YOUR TEXT",
  "numbers": [
    "09120000000"
  ],
  "send_at": "2026-07-01T08:37:35.302Z"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://transmitor.signalads.com/api_v1/sms/send',
  headers: {
    'accept': 'application/json',
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_TOKEN'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"from\": \"9890005274\",\n  \"message\": \"YOUR TEXT\",\n  \"numbers\": [\n    \"09120000000\"\n  ],\n  \"send_at\": \"2026-07-01T08:37:35.302Z\"\n}");
Request request = new Request.Builder()
  .url("https://transmitor.signalads.com/api_v1/sms/send")
  .method("POST", body)
  .addHeader("accept", "application/json")
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Bearer YOUR_API_TOKEN")
  .build();
Response response = client.newCall(request).execute();

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://transmitor.signalads.com/api_v1/sms/send',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "from": "9890005274",
  "message": "YOUR TEXT",
  "numbers": [
    "09120000000"
  ],
  "send_at": "2026-07-01T08:37:35.302Z"
}',
  CURLOPT_HTTPHEADER => array(
    'accept: application/json',
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://transmitor.signalads.com/api_v1/sms/send");
request.Headers.Add("accept", "application/json");
request.Headers.Add("Authorization", "Bearer YOUR_API_TOKEN");
var content = new StringContent("{\n  \"from\": \"9890005274\",\n  \"message\": \"YOUR TEXT\",\n  \"numbers\": [\n    \"09120000000\"\n  ],\n  \"send_at\": \"2026-07-01T08:37:35.302Z\"\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://transmitor.signalads.com/api_v1/sms/send"
  method := "POST"

  payload := strings.NewReader(`{
  "from": "9890005274",
  "message": "YOUR TEXT",
  "numbers": [
    "09120000000"
  ],
  "send_at": "2026-07-01T08:37:35.302Z"
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("accept", "application/json")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Bearer YOUR_API_TOKEN")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

استعلام وضعیت پیامک

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

نتایج به‌صورت صفحه‌بندی‌شده ارائه می‌شوند (۵۰۰ گیرنده در هر صفحه).
این متد فقط برای پیامک‌های تکمیل‌شدهٔ خود شما قابل استفاده است.
در پیامک‌های خصوصی، شمارهٔ گیرنده‌ها به‌صورت ماسک‌شده نمایش داده می‌شوند (مانند 98*****789).

کدهای وضعیت

کد	توضیح
1	ارسال‌شده به اپراتور
2	به اپراتور نرسیده
3	به اپراتور رسیده
4	تحویل به گوشی
5	تحویل‌نشده به گوشی
6	برگشت / استرداد
7	خطای اپراتور
8	خطای ناشناخته
9	نامشخص
10	در لیست سیاه

پاسخ:

receptor_count — تعداد کل گیرندگان (بر اساس اطلاعات پیامک)
receptors — آرایه‌ای از گیرنده‌ها همراه با وضعیت تحویل
pagination — اطلاعات صفحه‌بندی (۵۰۰ گیرنده در هر صفحه)

خطاها: خطای 404 — پیامک پیدا نشد، متعلق به شما نیست یا هنوز تکمیل نشده است.

import requests

url = "https://transmitor.signalads.com/api_v1/sms/status/{msg_id}?page=1"

headers = {
  'accept': 'application/json',
  'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.request("GET", url, headers=headers)

print(response.text)

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://transmitor.signalads.com/api_v1/sms/status/{msg_id}?page=1',
  headers: {
    'accept': 'application/json',
    'Authorization': 'Bearer YOUR_API_TOKEN'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://transmitor.signalads.com/api_v1/sms/status/{msg_id}?page=1")
  .method("GET", null)
  .addHeader("accept", "application/json")
  .addHeader("Authorization", "Bearer YOUR_API_TOKEN")
  .build();
Response response = client.newCall(request).execute();

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://transmitor.signalads.com/api_v1/sms/status/{msg_id}?page=1',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'accept: application/json',
    'Authorization: Bearer YOUR_API_TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://transmitor.signalads.com/api_v1/sms/status/{msg_id}?page=1");
request.Headers.Add("accept", "application/json");
request.Headers.Add("Authorization", "Bearer YOUR_API_TOKEN");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://transmitor.signalads.com/api_v1/sms/status/{msg_id}?page=1"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("accept", "application/json")
  req.Header.Add("Authorization", "Bearer YOUR_API_TOKEN")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

متد: GET — مسیر: /api_v1/sms/status/{msg_id}?page={page}

ارسال پیامک با الگو (Pattern)

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

استفاده از الگوهای ذخیره‌شده برای تولید متن پیامک
جایگزینی پارامترهای پویا در قالب الگو
ارسال به یک گیرنده در هر درخواست
محاسبهٔ خودکار انکودینگ و تعداد صفحات پیامک
اعتبارسنجی دسترسی به خط ارسال

احراز هویت: نیازمند کلید API یا توکن نشست (Session Token).

پارامترهای الگو:

الگوها قالب‌هایی متعلق به شما با محل‌نما (Placeholder) هستند.
پارامترها در متن الگو جایگزین می‌شوند؛ مثلاً {otp} یا {name}.
تمام پارامترهای الزامی باید ارسال شوند.

بدنهٔ درخواست:

pattern_id — شناسهٔ الگوی ذخیره‌شدهٔ شما
from — شمارهٔ خط فرستنده (باید به آن دسترسی داشته باشید)
number — شمارهٔ موبایل گیرنده (یکی در هر درخواست)
parameters — زوج‌های کلید/مقدار برای متغیرهای الگو

import requests
import json

url = "https://transmitor.signalads.com/api_v1/sms/pattern/send"

payload = json.dumps({
  "from": "9890005274",
  "pattern_id": 0,
  "number": "09120000000",
  "parameters": {
    "otp": "1234",
    "name": "کاربر"
  }
})
headers = {
  'accept': 'application/json',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

const axios = require('axios');
let data = JSON.stringify({
  "from": "9890005274",
  "pattern_id": 0,
  "number": "09120000000",
  "parameters": {
    "otp": "1234",
    "name": "کاربر"
  }
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://transmitor.signalads.com/api_v1/sms/pattern/send',
  headers: {
    'accept': 'application/json',
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_TOKEN'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"from\": \"9890005274\",\n  \"pattern_id\": 0,\n  \"number\": \"09120000000\",\n  \"parameters\": {\n    \"otp\": \"1234\",\n    \"name\": \"کاربر\"\n  }\n}");
Request request = new Request.Builder()
  .url("https://transmitor.signalads.com/api_v1/sms/pattern/send")
  .method("POST", body)
  .addHeader("accept", "application/json")
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Bearer YOUR_API_TOKEN")
  .build();
Response response = client.newCall(request).execute();

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://transmitor.signalads.com/api_v1/sms/pattern/send',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "from": "9890005274",
  "pattern_id": 0,
  "number": "09120000000",
  "parameters": {
    "otp": "1234",
    "name": "کاربر"
  }
}',
  CURLOPT_HTTPHEADER => array(
    'accept: application/json',
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://transmitor.signalads.com/api_v1/sms/pattern/send");
request.Headers.Add("accept", "application/json");
request.Headers.Add("Authorization", "Bearer YOUR_API_TOKEN");
var content = new StringContent("{\n  \"from\": \"9890005274\",\n  \"pattern_id\": 0,\n  \"number\": \"09120000000\",\n  \"parameters\": {\n    \"otp\": \"1234\",\n    \"name\": \"کاربر\"\n  }\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://transmitor.signalads.com/api_v1/sms/pattern/send"
  method := "POST"

  payload := strings.NewReader(`{
  "from": "9890005274",
  "pattern_id": 0,
  "number": "09120000000",
  "parameters": {
    "otp": "1234",
    "name": "کاربر"
  }
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("accept", "application/json")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Bearer YOUR_API_TOKEN")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

متد: POST — مسیر: /api_v1/sms/pattern/send

ارسال پیام صوتی (وویس)

با استفاده از این متد می‌توانید یک فایل صوتی از پیش ضبط‌شده را به‌صورت تماس صوتی برای یک یا چند گیرنده ارسال کنید.

ارسال فایل‌های صوتی از پیش ضبط‌شده از طریق تماس صوتی
پشتیبانی از چند گیرنده در یک درخواست
اعتبارسنجی و پردازش فایل صوتی
امکان زمان‌بندی تماس‌های صوتی
انتخاب خودکار گیتوی (Gateway)
اعتبارسنجی دسترسی به خط

احراز هویت: الزامی است.

الزامات فایل صوتی:

فایل صوتی باید از پیش بارگذاری و تأیید شده باشد.
فرمت‌های پشتیبانی‌شده: MP3, WAV, M4A
حداکثر مدت: ۶۰ ثانیه به‌ازای هر تماس
کیفیت پیشنهادی: ۱۲۸ کیلوبیت بر ثانیه

محدودیت‌ها و هزینه:

بر اساس موجودی اعتبار کاربر
هزینهٔ تماس صوتی به‌ازای هر گیرنده محاسبه می‌شود

زمان‌بندی: منطقهٔ زمانی Asia/Tehran — حداقل ۱۰ دقیقه قبل برای تماس‌های زمان‌بندی‌شده.

import requests
import json

url = "https://transmitor.signalads.com/api_v1/audio/{audio_id}/send"

payload = json.dumps({
  "receptors": [
    "09120000000"
  ],
  "send_at": "2026-07-01T10:54:26.379Z"
})
headers = {
  'accept': 'application/json',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

const axios = require('axios');
let data = JSON.stringify({
  "receptors": [
    "09120000000"
  ],
  "send_at": "2026-07-01T10:54:26.379Z"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://transmitor.signalads.com/api_v1/audio/{audio_id}/send',
  headers: {
    'accept': 'application/json',
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_TOKEN'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"receptors\": [\n    \"09120000000\"\n  ],\n  \"send_at\": \"2026-07-01T10:54:26.379Z\"\n}");
Request request = new Request.Builder()
  .url("https://transmitor.signalads.com/api_v1/audio/{audio_id}/send")
  .method("POST", body)
  .addHeader("accept", "application/json")
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Bearer YOUR_API_TOKEN")
  .build();
Response response = client.newCall(request).execute();

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://transmitor.signalads.com/api_v1/audio/{audio_id}/send',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "receptors": [
    "09120000000"
  ],
  "send_at": "2026-07-01T10:54:26.379Z"
}',
  CURLOPT_HTTPHEADER => array(
    'accept: application/json',
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://transmitor.signalads.com/api_v1/audio/{audio_id}/send");
request.Headers.Add("accept", "application/json");
request.Headers.Add("Authorization", "Bearer YOUR_API_TOKEN");
var content = new StringContent("{\n  \"receptors\": [\n    \"09120000000\"\n  ],\n  \"send_at\": \"2026-07-01T10:54:26.379Z\"\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://transmitor.signalads.com/api_v1/audio/{audio_id}/send"
  method := "POST"

  payload := strings.NewReader(`{
  "receptors": [
    "09120000000"
  ],
  "send_at": "2026-07-01T10:54:26.379Z"
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("accept", "application/json")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Bearer YOUR_API_TOKEN")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

متد: POST — مسیر: /api_v1/audio/{audio_id}/send

ارسال کد یکبار مصرف (OTP)

با استفاده از این متد می‌توانید یک کد یکبار مصرف (OTP) را برای شمارهٔ موبایل کاربر ارسال کنید.

تولید خودکار کد (۴ تا ۶ رقم)
پشتیبانی از شمارهٔ ایران (+98) و عراق (+964)
امکان ارسال OTP مبتنی بر الگو (Pattern)
مدیریت انقضای کد و تلاش مجدد
جلوگیری از درخواست‌های تکراری

احراز هویت: الزامی است.

محدودیت‌ها:

حداکثر ۳ تلاش به‌ازای هر شماره در ساعت
کد پس از ۵ دقیقه منقضی می‌شود

الگو در برابر پیام ساده:

با pattern_id: از الگوی پیامک از پیش تعریف‌شده استفاده می‌کند.
بدون pattern_id: پیامک سادهٔ متنی حاوی کد ارسال می‌شود.

import requests
import json

url = "https://transmitor.signalads.com/api_v1/otp/send"

payload = json.dumps({
  "mobile": "09120000000",
  "pattern_id": 0
})
headers = {
  'accept': 'application/json',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

const axios = require('axios');
let data = JSON.stringify({
  "mobile": "09120000000",
  "pattern_id": 0
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://transmitor.signalads.com/api_v1/otp/send',
  headers: {
    'accept': 'application/json',
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_TOKEN'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"mobile\": \"09120000000\",\n  \"pattern_id\": 0\n}");
Request request = new Request.Builder()
  .url("https://transmitor.signalads.com/api_v1/otp/send")
  .method("POST", body)
  .addHeader("accept", "application/json")
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Bearer YOUR_API_TOKEN")
  .build();
Response response = client.newCall(request).execute();

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://transmitor.signalads.com/api_v1/otp/send',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "mobile": "09120000000",
  "pattern_id": 0
}',
  CURLOPT_HTTPHEADER => array(
    'accept: application/json',
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://transmitor.signalads.com/api_v1/otp/send");
request.Headers.Add("accept", "application/json");
request.Headers.Add("Authorization", "Bearer YOUR_API_TOKEN");
var content = new StringContent("{\n  \"mobile\": \"09120000000\",\n  \"pattern_id\": 0\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://transmitor.signalads.com/api_v1/otp/send"
  method := "POST"

  payload := strings.NewReader(`{
  "mobile": "09120000000",
  "pattern_id": 0
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("accept", "application/json")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Bearer YOUR_API_TOKEN")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

متد: POST — مسیر: /api_v1/otp/send

ارسال مجدد کد یکبار مصرف (OTP)

با استفاده از این متد می‌توانید کد یکبار مصرف را در همان نشست (Session) فعال، مجدداً برای کاربر ارسال کنید.

ارسال مجدد کد در همان نشست
بازنشانی تایمر انقضا
حفظ شمارندهٔ تلاش‌ها
پشتیبانی از ارسال مبتنی بر الگو

احراز هویت: الزامی است.

محدودیت‌ها:

حداکثر ۳ ارسال مجدد در هر نشست
فاصلهٔ زمانی بین ارسال‌ها: ۳۰ ثانیه

مدیریت نشست:

شناسهٔ uuid باید متعلق به یک نشست معتبر باشد.
نشست نباید منقضی شده باشد.
کد قبلی نامعتبر می‌شود.

import requests
import json

url = "https://transmitor.signalads.com/api_v1/otp/retry"

payload = json.dumps({
  "uuid": "11111111-2222-3333-4444-555555555555"
})
headers = {
  'accept': 'application/json',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

const axios = require('axios');
let data = JSON.stringify({
  "uuid": "11111111-2222-3333-4444-555555555555"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://transmitor.signalads.com/api_v1/otp/retry',
  headers: {
    'accept': 'application/json',
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_TOKEN'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"uuid\": \"11111111-2222-3333-4444-555555555555\"\n}");
Request request = new Request.Builder()
  .url("https://transmitor.signalads.com/api_v1/otp/retry")
  .method("POST", body)
  .addHeader("accept", "application/json")
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Bearer YOUR_API_TOKEN")
  .build();
Response response = client.newCall(request).execute();

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://transmitor.signalads.com/api_v1/otp/retry',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "uuid": "11111111-2222-3333-4444-555555555555"
}',
  CURLOPT_HTTPHEADER => array(
    'accept: application/json',
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://transmitor.signalads.com/api_v1/otp/retry");
request.Headers.Add("accept", "application/json");
request.Headers.Add("Authorization", "Bearer YOUR_API_TOKEN");
var content = new StringContent("{\n  \"uuid\": \"11111111-2222-3333-4444-555555555555\"\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://transmitor.signalads.com/api_v1/otp/retry"
  method := "POST"

  payload := strings.NewReader(`{
  "uuid": "11111111-2222-3333-4444-555555555555"
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("accept", "application/json")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Bearer YOUR_API_TOKEN")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

متد: POST — مسیر: /api_v1/otp/retry

تأیید کد یکبار مصرف (OTP)

با استفاده از این متد می‌توانید کد واردشده توسط کاربر را در برابر نشست اعتبارسنجی کنید.

اعتبارسنجی کد در برابر نشست
پشتیبانی از ارقام فارسی و عربی
پاک‌سازی خودکار نشست پس از تأیید
ردیابی تلاش‌ها و مسدودسازی

احراز هویت: الزامی است.

قواعد اعتبارسنجی:

کد باید دقیقاً با کد نشست مطابقت داشته باشد.
نشست نباید منقضی شده باشد.
حداکثر ۵ تلاش تأیید در هر نشست.
پشتیبانی از ارقام فارسی (۰-۹) و عربی (٠-٩).

امنیت:

نشست پس از ۵ تلاش ناموفق قفل می‌شود.
کدها به بزرگی و کوچکی حروف حساس نیستند (Case-insensitive).
نشست پس از تأیید موفق نامعتبر می‌شود.

import requests
import json

url = "https://transmitor.signalads.com/api_v1/otp/verify"

payload = json.dumps({
  "uuid": "11111111-2222-3333-4444-555555555555",
  "code": "12345"
})
headers = {
  'accept': 'application/json',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_API_TOKEN'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

const axios = require('axios');
let data = JSON.stringify({
  "uuid": "11111111-2222-3333-4444-555555555555",
  "code": "12345"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://transmitor.signalads.com/api_v1/otp/verify',
  headers: {
    'accept': 'application/json',
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_TOKEN'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n  \"uuid\": \"11111111-2222-3333-4444-555555555555\",\n  \"code\": \"12345\"\n}");
Request request = new Request.Builder()
  .url("https://transmitor.signalads.com/api_v1/otp/verify")
  .method("POST", body)
  .addHeader("accept", "application/json")
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Bearer YOUR_API_TOKEN")
  .build();
Response response = client.newCall(request).execute();

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://transmitor.signalads.com/api_v1/otp/verify',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "uuid": "11111111-2222-3333-4444-555555555555",
  "code": "12345"
}',
  CURLOPT_HTTPHEADER => array(
    'accept: application/json',
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://transmitor.signalads.com/api_v1/otp/verify");
request.Headers.Add("accept", "application/json");
request.Headers.Add("Authorization", "Bearer YOUR_API_TOKEN");
var content = new StringContent("{\n  \"uuid\": \"11111111-2222-3333-4444-555555555555\",\n  \"code\": \"12345\"\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://transmitor.signalads.com/api_v1/otp/verify"
  method := "POST"

  payload := strings.NewReader(`{
  "uuid": "11111111-2222-3333-4444-555555555555",
  "code": "12345"
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("accept", "application/json")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Bearer YOUR_API_TOKEN")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

متد: POST — مسیر: /api_v1/otp/verify

افزونه‌ها و ماژول‌های پیامک

اگر سایت شما با استفاده از سیستم مدیریت محتوا مانند وردپرس یا جوملا نوشته شده است، بهترین راه اتصال به سامانه پیامکی سیگنال، استفاده از افزونه و ماژول پیامک است.

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

افزونه Digits

توضیحات و راهنما

افزونه پیامک WordPress

توضیحات و راهنما

افزونه wp-sms

توضیحات و راهنما

افزونه Contact Form 7

توضیحات و راهنما

افزونه Woocommerce

توضیحات و راهنما

افزونه نظرسنجی Woocommerce

توضیحات و راهنما

افزونه کراسنو

توضیحات و راهنما

افزونه آوانس

توضیحات و راهنما

افزونه حمل‌ونقل Woocommerce

توضیحات و راهنما

افزونه مقایسه محصول Woocommerce

توضیحات و راهنما

افزونه گرویتی فرم

توضیحات و راهنما

افزونه whmcs

توضیحات و راهنما

افزونه تایید شماره whmcs

افزونه OpenCart

افزونه Virtual Freer

افزونه Magento

افزونه کد تایید جوملا

افزونه پیامک جوملا

افزونه Tomato Cart

افزونه PrestaShop

افزونه نظرسنجی آراد

افزونه رزرواسیون Bookly

توضیحات و راهنما

افزونه استعلام گارانتی سریر

توضیحات و راهنما

همهٔ افزونه‌های پیامکی

وب سرویس ارسال پیامک رایگان پیام رسان مناسب چه کسانی است؟

توسعه‌دهندگان موبایل:اگر به دنبال راهی برای ادغام قابلیت API ارسال پیامک در وب‌سایت‌ها و برنامه‌های وب خود هستید ما برای شما پیشنهادات ویژه‌ای داریم.

توسعه‌دهندگان وب:اضافه کردن امکان ارسال پیامک در برنامه های موبایل با وب‌سرویس پیامکی امکان‌پذیر است.

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

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

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

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

بهترین وب سرویس ارسال پیامک باید ویژگی‌هایی داشته باشد که در زیر به آنها اشاره می کنیم:

رایگان بودن‌: وب سرویس اس ام اس در سامانه سیگنال برای نرم‌افزارها، اپلیکیشن ها و وب‌سایت ها بصورت 100% رایگان وجود دارد.
پشتیبانی فنی: یک تیم برنامه‌نویس مسلط به زبان های برنامه نویسی php ، سی شارپ، ASP و … به همراه متخصصین وردپرس آماده ارائه پشتیبانی به کاربران وب‌سرویس پیامکی باشد.
آپ تایم بالا و سرعت فوق العاده:بهترین وب سرویس sms باید آپتایم بالایی در حد 99 درصد داشته باشد. همچنین سرعت ارسال پیامک در وب سرویس ارسال سریع پیامک، باید بسیار بالا باشد تا پاسخگوی نیاز های کاربران باشد.
مستندات آماده:api ارسال پیامک رایگان زمانی بهترین محسوب می‌شود که تمامی مستندات و نمونه کدهای آماده بصورت رایگان در اختیار کاربران قرار گیرد.

می‌خواهید از وب‌سرویس سیگنال استفاده کنید؟

ثبت‌نام رایگان

آیا نیاز به دریافت مشاوره تخصصی دارید؟