پیامک SMS.ir با هوش مصنوعی: گزارش تحویل، کد تأیید و مانده

با سرور MCP اس‌ام‌اس دات آی‌آر، دستیار هوش مصنوعی شما به حساب SMS.ir وصل می‌شود. می‌توانید از آن بپرسید مانده اعتبارتان چقدر است، پیامک‌های امروز تحویل شده‌اند یا نه، و آخرین کد تأیید روی خط شما چیست.

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

این ابزار برای چه کسانی است؟

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

چه کارهایی می‌تواند انجام دهد؟

سرور حدود ۱۴ قابلیت دارد. مهم‌ترین‌ها این‌ها هستند:

• خواندن مانده و خط‌ها: get_balance مانده اعتبار را نشان می‌دهد و list_lines خط‌های ارسال حساب را فهرست می‌کند.
• پیگیری تحویل: get_message_report وضعیت تحویل یک پیامک را می‌گوید و get_pack_report نتیجهٔ هر گیرنده را در یک ارسال گروهی نشان می‌دهد.
• فهرست پیامک‌ها: list_sent_messages و list_sent_packs پیامک‌ها و ارسال‌های گروهی امروز یا بایگانی را می‌آورند.
• پیامک‌های دریافتی و کد تأیید: list_inbound_messages پیامک‌های دریافتی را می‌خواند و extract_latest_otp آخرین کد یک‌بارمصرف را پیدا می‌کند.
• بررسی اتصال: health_check بدون هزینه، درستی اتصال و کلید را بررسی می‌کند.
• تنظیمات و لغو: reload_config تنظیمات را بدون راه‌اندازی دوباره می‌خواند و cancel_scheduled_send یک ارسال زمان‌بندی‌شده را لغو می‌کند، به شرطی که هنوز انجام نشده باشد.
• ارسال (با تأیید): send_sms، send_verification_code و send_personalized_sms پیامک می‌فرستند. هر کدام هزینه دارد.

نمونه سؤال از دستیار

این سؤال‌ها را می‌توانید همان‌طور که هست بپرسید:

• مانده اعتبار پیامک حسابم در SMS.ir چقدر است؟
• پیامک‌هایی که امروز فرستادم تحویل شده‌اند؟
• آخرین کد تأییدی که روی خط من آمده چیست؟

چطور وصل شوم؟

این سرور بستهٔ آماده ندارد و روی کامپیوتر شما اجرا می‌شود. راه‌اندازی به این شکل است:

1. مخزن سرور را با git clone دریافت کنید.
2. داخل پوشه‌اش یک محیط مجازی پایتون با python -m venv .venv بسازید.
3. دستور pip install -e . را اجرا کنید.
4. در تنظیمات برنامهٔ هوش مصنوعی، به‌جای python مسیر کامل پایتونِ داخل .venv را بگذارید.

متغیرهای لازم را هم در تنظیمات وارد کنید. SMSIR_API_KEY کلید API شماست؛ این مقدار را در پنل SMS.ir پیدا می‌کنید. SMSIR_DEFAULT_LINE_NUMBER خط پیش‌فرض ارسال است و اختیاری است.

SMSIR_ALLOW_SEND را هم تنظیم کنید. مقدار نمونه در راهنما false است و تا وقتی true نشود، هیچ پیامکی فرستاده نمی‌شود. اگر تنظیمات را تغییر دادید، می‌توانید از دستیار بخواهید ابزار reload_config را اجرا کند تا بدون راه‌اندازی دوباره اعمال شود.

محدودیت‌ها و هشدارها

• ارسال پیامک هزینه دارد و برگشت‌پذیر نیست. به همین دلیل سرور دو قفل دارد: تا SMSIR_ALLOW_SEND را true نکنید، هیچ پیامکی فرستاده نمی‌شود. هر ارسال هم باید جداگانه تأیید شود. برای این کار از برنامه‌ای استفاده کنید که پیش از اجرای هر قابلیت از شما تأیید می‌گیرد.
• لغو ارسال زمان‌بندی‌شده هم تأیید می‌خواهد. cancel_scheduled_send فقط برای ارسالی است که هنوز انجام نشده است.
• کلید API لازم است. بدون آن سرور به حساب شما وصل نمی‌شود.
• سازندهٔ سرور مستقل است. این سرور از API رسمی SMS.ir استفاده می‌کند، اما توسعه‌دهندهٔ آن شرکت SMS.ir نیست.
• محدودیت نرخ درخواست. سرور در دقیقه حداکثر ۶۰ درخواست می‌فرستد. برای ارسال‌های پرتعداد، SMSIR_RATE_LIMIT_PER_MINUTE را بالاتر ببرید.
• حریم خصوصی در گزارش‌ها. شماره‌ها، متن پیامک‌ها، کلید و کدهای تأیید در گزارش‌های سرور پوشانده می‌شوند.

جمع‌بندی

اگر می‌خواهید دستیار هوش مصنوعی فقط وضعیت پیامک‌ها و کدهای تأیید را برایتان بخواند، این سرور کافی است. برای ارسال، اول مطمئن شوید SMSIR_ALLOW_SEND را عمداً روشن کرده‌اید. جزئیات قابلیت‌ها و دستور راه‌اندازی را در صفحهٔ ابزار اس‌ام‌اس دات آی‌آر ببینید. برای آشنایی با مفهوم سرور MCP هم راهنمای MCP را بخوانید.