مرکز پیام سازمانیدر صف ارسال
۰منتظر پردازش پنل ITFA
IT
در حال دریافت تاریخ…
تهران
داشبورد ارسال
مرکز کنترل پیام
سلامت کانال‌ها، صف پیام و فعالیت اخیر را در یک نگاه مدیریت کنید.
در حال ارسال
۰ارتباط با مودمپذیرفتهشده
۰تأییدشده توسط مودمنیازمند بررسی
۰خطا یا وضعیت نامشخصگزارش زندهٔ ارتباط
وضعیت مودم و کانال‌ها
هنوز نمونه‌برداری انجام نشده استدر انتظار بررسی دستگاه
TCP متصل—
مودم پاسخ‌گو—
سیم‌کارت آماده—
ثبت شبکه—
خلاصهٔ ارتباط پس از دریافت نمونهٔ واقعی مودم نمایش داده می‌شود.
وضعیت کانال‌ها در انتظار دریافت است.
ارسال سریع
ارسال آزمایشی یا پیام دستی
پایش سخت‌افزار و مودم
وضعیت دستگاه و کانال‌ها
عیب‌یابی مستقیم مودم، وضعیت سیم‌کارت و شبکه، IMEI و آمار سریال‌سرور
نمای زندهٔ سخت‌افزار
سلامت دستگاه و مسیرها
در انتظار نمونه‌برداری واقعی از مودمهاوضعیت واقعی پس از خواندن پاسخ مودم و سریال‌سرور نمایش داده می‌شود.
هنوز نتیجه‌ای برای جمع‌بندی وجود ندارد.
پس از دریافت وضعیت واقعی مودم‌ها، الگوی مشترک بین کانال‌ها محاسبه می‌شود.
پایش و عیب‌یابی کانال‌ها
پاسخ AT، سیم‌کارت، سیگنال خام، ثبت شبکه و IMEI مستقیماً از هر مودم خوانده می‌شود.
در انتظار بررسی۰ کانال
در انتظار دریافت وضعیت
وضعیت زنده هنوز دریافت نشده است.
راه‌اندازی مجدد سریال‌سرور
وضعیت هنوز بررسی نشدهفرمان از صفحهٔ رسمی «Reboot Server» دستگاه اجرا می‌شود. با ری‌استارت، اتصال همهٔ پورت‌های سریال موقتاً قطع می‌شود؛ پیام در حال ارسال ممکن است نتیجهٔ نامشخص پیدا کند. اگر رابط وب دستگاه هم پاسخ ندهد، راه‌اندازی نرم‌افزاری در دسترس نیست و باید برق دستگاه را قطع و وصل کنید.
دستگاه: در انتظار دریافت ری‌استارت دستگاه
آمار هر پورت سریال
شمارنده‌ها و وضعیت خطوط از رابط آماری خود دستگاه خوانده می‌شوند.
| کانال / پورت TCP | تنظیم سریال | کنترل جریان | ارسال سریال | دریافت سریال | خطوط RS-232 | وضعیت TCP |
|---|
آمار هنوز دریافت نشده است.
معنی وضعیت‌ها
دستگاه آنلاین یعنی رابط وب سریال‌سرور از شبکه پاسخ می‌دهد. در جدول TCP، LISTEN یعنی پورت منتظر اتصال است و ESTABLISHED یعنی یک اتصال فعال روی پورت وجود دارد. هنگام عیب‌یابی ممکن است LISTEN موقتاً دیده نشود؛ این وضعیت به‌تنهایی نشانهٔ آفلاین‌بودن دستگاه نیست. پاسخ AT، سیم‌کارت و ثبت شبکه جداگانه سنجیده می‌شوند.
مدیریت سخت‌افزار و درایورها
دستگاه‌ها و مودم‌ها
مودم‌های استاندارد AT را از USB/COM یا TCP و مودم‌های LTE میکروتیک را از RouterOS REST متصل کنید.
دستگاه‌های ثبت‌شده—Wavecom و دستگاه‌های افزوده‌شده
مجاز برای ارسال—تنظیم صف ارسال دستگاه
پاسخ مودم در نمونهٔ اخیر—پاسخ واقعی AT یا LTE/REST
پورت COM روی سرور—درایور و مودمِ همین ویندوز
وضعیت کانال‌ها هنوز بررسی نشده است. «مجاز برای ارسال» به معنی آنلاین‌بودن مودم نیست.
سازگاری بر اساس رابط و پروتکل دستگاه
مودم‌های سازگار با AT/PDU از USB/COM یا TCP شفاف کار می‌کنند؛ MikroTik فقط وقتی قابل اتصال است که RouterOS رابط LTE و ابزار SMS سازگار داشته باشد. دستگاه‌هایی با پروتکل اختصاصی فقط پس از افزودن درایور همان سازنده قابل استفاده‌اند. نام سازنده به‌تنهایی سازگاری را تضمین نمی‌کند.
هر دستگاه ابتدا متوقف ثبت می‌شود؛ پنل برای ثبت دستگاه، فرمان تغییر تنظیمات به مودم یا روتر نمی‌فرستد.مودم USB یا پورت COMدرایور ویندوز، شمارهٔ COM، سرعت و کنترل جریان
- مودم را مستقیم به سرور ویندوز وصل کنید و درایور رسمی همان مدل را نصب کنید.
- در Device Manager زیر Ports (COM & LPT) شمارهٔ COM را پیدا کنید؛ اگر دستگاه چند پورت دارد، پورت AT/Modem را انتخاب کنید.
- در فرم، پورت COM، baud rate و flow control مطابق دفترچهٔ مودم را تعیین کنید. هیچ COM را هم‌زمان در نرم‌افزار دیگری باز نگذارید.
- این مسیر به پشتیبانی AT و SMS در حالت PDU نیاز دارد. پس از افزودن، وضعیت کانال را بازخوانی کنید؛ تا پاسخ واقعی مودم نیامده دستگاه را فعال نکنید.
درایور سازنده باید پورت COM واقعی بسازد. مبدل USB به سریال، درایور اختصاصی و کابل مناسب نیز باید در همان سرور در دسترس باشند.
مودم یا سریال‌سرور شبکه‌ای با AT شفافIP و پورت دادهٔ AT، نه پورت مدیریت وب
- IP و پورت داده را از دفترچهٔ سازنده پیدا کنید؛ باید اتصال TCP را به جریان فرمان AT همان مودم وصل کند.
- پورت مدیریت وب، SNMP، SSH یا پورت خامی که فقط کنترل سریال را عبور می‌دهد، درایور AT محسوب نمی‌شود.
- اگر دستگاه سریال‌سرور است، ابتدا روی خود آن baud rate و نگاشت هر پورت به مودم را تنظیم کنید.
- در پنل برای هر پورت یک کانال بسازید. قبل از فعال‌سازی پاسخ AT، وضعیت سیم‌کارت و ثبت شبکه را بررسی کنید.
ارسال فارسی و ایموجی با درایور AT پنل از PDU/UCS2 انجام می‌شود؛ قابلیت‌هایی مثل USSD به فرمان‌های پشتیبانی‌شدهٔ مودم بستگی دارند.
MikroTik · RouterOS REST برای مودم LTEفقط مدل دارای LTE/SMS سازگار · اتصال HTTPS از سرور
شرط سازگاری
خود روتر باید در RouterOS رابطی مثل lte1 و فرمان /tool sms send داشته باشد. همهٔ روترهای MikroTik سیم‌کارت‌خور نیستند و همهٔ مودم‌ها هم SMS را پشتیبانی نمی‌کنند. این مسیر از شبکهٔ LTE خود روتر استفاده می‌کند؛ نصب COM مجازی روی سرور لازم نیست.
- RouterOS را به نسخهٔ پشتیبانی‌شده به‌روز کنید و در ترمینال روتر وجود
/interface lte printو/tool sms sendرا بررسی کنید. - برای HTTPS یک CA و گواهی سرور بسازید، گواهی سرور را روی
www-sslقرار دهید و فایل CA را در Windows سرور پنل به Trusted Root اضافه کنید. آدرس فرم باید با IP یا DNS موجود در SAN گواهی یکی باشد. نمونه را با IP واقعی روتر جایگزین کنید:/certificate/add name=rest-ca common-name=rest-ca key-usage=key-cert-sign,crl-sign days-valid=3650 /certificate/sign rest-ca :delay 3s /certificate/add name=rest-https common-name=192.168.30.1 subject-alt-name=IP:192.168.30.1 days-valid=365 /certificate/sign rest-https ca=rest-ca :delay 3s /certificate/export-certificate rest-ca file-name=rest-ca /ip/service/set www-ssl certificate=rest-https disabled=no /ip/service/webserver/set rest-plain=no
- یک کاربر REST مجزا بسازید؛ گذرواژهٔ نمونه را با گذرواژهٔ قوی خودتان عوض کنید و دسترسی کاربر را به IP سرور پنل محدود کنید:
/user/group/add name=sms-panel policy=read,write,api,rest-api /user/add name=sms-panel group=sms-panel password="CHANGE-THIS-PASSWORD" /user/set [find name=sms-panel] address=192.168.30.126/32 /ip/service/set api-ssl address=192.168.30.126/32 /ip/service/set www-ssl available-from=192.168.30.126/32 /ip/service/webserver/set rest-plain=no
به‌جای192.168.30.126، IP ثابت Windows سرور پنل را وارد کنید. دسترسی را به اینترنت باز نکنید. DPAPI از گذرواژه در حالت ذخیره محافظت می‌کند؛ برای انتقال رمز از مرورگر به پنل در شبکهٔ غیرقابل‌اعتماد، HTTPS reverse proxy لازم است. - در فرم پایین نوع MikroTik را انتخاب کنید، IP روتر، پورت HTTPS (معمولاً 443)، نام LTE مثل
lte1، نام کاربری و گذرواژه را وارد و ذخیره کنید. گذرواژه با DPAPI ویندوز و حساب سرویس رمز می‌شود و در پاسخ پنل یا مرورگر برگردانده نمی‌شود. - پس از ثبت، پنل API-SSL و REST را جداگانه می‌سنجد؛ وضعیت SIM را با CPIN و ثبت LTE را با CEREG (و در صورت پشتیبانی‌نشدن، CREG) می‌خواند. کانال تازه غیرفعال می‌ماند تا آن را بررسی و فعال کنید.
محدودیت متن
RouterOS ارسال SMS را با GSM 7 انجام می‌دهد و UCS2 را پشتیبانی نمی‌کند؛ بنابراین فارسی، ایموجی و متن بیش از ۱۶۰ واحد GSM 7 روی این نوع اتصال رد می‌شود. پیام پیش از تماس با روتر اعتبارسنجی می‌شود. USSD در پنل غیرفعال نمایش داده می‌شود؛ RouterOS پاسخ +CUSD را به‌صورت رویداد ناهم‌زمان می‌فرستد و هنوز به نشست تعاملی پنل متصل نشده است.
مستند رسمی: REST API و کاربر محدودشده · رابط LTE و پایش مودم · ابزار SMS و محدودیت کدگذاری
دستگاه‌های ثبت‌شده
شمارهٔ کانال هر دستگاه پس از افزودن ثابت می‌ماند تا صف و سوابق پیام جابه‌جا نشوند.
فهرست دستگاه‌ها در حال دریافت است.
افزودن دستگاه
درگاه ارتباط، مسیرها و سرعت ارتباط سریال را مشخص کنید.
دسترسی شبکهٔ دستگاه نشانی DNS، IP خصوصی یا IP عمومی پذیرفته می‌شود؛ سرور پنل باید مسیر شبکه تا دستگاه داشته باشد. پورت خام AT را مستقیم روی اینترنت باز نکنید؛ برای آن VPN یا تونل رمزنگاری‌شده و محدودسازی IP مبدأ لازم است. برای MikroTik فقط HTTPS و API-SSL معتبر را فعال کنید.
ابزارهای سیم‌کارت
فرمان USSD
کد را روی یک کانال مشخص اجرا کنید و پاسخ دریافتی از مودم یا شبکه را ببینید.
در انتظار دریافت کانال‌ها
اجرای کد روی سیم‌کارت انتخاب‌شده
فرمان فقط به مودم کانال انتخابی فرستاده می‌شود؛ وضعیت SIM و مسیر هر کانال کنار نام آن نمایش داده می‌شود.
نشست تعاملی در انتظار پاسخ
برای ادامه، پاسخ شبکه را روی همان کانال وارد کنید.
پاسخ کد در همین صفحه نشان داده می‌شود. کانال MikroTik در این فهرست غیرفعال است؛ RouterOS پاسخ USSD را رویداد ناهم‌زمان ثبت می‌کند و این پنل هنوز آن را به نشست تعاملی وصل نمی‌کند. بعضی کدها تنظیم سیم‌کارت یا هزینهٔ سرویس را تغییر می‌دهند؛ پیش از اجرا، شمارهٔ کانال و متن کد را بررسی کنید.
برای شروع، یک کانال انتخاب کنید. فرمانی اجرا نشده است.
وضعیت کانال را تازه کنید
۲فهرست کانال‌ها از پیکربندی دستگاه‌ها دریافت می‌شود و نام مسیر و وضعیت سیم‌کارت را نشان می‌دهد.
کانال و کد را انتخاب کنید
۳کدهای عددی و نویسه‌های * و # و + پذیرفته می‌شوند.
پاسخ را بررسی کنید
تا پایان پاسخ مودم، اجرای فرمان بعدی قفل می‌ماند تا فرمان‌ها با هم تداخل نکنند.
کنترل صف و سهمیه
سیاست ارسال
سقف، فاصله و مدار محافظ را برای هر مسیر سیم‌کارت جدا تنظیم کنید.
انتخاب شبکه با ثبت واقعی و شمارندهٔ اپراتور فرق دارد. نام COPS انتخاب مودم را نشان می‌دهد و ثبت واقعی با CREG/CEREG بررسی می‌شود؛ سهمیه و تاریخچهٔ پیام اپراتور از رابط سیم‌کارت قابل خواندن نیست. شمارنده‌های زیر فقط تلاش‌های ثبت‌شده در همین پنل را جمع می‌زنند و وضعیت نامشخص هم برای جلوگیری از عبور از سقف، شمرده می‌شود.
آمار اپراتورها
جمع تلاش‌ها بر اساس اپراتوری که مودم هنگام شروع ارسال گزارش کرده است.
پایش ارسال پیام
پیام‌های در صف و در حال ارسال
پیام‌های منتظر شروع و پیام‌هایی که اکنون با مودم در حال ارسال‌اند؛ وضعیت هر مورد جداگانه مشخص است.
لغو فقط برای پیام‌های هنوز در صف است. پیام در حال ارسال قابل لغو نیست تا وضعیت مودم نیمه‌کاره نماند. پیام لغوشده در تاریخچه حفظ می‌شود و دوباره ارسال نخواهد شد.
وضعیت لحظه‌ای خروجی
پیام‌های در صف و در حال ارتباط با مودم در این فهرست دیده می‌شوند.
| زمان ثبت | گیرنده | متن پیام | کانال | وضعیت | عملیات |
|---|
فهرست پیام‌های صف هنوز دریافت نشده است.
پیگیری و گزارش‌گیری
پیام‌های ارسال‌شده
تاریخچهٔ پیام‌ها با وضعیت ثبت‌شده از مودم و گزارش تحویل شبکه.
پذیرفته‌شدن توسط مودم به‌معنی تحویل به گوشی نیست.
«وضعیت ارسال» نتیجهٔ ثبت‌شده در مودم را نشان می‌دهد؛ فقط «تحویل تأیید شد» از گزارش دلیوری شبکه می‌آید. اگر اپراتور گزارش ندهد، وضعیت تحویل نامشخص می‌ماند.
کل پیام‌های ثبت‌شده—در کل تاریخچه
در صف انتظار—هنوز شروع نشده
در حال ارسال—در حال ارتباط با مودم
پذیرفته‌شده توسط مودم—رسید دلیوری جداگانه است
تحویل تأییدشده—بر اساس رسید شبکه
ناموفق یا نامشخص—برای بررسی بیشتر
دفتر ثبت پیام‌ها
فهرست وضعیت‌ها از پایگاه دادهٔ پنل دریافت می‌شود.
| شناسه و زمان ثبت | گیرنده | متن پیام | کانال | وضعیت ارسال | وضعیت دلیوری | بخش پذیرفته‌شده | آخرین تغییر | جزئیات |
|---|
دفترچهٔ مشتریان و مخاطبین
مخاطبین و گروه‌ها
فهرست را وارد کنید، گروه بسازید و فقط مخاطبین دارای رضایت را برای ارسال انتخاب کنید.
کنترل رضایت ارسال: اعضای دارای رضایت قابل انتخاب‌اند. مخاطب لغو اشتراک‌کرده در ارسال تکی و انبوه مسدود می‌ماند، حتی اگر بایگانی یا به گروه دیگری منتقل شود.
گروه‌بندی
اعضا را در گروه‌های کاری نگه دارید.
گروه‌ها در حال دریافت هستند.
ثبت مخاطب
شماره پس از نرمال‌سازی یکتا ذخیره می‌شود.
ورود و خروج مخاطبین
CSV UTF-8: phone, firstName, lastName, email, consentStatus, consentSource, groups, notes؛ گروه‌ها با | جدا شوند.
فایلی انتخاب نشده
ورود فایل ابتدا پیش‌نمایش می‌شود؛ رضایت خالی به‌صورت «نامشخص» ثبت خواهد شد.
دفترچهٔ مخاطبین
جست‌وجو، فیلتر، و انتخاب مخاطبین دارای رضایت برای ارسال
۰ مخاطب
| انتخاب | نام | موبایل | گروه‌ها | رضایت ارسال | آخرین تغییر | عملیات |
|---|
اطلاعات مخاطبین فقط روی سرور محلی ذخیره می‌شود.
فهرست سراسری عدم‌ارسال
شماره‌هایی که درخواست لغو داده‌اند؛ همهٔ مسیرها و APIها پیش از صف‌کردن پیام این فهرست را بررسی می‌کنند.
۰ شماره
| شماره | منبع ثبت | کانال | آخرین ثبت |
|---|
برای فعال‌سازی دوباره، مخاطب را باز کنید و پس از دریافت رضایت جدید، منبع آن را ثبت کنید. CSV به‌تنهایی فهرست عدم‌ارسال را پاک نمی‌کند.
پیام‌های ورودی
صندوق دریافتی
پیام‌های SMS ذخیره‌شده روی سیم‌کارت‌ها را به پنل محلی وارد کنید.
پیام‌های واردشده
محتوای صندوق فقط برای مدیر پنل قابل مشاهده است.
۰ پیام
| زمان دریافت | کانال | فرستنده | متن پیام | بخش | وضعیت روی SIM | عملیات |
|---|
صندوق محلی هنوز تازه‌سازی نشده است.
همگام‌سازی صندوق. خواندن فهرست SIM ممکن است پیام‌های تازه را روی سیم‌کارت «خوانده‌شده» کند، اما پیام را از دستگاه پاک نمی‌کند. دکمه‌های حذف این صفحه فقط نسخهٔ محلی پنل را پاک می‌کنند. برای MikroTik، پنل ابتدا متن خام PDU را می‌خواند؛ اگر مودم/RouterOS این مسیر را ندهد، متن فارسیِ تبدیل‌شده به علامت سؤال از روی متن خراب‌شده قابل بازیابی نیست.
ارسال پیام
ارسال پیام
ارسال پیام به یک شماره با پیش‌نمایش تعداد بخش‌ها و انتخاب ایموجی.
پیام جدید
متن فارسی روی مودم AT/PDU با کدگذاری UCS‑2 ارسال می‌شود.
ارسال پیام · فهرست مخاطبان
ارسال انبوه
شماره‌ها را از فایل متنی وارد کنید یا فهرست را جای‌گذاری کنید؛ پیش از ثبت در صف، ردیف‌ها را بررسی کنید.
ارسال انبوه از فایل یا کپی
تا ۵۰۰ پیام در هر نوبت؛ فقط برای مخاطبِ فعال با منبع رضایت ثبت‌شده. ابتدا فهرست را پیش‌نمایش کنید.
قالب هر خط
09121234567با متن مشترک09121234567,متن اختصاصییا با Tab بین شماره و متن
فایل انتخاب نشده
برای ردیف‌های با متن اختصاصی نیز می‌توانید ایموجی را مستقیم جای‌گذاری کنید.
برای ارسال به مخاطبین می‌توانید از
{{firstName}}، {{lastName}} و {{phone}} استفاده کنید.ارسال پیام · اجرای خودکار
زمان‌بندی ارسال
کمپین را برای یک گروه دارای رضایت تنظیم کنید و وضعیت اجرای آن را پیگیری کنید.
ارسال پیام · خدمات و پیگیری
یادآوری نوبت
برای یک گروه پیام یادآوری زمان‌بندی کنید یا برای هر مخاطب نوبت جدا ثبت کنید.
ارسال پیام · تعامل با مخاطب
نظرسنجی
پرسش و گزینه‌ها را بسازید؛ رأی‌ها پس از همگام‌سازی صندوق پیام‌های سیم‌کارت خوانده می‌شوند.
ارسال پیام · مشارکت و وفاداری
قرعه‌کشی
قرعه‌کشی قابل پیگیری میان مخاطبان فعال و دارای رضایت ارسال.
اتصال سامانه‌ها
کلیدهای API
برای هر وب‌سایت یا اپلیکیشن یک کلید جداگانه بسازید.
ساخت کلید جدید
کلید خام فقط یک‌بار نمایش داده می‌شود.
مستندات API · نسخهٔ ۱
اتصال سایت و اپلیکیشن
قرارداد واقعی API، نمونه‌کد، وضعیت‌ها، خطاها و مسیرهای مدیریتی پنل.
نشانی پایهٔ همین پنل
در حال دریافت…احراز هویت برنامه‌هاهدر X-API-Keyکلید فقط روی بک‌اند برنامه نگهداری شود.
پاسخ ثبت پیام202 · ثبت در صفپذیرش توسط مودم رسید تحویل نیست.
ورود سایت‌ها: نام کاربری و رمز عبور فقط برای ورود مدیر به پنل است. برای هر سایت یک کلید API جدا بسازید و آن را فقط در تنظیمات محرمانهٔ بک‌اند همان سایت بگذارید؛ رمز مدیر یا کلید API را در JavaScript مرورگر قرار ندهید. پیش‌فرض هر کلید ۶۰ درخواست در دقیقه و حداکثر ۱۰۰۰ پیام در وضعیت صف/ارسال است؛ تنظیم صف از فایل تنظیمات سرویس قابل تغییر است.
شروع اتصال
برای هر برنامه یک کلید مجزا بسازید و آن را در مخزن اسرار سرور همان برنامه قرار دهید.
کلید بسازید
از «کلیدهای API» کلید اختصاصی بسازید. مقدار کامل فقط یک‌بار نمایش داده می‌شود.
درخواست را از بک‌اند بفرستید
از سرور سایت به نشانی HTTPS دامنهٔ پنل درخواست بزنید؛ برای این ارتباط سروربه‌سرور CORS لازم نیست.
صف و وضعیت را پیگیری کنید
شناسهٔ پیام در پاسخ ثبت می‌شود. همان کلید فقط وضعیت پیام‌های خودش را می‌بیند.
مسیرهای عمومی
این سه مسیر برای اتصال معمول سایت و اپلیکیشن کافی‌اند.
| متد | مسیر | احراز هویت | رفتار |
|---|---|---|---|
| GET | /health | بدون کلید | پاسخ سادهٔ در دسترس بودن سرویس |
| POST | /messages | X-API-Key | اعتبارسنجی و ثبت یک پیام در صف؛ پاسخ 202 |
| GET | /messages/{id} | X-API-Key | وضعیت پیام متعلق به همان کلید |
ثبت پیام
POST · /api/v1/messagesبدنه باید JSON با to و text باشد. شمارهٔ ایران با ۰۹، ۹۸ یا +۹۸ و ارقام فارسی/عربی هم نرمال می‌شود. متن حداکثر ۶۷۰ واحد UTF-16 و حداکثر ۱۰ بخش پیام است.
POST /api/v1/messages
Content-Type: application/json
X-API-Key: itsms_REPLACE_WITH_KEY
Idempotency-Key: order-10452
{
"to": "09121234567",
"text": "سفارش شما ثبت شد"
}HTTP 202 Accepted
Location: /api/v1/messages/9f2…
{
"id": "9f2…",
"status": "queued",
"channel": 2,
"createdAt": "2026-10-23T08:30:00+00:00",
"duplicate": false
}پیگیری پیام
GET · /api/v1/messages/{id}شناسهٔ پاسخ ثبت را با همان کلید برنامه پیگیری کنید. پیام‌های کلید دیگر با پاسخ 404 پنهان می‌مانند.
GET /api/v1/messages/9f2…
X-API-Key: itsms_REPLACE_WITH_KEY{
"id": "9f2…",
"to": "+989121234567",
"status": "accepted",
"channel": 2,
"acceptedParts": 1,
"error": null,
"createdAt": "2026-10-23T08:30:00+00:00",
"updatedAt": "2026-10-23T08:30:04+00:00",
"deliveryReportRequested": false,
"deliveryStatus": "disabled"
}نمونه‌کد برای اتصال از بک‌اند
JavaScript · Node.js
const baseUrl = (process.env.ITFA_SMS_BASE_URL || "https://itfa-sms.ir/api/v1").replace(/\/+$/, "");
const apiKey = process.env.ITFA_SMS_API_KEY;
if (!apiKey) throw new Error("ITFA_SMS_API_KEY is not configured");
const response = await fetch(`${baseUrl}/messages`, {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": apiKey,
"Idempotency-Key": `order-${order.id}`
},
body: JSON.stringify({
to: order.mobile,
text: "سفارش شما ثبت شد"
})
});
if (response.status !== 202) {
throw new Error(`ITFA SMS: ${response.status} ${await response.text()}`);
}
const accepted = await response.json();
console.log(accepted.id, accepted.status);Python · requests
import os
import requests
base = os.environ.get("ITFA_SMS_BASE_URL", "https://itfa-sms.ir/api/v1").rstrip("/")
response = requests.post(
f"{base}/messages",
headers={
"X-API-Key": os.environ["ITFA_SMS_API_KEY"],
"Idempotency-Key": "order-10452",
},
json={"to": "09121234567", "text": "سفارش شما ثبت شد"},
timeout=10,
)
if response.status_code != 202:
raise RuntimeError(f"ITFA SMS: {response.status_code} {response.text}")
message = response.json()
print(message["id"], message["status"])وضعیت‌های پیام
وضعیت پنل بر پایهٔ نتیجهٔ مودم است.
queuedدر صف و منتظر کانالsendingفرمان ارسال روی مودم در حال اجراستacceptedمودم پیام را پذیرفته؛ رسید تحویل اپراتور نیستfailedرد قطعی یا خطا پیش از ارسالuncertainقطع ارتباط پس از شروع؛ برای جلوگیری از تکرار خودکار نمی‌شودcancelledمدیر پیش از ارسال پیام را از صف خارج کرده استدر صورت فعال بودن درخواست رسید، پاسخ وضعیت پیام دو فیلد مستقل دارد: deliveryReportRequested و deliveryStatus. مقادیر دلیوری: pending در انتظار رسید، delivered رسید تأییدشده از شبکه، failed خطای دائمی گزارش‌شده، و requested_untracked وقتی RouterOS شناسهٔ TP-MR نداده و رسید هنوز با پیام یکتا تطبیق نشده است. همگام‌سازی MikroTik حافظه‌های PDU اعلام‌شدهٔ مودم، از جمله حافظهٔ گزارش SR را می‌خواند؛ بدون TP-MR فقط تطبیق یکتای کانال، شماره و زمان پذیرفته می‌شود. OK در لاگ به‌تنهایی تحویل را ثابت نمی‌کند. نتیجهٔ رسیدهای پیدا، تطبیق‌شده و مبهم بعد از «خواندن سیم‌کارت‌ها» نمایش داده می‌شود.
خطاهای HTTP
بدنهٔ خطا معمولاً فیلد فارسی error دارد.
| کد | معنی | اقدام پیشنهادی |
|---|---|---|
400 | شماره، متن یا JSON نامعتبر | ورودی را اصلاح کنید؛ متن ناقص Unicode و بیش از ۱۰ بخش رد می‌شود. |
401 | کلید API نامعتبر یا لغوشده | کلید فعال برنامه را بررسی کنید. |
404 | شناسه وجود ندارد یا متعلق به کلید دیگری است | شناسه و کلید درخواست اولیه را تطبیق دهید. |
409 | کلید تکرار برای محتوای متفاوت یا شمارهٔ لغو اشتراک | برای عملیات تازه Idempotency-Key جدید بسازید؛ لغو اشتراک را نادیده نگیرید. |
429 | سقف درخواست دقیقه‌ای یا پرشدن ظرفیت صف همان کلید | پاسخ خطا را بخوانید؛ برای سقف دقیقه‌ای پس از خالی‌شدن بازه و برای صف پس از پردازش پیام‌ها دوباره تلاش کنید. |
503 | درگاه فعال/قابل صف‌بندی نیست یا ذخیره‌سازی موقتاً در دسترس نیست | سلامت پنل و مسیرهای فعال را بررسی کنید؛ درخواست خودکار تکراری و بدون Idempotency-Key نفرستید. |
امنیت و حریم خصوصی: کلید API را در JavaScript مرورگر، اپ موبایل یا مخزن عمومی نگذارید؛ از بک‌اند به پنل درخواست بزنید. ارتباط HTTP بدون TLS رمزنگاری نمی‌شود؛ در انتشار عمومی، HTTPS را در IIS فعال و پورت داخلی ۵۰۸۰ را فقط برای IIS نگه دارید. اتصال سروربه‌سرور نیازی به CORS ندارد؛ CORS احراز هویت نیست و برای این‌که کلید در مرورگر قرار نگیرد، CORS را برای API پیام روشن نکنید.
فهرست API مدیریتی و مسیرهای داخلی
مسیرهای مدیریتی با نشست ورود پنل و محافظت CSRF کار می‌کنند. توکن فایل سرور فقط برای ساخت اولیهٔ حساب است و پس از آن برای ورود یا API پذیرفته نمی‌شود. برنامه‌های متصل باید از کلید محدود X-API-Key استفاده کنند.
تنظیم لغو اشتراک: GET /api/v1/admin/opt-out-keywords برای خواندن و PUT /api/v1/admin/opt-out-keywords با بدنهٔ {"keywords":["STOP","لغو","انصراف"]} برای ذخیرهٔ عبارت‌ها. پردازش فقط هنگام همگام‌سازی صندوق پیام انجام می‌شود.
درخواست رسید تحویل: GET /api/v1/admin/delivery-reports وضعیت {"enabled":false} را می‌خواند و PUT /api/v1/admin/delivery-reports با {"enabled":true} آن را برای ارسال‌های بعدی فعال می‌کند. وضعیت واقعی با deliveryStatus می‌آید؛ برای MikroTik رسیدهای PDU از حافظه‌های مودم خوانده و با TP-MR یا تطبیق یکتای شماره/زمان وصل می‌شوند. پاسخ همگام‌سازی تعداد رسیدهای خوانده، تطبیق‌خورده و نامنطبق را برمی‌گرداند.
نمونهٔ ثبت کمپین و نظرسنجی
هر کمپین ۱ تا ۵۰۰ گیرندهٔ یکتا دارد. رأی‌ها فقط پس از همگام‌سازی صندوق و دریافت پاسخ عددی از گیرندهٔ دعوت‌شده ثبت می‌شوند.
POST /api/v1/admin/campaigns
Cookie: ITFA.AdminSession=<session-cookie>
X-CSRF-Token: <csrf-token-from-login>
Content-Type: application/json
{"name":"سنجش کیفیت","kind":"poll","scheduledAt":"2030-10-23T10:00:00+03:30","messages":[{"to":"+989121234567","text":"کیفیت خدمات؟ 1) عالی 2) خوب"}],"pollQuestion":"کیفیت خدمات؟","pollOptions":["عالی","خوب"],"closesAt":"2030-10-30T10:00:00+03:30"}پایش و پیکربندی دستگاه
| متد | مسیر | توضیح |
|---|---|---|
| GET | /api/v1/admin/overview | خلاصهٔ صف، کانال‌ها و پیام‌های اخیر |
| GET | /api/v1/admin/channel-status | خواندن وضعیت مودم/سیم‌کارت از کانال‌ها |
| GET | /api/v1/admin/device-statistics | آمار شبکه و TCP سریال‌سرور |
| GET | /api/v1/admin/devices | فهرست دستگاه‌های فعال و بایگانی‌شده |
| POST / PUT / DELETE | /api/v1/admin/devices… | ثبت، ویرایش، فعال/متوقف یا حذف از فهرست دستگاه |
| PUT | /api/v1/admin/devices/{id}/restore | بازیابی با کنترل تداخل مسیر؛ دستگاه متوقف می‌ماند |
| DELETE | /api/v1/admin/devices/{id}/permanent | حذف کامل تنظیمات اتصال دستگاه با تأیید نام؛ سوابق و شمارهٔ کانال حفظ می‌شوند |
| GET / PUT | /api/v1/admin/gateway-control | کنترل کلید Wavecom و نمایش مسیرهای Wavecom، MikroTik و سایر دستگاه‌ها |
| GET / PUT | /api/v1/admin/sending-policy | سهمیه و SMSC هر کانال |
| GET / PUT | /api/v1/admin/delivery-reports | فعال‌سازی درخواست رسید تحویل از اپراتور |
| POST | /api/v1/admin/channel-registration-retry/{port} | تلاش مجدد ثبت شبکه |
| POST | /api/v1/admin/channel-imei/{port} | خواندن IMEI مودم اصلی |
| POST | /api/v1/admin/channel-imei-by-number/{channel} | خواندن IMEI کانال انتخابی |
| POST / DELETE | /api/v1/admin/channels/{channel}/ussd | اجرای کد یا لغو نشست USSD روی کانال انتخاب‌شده |
پیام، صف، مخاطبین و کلیدها
| متد | مسیر | توضیح |
|---|---|---|
| GET / POST | /api/v1/admin/messages | مدیریت پنل با نشست مدیر و CSRF؛ برای سایت‌ها از مسیر عمومی و کلید API استفاده کنید |
| POST | /api/v1/admin/bulk-messages | ثبت گروهی حداکثر ۵۰۰ پیام؛ هر گیرنده باید رضایت فعال داشته باشد |
| GET / DELETE | /api/v1/admin/queue | دیدن صف یا لغو همهٔ پیام‌های هنوز صف‌شده |
| DELETE | /api/v1/admin/queue/{id} | لغو یک پیام هنوز صف‌شده |
| GET / POST | /api/v1/admin/contacts | جست‌وجو و ثبت مخاطب |
| PUT / POST | /api/v1/admin/contacts/{id} | ویرایش رضایت یا بایگانی مخاطب؛ فعال‌سازی نیازمند منبع رضایت |
| GET | /api/v1/admin/contacts/{id}/consent-events | سابقهٔ تغییر رضایت، منبع و زمان |
| GET | /api/v1/admin/suppressions | فهرست سراسری عدم‌ارسال، شامل شماره‌های خارج از دفترچه |
| POST | /api/v1/admin/contacts/import | ورود دسته‌ای مخاطبین؛ ردیف‌های دارای رضایت به ستون consentSource نیاز دارند |
| GET / POST | /api/v1/admin/contact-groups | فهرست و ایجاد گروه |
| PUT | /api/v1/admin/contact-groups/{id} | ویرایش گروه |
| GET | /api/v1/admin/contact-groups/{id}/sendable | اعضای مجاز به ارسال با رضایت ثبت‌شده |
| GET / POST / DELETE | /api/v1/admin/keys… | فهرست، ساخت و لغو کلیدهای API |
| GET / POST | /api/v1/admin/inbox… | خواندن صندوق محلی و همگام‌سازی دستی از سیم‌کارت |
| GET / PUT | GET /api/v1/admin/inbox-forwarding · PUT /api/v1/admin/inbox-forwarding/{channel} | خواندن تنظیم‌ها و ذخیرهٔ مقصد ارسال نسخه برای هر کانال |
| GET / POST | /api/v1/admin/campaigns | فهرست و زمان‌بندی کمپین پیام |
| DELETE | /api/v1/admin/campaigns/{id} | لغو کمپین یا پیام‌های صف‌شدهٔ همان کمپین |
| GET | /api/v1/admin/campaigns/{id}/poll-results | نتیجهٔ گزینه‌ای نظرسنجی |
| GET / POST | /api/v1/admin/appointments | فهرست یا ثبت یادآوری نوبت فردی |
| PUT / DELETE | /api/v1/admin/appointments/{id} | ویرایش نوبت زمان‌بندی‌شده یا لغو یادآوری |
| GET | /api/v1/admin/lotteries | تاریخچه و برندگان قرعه‌کشی |
| POST | /api/v1/admin/lotteries/draw | قرعه‌کشی امن میان مخاطبین فعال دارای رضایت |
شخصی‌سازی محیط کار
تنظیمات پنل
ظاهر و چیدمان داشبورد را تنظیم کنید و کلیدواژه‌های لغو اشتراک را مدیریت کنید.
ظاهر و چیدمان در همین مرورگر؛ کلیدواژه‌های لغو روی سرور ذخیره می‌شوند.
حساب مدیر و امنیت ورود
ورود پنل با نام کاربری و رمز؛ کلیدهای API برنامه‌ها جداگانه مدیریت می‌شوند.
حساب فعالدر حال دریافت…
نشست مرورگر · ۱۲ ساعتپس از تغییر رمز، نشست‌های دیگر بسته می‌شوند و این مرورگر دوباره وارد پنل می‌ماند. نشست ورود ۱۲ ساعت اعتبار دارد. فایل حساب در پوشهٔ دادهٔ محافظت‌شدهٔ سرور قرار می‌گیرد. برای ورود از بیرون شبکه، HTTPS دامنه باید فعال باشد.
به‌روزرسانی پنل
بستهٔ امضاشده را بارگذاری، بررسی و در زمان مناسب نصب کنید.
نسخهٔ نصب‌شدهدر حال دریافت…
نسخهٔ آمادهٔ نصب—
وضعیت به‌روزرسانی از سرویس دریافت می‌شود.
فقط بسته‌ای نصب می‌شود که امضای سازنده و هش تمام فایل‌هایش درست باشد. تنظیمات سرور و پایگاه پیام جدا می‌مانند. هنگام نصب، گرفتن پیام جدید از صف مکث می‌کند و پیام‌های در حال ارسال تمام می‌شوند؛ سرویس یک‌بار راه‌اندازی مجدد می‌شود. اگر بررسی سلامت محلی ناموفق شود، نسخهٔ قبلی خودکار برمی‌گردد و نشست ورود باید دوباره ساخته شود.
راهنمای ساخت فایل به‌روزرسانی
پس از انتشار نسخهٔ جدید، پوشهٔ خروجی Windows را با ابزار امضای همین پروژه بسته‌بندی کنید. کلید خصوصی فقط روی رایانهٔ سازنده و با حفاظت حساب همان کاربر می‌ماند؛ آن را روی سرور بارگذاری نکنید. فایل ZIP خروجی را در همین قسمت انتخاب کنید.
آپلود فایل نصب‌کنندهٔ ناشناس یا ZIP دست‌کاری‌شده پذیرفته نمی‌شود.ظاهر و خوانایی
تنظیمات دیداری برای همین مرورگر
چیدمان نمای کلی
بخش‌هایی را که هر روز لازم دارید نگه دارید.
تازه‌سازی خودکار
فاصلهٔ خواندن وضعیت پنل از دستگاه
تازه‌سازی خودکار فقط اطلاعات را می‌خواند. تلاش ثبت شبکه، ارسال پیام و راه‌اندازی مجدد دستگاه فقط با اقدام جداگانهٔ شما انجام می‌شود.
گزارش تحویل پیام
درخواست رسید واقعی از اپراتور برای پیام‌های بعدی
در حال دریافت وضعیت…
«OK» در لاگ RouterOS یعنی فرمان اجرا/پذیرفته شده؛ رسید تحویل از اپراتور نیست. رسید فقط در صورت پشتیبانی مودم و اپراتور می‌رسد. نسخهٔ جاری پنل پاسخ /tool/sms/send را برای استخراج شناسهٔ TP-MR نمی‌خواند؛ اصلاح آماده‌شده شناسهٔ صریح را می‌خواند، اما اگر RouterOS آن را برنگرداند تحویل قابل تطبیق نیست. پنل وضعیت را حدس نمی‌زند. برای رسیدهای دارای شناسه، صندوق SIM را همگام‌سازی کنید.
ارسال نسخهٔ پیام دریافتی
برای هر کانال، مقصد و ارسال خودکار را تنظیم کنید.
فقط پیام‌های تازه پس از دریافت و همگام‌سازی منتقل می‌شوند؛ پیام‌های قبلی دوباره ارسال نمی‌شوند. نسخه از صف عادی کانال می‌گذرد و محدودیت‌های همان کانال را رعایت می‌کند.
در حال دریافت تنظیم کانال‌ها…
تشخیص لغو اشتراک
کلیدواژه‌های پیام ورودی را تنظیم کنید تا شمارهٔ درخواست‌کننده در فهرست عدم‌ارسال ثبت شود.
تنظیمات روی سرور ذخیره می‌شود.
لغوها پس از همگام‌سازی صندوق سیم‌کارت پردازش می‌شوند. شمارهٔ ثبت‌شده از ارسال دستی، گروهی، کمپین و API مسدود می‌شود؛ پیام‌های قبلی صندوق دوباره پردازش نمی‌شوند.
آخرین شماره‌های لغو اشتراکدر حال دریافت…
در حال دریافت فهرست…
قابلیت‌های قابل کنترل
مسیر دسترسی به تنظیمات عملیاتی پنل