ارسال
ثبت پیام و مدیریت صف
ارسال تکی یا گروهی، مشاهدهٔ پیام‌های در صف، در حال ارسال و سوابق؛ پیام نامشخص پس از قطع سرویس خودکار دوباره فرستاده نمی‌شود.
جزئیات در پنل
زیرساخت پیام‌رسانی در اختیار سازمان شما
ارتباطات پیامکی،
ارتباطات پیامکی،
منظم و قابل پیگیری
ITFA SMS برای مدیریت پیام‌های خروجی و ورودی، مخاطبان، مسیرهای سخت‌افزاری و اتصال نرم‌افزارها ساخته شده است. عملیات روزمره را از یک پنل انجام دهید و درخواست‌های سامانه‌های دیگر را از راه API به صف بسپارید.
صف پایدار و پیگیری وضعیت API با کلید جداگانه برای هر برنامه کنترل مخاطب و عدم‌ارسال
نمای مفهومیمسیر یک درخواست پیام
بدون دادهٔ زنده۰۱
وب‌سایت یا اپلیکیشندرخواست از بک‌اند برنامه
درخواستHTTPS · API Key
۰۲
رابط APIاعتبارسنجی و ثبت پیام
امنشناسهٔ پیگیری
۰۳
صف و انتخاب مسیررعایت محدودیت مسیرهای فعال
صف پایدارمودم یا درگاه سازگار
۰۴
شبکهٔ اپراتورنتیجه وابسته به درگاه و شبکه
گزارشپذیرپاسخ «پذیرفته شد» یعنی درخواست در پنل ثبت شده؛ تحویل نهایی فقط با رسید معتبر شبکه قابل تأیید است.
ارسال و صفدفتر مخاطبانصندوق دریافتیدرگاه‌های سازگارAPI سرور به سرور
یک گردش کار، چند ابزار کاربردی
از مدیریت مخاطب تا گزارش پیام
بخش‌های اصلی پیام‌رسانی را کنار هم مدیریت کنید؛ هر قابلیت در چارچوب اتصال و پشتیبانی واقعی دستگاه شما کار می‌کند.
مخاطبان
مخاطب‌ها و گروه‌های کاری
اطلاعات مخاطبان را مدیریت کنید، گروه بسازید و درخواست لغو یا عدم‌ارسال را در روند پیام‌رسانی رعایت کنید.
مدیریت مخاطبانپاسخگویی
صندوق پیام‌های دریافتی
پیام‌های دریافت‌شده را بخوانید و برای پاسخ‌گویی از مسیرهایی استفاده کنید که قابلیت دریافت و ارسال را پشتیبانی می‌کنند.
مشاهدهٔ صندوقبرنامهریزی
یادآوری و نظرسنجی
برای فرایندهای مجاز، پیام زمان‌بندی‌شده، یادآوری نوبت و نظرسنجی را مدیریت کنید. زمان‌بندی ظرفیت کاری بیرونی را کنترل نمی‌کند.
امکانات برنامهریزیزیرساخت
وضعیت دستگاه و کانال
اتصال شبکه، پاسخ مودم و وضعیت هر مسیر را جداگانه ببینید تا خطای ارتباط با خطای سیم‌کارت یا شبکه اشتباه نشود.
بررسی دستگاههاگزارش
پیگیری وضعیت و رسید تحویل
ثبت در پنل، پذیرش مودم و رسید تحویل را از هم تفکیک کنید. رسید تنها وقتی نمایش داده می‌شود که مسیر و شبکه آن را پشتیبانی و برگردانند.
مشاهدهٔ گزارشهااتصال با توجه به تجهیزات موجود
درگاه را با مسیر واقعی دستگاه هماهنگ کنید
پنل از چند روش اتصال پشتیبانی می‌کند؛ نوع دستگاه به‌تنهایی برای سازگاری کافی نیست. مدل، میان‌افزار، پروتکل قابل دسترس و تنظیمات شبکه باید بررسی شوند.
راهنمای دستگاه‌ها در پنلسریالسرور
Wavecom و مسیرهای RS-232
اتصال فعلی Wavecom از سریال‌سرور و حداکثر ۸ کانال پشتیبانی می‌کند. دسترسی TCP از خود سرور پنل باید برقرار باشد.
مودم متصل به سرور
USB / COM و مودم‌های AT
مودم باید پورت COM استاندارد بسازد و فرمان‌های لازم AT و PDU را پشتیبانی کند. دستگاه‌های دارای پروتکل اختصاصی به درایور جدا نیاز دارند.
روتر و LTE
MikroTik با RouterOS REST
اتصال از HTTPS به REST روتر انجام می‌شود و به رابط LTE، ابزار SMS سازگار و مجوز محدودشده نیاز دارد. قابلیت‌ها با مدل و نسخهٔ RouterOS فرق می‌کنند.
هیچ ادعایی دربارهٔ سازگاری خودکار با همهٔ مودم‌ها وجود ندارد. پیش از استفادهٔ عملی، دستگاه را در پنل اضافه کنید و اتصال، کانال و یک پیام آزمایشی مجاز را جداگانه ارزیابی کنید.
راه‌اندازی مرحله‌به‌مرحله
از پیکربندی تا پیگیری
اتصال درست از خود سرور پنل شروع می‌شود. پس از آماده‌شدن مسیر، مخاطب و پیام را با توجه به سیاست‌های سازمانی مدیریت کنید.
ورود به پنل- ۰۱
دستگاه و دسترسی شبکه را بررسی کنید
روش اتصال را انتخاب کنید و مطمئن شوید خود سرور پنل به پورت یا رابط مدیریتی دستگاه دسترسی دارد. پنل و دستگاه را بی‌دلیل در معرض اینترنت قرار ندهید.
- ۰۲
مسیر، سیم‌کارت و قابلیت‌های آن را تأیید کنید
وضعیت AT، ثبت شبکه، قابلیت ارسال متن فارسی و پشتیبانی گزارش تحویل ممکن است در هر کانال متفاوت باشد.
- ۰۳
مخاطب مجاز و فرایند ارسال را بسازید
مخاطب را با مبنای مجاز ثبت کنید، گروه‌ها و محدودیت‌ها را تنظیم کنید و درخواست لغو را در فهرست عدم‌ارسال نگه دارید.
- ۰۴
API را از بک‌اند متصل و وضعیت را پیگیری کنید
کلید مستقل بسازید، درخواست را از سرور برنامه بفرستید و با شناسهٔ پاسخ وضعیت را دنبال کنید؛ رمز مدیر را به برنامه ندهید.
اتصال وب‌سایت و نرم‌افزار
API ساده برای ثبت و پیگیری پیام
API عمومی برای ارتباط بک‌اند‌به‌بک‌اند طراحی شده است. برای هر برنامه کلید جدا بسازید و آن را فقط در مخزن امن سمت سرور نگه دارید؛ کلید را در JavaScript، اپلیکیشن عمومی یا کد سمت کاربر قرار ندهید.
۱
ثبت درخواستPOST /api/v1/messages پیام را اعتبارسنجی و در صف ثبت می‌کند.
۲
دریافت شناسهپاسخ 202 Accepted شناسهٔ پیام و وضعیت فعلی را می‌دهد.
۳
پیگیری مالکانهGET /api/v1/messages/{id} فقط پیام‌های همان کلید را نمایش می‌دهد.
محدودیت پیش‌فرض۶۰ درخواست در دقیقه برای هر کلیدحداکثر ۱۰۰۰ پیام در صف هر کلیدسقف صف قابل تنظیم است؛ عبور از محدودیت با پاسخ 429 اعلام می‌شود.
راهنمای کامل API در پنل
درخواست سمت سرور
POST /api/v1/messages
Host: itfa-sms.ir
X-API-Key: itsms_<secret>
Idempotency-Key: order-10452
Content-Type: application/json
{
"to": "09121234567",
"text": "سفارش شما ثبت شد"
}
HTTP/1.1 202 Accepted
{
"id": "…",
"status": "queued"
} کلید را محرمانه نگه دارید · از HTTPS استفاده کنید · برای درخواست تکراری شناسهٔ ثابت بفرستید
نکتهٔ وضعیت: queued یعنی در صف ثبت شده و accepted یعنی درگاه فرمان ارسال را پذیرفته است. هیچ‌کدام به‌تنهایی تحویل به تلفن را ثابت نمی‌کنند؛ رسید تحویل وابسته به مودم، اپراتور و امکان تطبیق رسید است.
مدیریت مسئولانه
کنترل و شفافیت در هر مرحله
ارسال پیام باید بر پایهٔ ارتباط مجاز با مخاطب باشد. محدودیت فنی یا گزارش وضعیت، جایگزین رضایت مخاطب و قواعد اپراتور نیست.
فهرست عدم‌ارسالشمارهٔ لغوشده نباید دوباره وارد کمپین شود.
تفکیک کلیدهای APIبرای هر برنامه کلید بسازید و دسترسی را در صورت نیاز لغو کنید.
گزارش واقع‌بینانهثبت، پذیرش درگاه و رسید تحویل، وضعیت‌های جداگانه‌اند.
دربارهٔ سامانه
ITFA SMS؛ مرکز پیام سازمانی
ITFA SMS برای یکپارچه‌کردن مدیریت پیام، مسیرهای سخت‌افزاری و اتصال برنامه‌ها طراحی شده است. وضعیت سرویس به دسترسی سرور، پیکربندی دستگاه و پشتیبانی شبکه وابسته است؛ این صفحه وضعیت زندهٔ دستگاه‌ها را نمایش نمی‌دهد.
سازندهٔ سامانهعرفان ذوالفقاریErfan Zolfaghari
تماس با ما
برای راهنمایی و پیگیری
برای ارتباط تلفنی با ITFA SMS تماس بگیرید.
031 9109 2024 شمارهٔ تماس اعلام‌شده برای ITFA SMSپاسخ روشن به پرسش‌های مهم
پیش از راه‌اندازی بدانید
پاسخ‌ها بر اساس قابلیت و محدودیت فعلی سامانه نوشته شده‌اند.
آیا پنل با هر مودم یا روتر کار می‌کند؟
خیر، سازگاری خودکار با همهٔ مدل‌ها تضمین نمی‌شود. مودم USB باید COM استاندارد و AT/PDU سازگار داشته باشد؛ اتصال TCP باید جریان AT را شفاف عبور دهد؛ MikroTik باید رابط LTE و ابزار SMS قابل پشتیبانی داشته باشد. مدل و میان‌افزار را پیش از استقرار بررسی کنید.
آیا پاسخ 202 یعنی پیام به مقصد رسیده است؟
خیر. پاسخ 202 یعنی درخواست معتبر در سامانه پذیرفته شده و شناسهٔ پیگیری دارد. پذیرش فرمان از سوی مودم نیز با تحویل به گوشی فرق می‌کند. نتیجهٔ تحویل فقط با رسید معتبر و قابل تطبیق ثبت می‌شود.
چطور API را به سایتم وصل کنم؟
در پنل برای سایت یک کلید مستقل بسازید و از بک‌اند سایت درخواست HTTPS به POST /api/v1/messages بفرستید. سپس با همان کلید و شناسهٔ پیام، وضعیت را از GET /api/v1/messages/{id} بخوانید. رمز مدیر برای این کار نیست.
کلید API را کجا نگه دارم؟
فقط در تنظیمات امن بک‌اند یا متغیرهای محرمانهٔ سرور. کلید را در کد JavaScript، اپلیکیشن قابل دانلود، مخزن عمومی یا گزارش خطا قرار ندهید. برای هر برنامه یک کلید جدا بسازید تا بتوانید مستقل آن را لغو کنید.
چرا پیام فارسی یا ایموجی ممکن است محدودیت بیشتری داشته باشد؟
متن فارسی و بسیاری از ایموجی‌ها با Unicode/UCS2 منتقل می‌شوند؛ ظرفیت هر بخش پیام کمتر از متن GSM-7 است و چندبخشی‌شدن، تعداد پیامک‌های مصرفی را تغییر می‌دهد. نتیجه به مودم و اپراتور هم بستگی دارد.
آیا از بیرون اینترنت باید مستقیماً به مودم وصل شوم؟
معمولاً کافی است سرور پنل به دستگاه دسترسی امن داشته باشد و برنامهٔ شما با HTTPS به API پنل وصل شود. پورت مدیریتی مودم یا MikroTik را عمومی نکنید؛ برای دستگاه دوردست از VPN یا محدودسازی شبکه استفاده کنید.
آیا رسید تحویل برای همهٔ اپراتورها و دستگاه‌ها موجود است؟
نه. قابلیت گزارش تحویل باید در مسیر مودم، شبکه و تنظیمات اپراتور پشتیبانی شود. نبود رسید به معنی شکست قطعی نیست و رسیدی که قابل تطبیق نباشد نباید به‌عنوان تحویل قطعی گزارش شود.
پنل با داده‌های مخاطبان چه می‌کند؟
شماره‌ها و متن پیام برای صف و سوابق روی پایگاه دادهٔ سرور پنل نگهداری می‌شوند. دسترسی سرور، پشتیبان‌گیری، نگهداری سوابق و دسترسی مدیران را متناسب با سیاست محرمانگی سازمان خود تنظیم کنید.
ITFA SMS
ورود به پنل مدیریت پیام‌ها را از یک پنل شروع کنید
وضعیت دستگاه، مخاطبان، صف و اتصال API را در پنل بررسی کنید.