درگاه پیامک: کاوه‌نگار یا SMS.ir

بالای کارت «درگاه پیامک» سه دکمه است: «خاموش»، «کاوه‌نگار» و «SMS.ir». زیر دکمه‌ها نوشته می‌شود کلید را از کجای پنل همان سرویس بردارید. هر سرویس‌دهنده کلید، خط و قالب خودش را جدا نگه می‌دارد؛ اگر از یکی به دیگری بروید و برگردید، تنظیمات قبلی سر جایش است. فقط سرویس‌دهندهٔ انتخاب‌شده پیامک می‌فرستد.

کاوه‌نگار

• ▸«کلید API کاوه‌نگار» (الزامی) — از «پنل کاوه‌نگار ← تنظیمات ← API Key» (panel.kavenegar.com).
• ▸«شمارهٔ فرستنده (اختیاری)» — خالی بماند، پیامک از خط پیش‌فرض حساب کاوه‌نگار می‌رود. فقط رقم پذیرفته می‌شود.
• ▸در «🔐 کد تایید (OTP)»: «نام قالب Verify Lookup» — نام قالبی که در پنل کاوه‌نگار ساخته و تأیید شده است (مثلاً baranza-otp).

SMS.ir

• ▸«کلید API SMS.ir» (الزامی) — از «پنل SMS.ir ← برنامه‌نویسان ← لیست کلیدهای API» (app.sms.ir).
• ▸«شمارهٔ خط ارسال (الزامی)» — خط حساب SMS.ir شما، فقط رقم (مثلاً 30007732000000). بدون آن «ذخیره» پیام «شمارهٔ خط ارسال SMS.ir را وارد کنید» می‌دهد.
• ▸در «🔐 کد تایید (OTP)»: «شناسهٔ قالب (ارسال سریع)» — شناسهٔ عددی قالبی که در پنل SMS.ir در «ارسال سریع» ساخته‌اید؛ و «نام پارامتر کد در قالب» — نام متغیری که کد جایش می‌نشیند. خالی بماند CODE به کار می‌رود؛ در متن قالب آن را مثلاً #CODE# بنویسید.

کد تایید (OTP)

بخش جمع‌شدهٔ «🔐 کد تایید (OTP)» برای هر دو سرویس «طول کد» (۴، ۵، ۶ یا ۸ رقمی؛ پیش‌فرض ۶) و «اعتبار کد» (۱، ۲، ۳، ۵ یا ۱۰ دقیقه؛ پیش‌فرض ۵) را هم دارد. با قالب کد تایید، کدها از خط خدماتی و سریع ارسال می‌شوند و در قطعی خطوط تبلیغاتی هم می‌رسند. اگر قالب خالی بماند، کد با یک پیامک ساده («کد تایید شما: …») از خط ارسال می‌رود.

ذخیره، کلید پنهان و اعتبار حساب

• ▸دکمهٔ «ذخیره» تنظیمات را ثبت می‌کند. اگر سرویس‌دهنده انتخاب شده و کلید خالی باشد، پیام «کلید API را وارد کنید» می‌آید. با «خاموش» و «ذخیره» پیام «پیامک خاموش شد» دیده می‌شود.
• ▸کلید پس از ذخیره کامل نمایش داده نمی‌شود: کادر فقط «••••» و ۴ رقم آخر را نشان می‌دهد و زیرش «کلید ذخیره شده است — برای تغییر، کلید جدید را جایگزین کنید.» نوشته می‌شود. اگر به کادر دست نزنید، همان کلید قبلی می‌ماند. در پیام‌های خطا هم کلید با **** پوشانده می‌شود.
• ▸نشان بالای کارت: «خاموش» (سرویس‌دهنده‌ای انتخاب نشده)، «کلید وارد نشده»، «💰 …» (اعتبار حساب) یا «اعتبار نامشخص» (کلید هست ولی اعتبار خوانده نشد؛ علت با ⚠️ قرمز زیر کارت می‌آید).
• ▸کاوه‌نگار اعتبار را به ریال می‌دهد و کنار عدد «ریال» نوشته می‌شود؛ SMS.ir فقط عدد اعتبار را برمی‌گرداند و واحدی کنارش نمی‌آید. همین عدد در کاشی «پیامک» نمای کلی تنظیمات هم دیده می‌شود.
• ▸تا سرویس‌دهنده و کلید ذخیره نشود، کنار نام بخش «پیامک» در منوی تنظیمات نشان «خاموش» می‌آید و مورد «اتصال درگاه پیامک» در چک‌لیست راه‌اندازی کامل نمی‌شود.

ارسال آزمایشی

1. ۱وقتی سرویس‌دهنده انتخاب و کلید وارد شده باشد، بخش «🧪 ارسال آزمایشی» زیر کارت دیده می‌شود.
2. ۲شمارهٔ موبایل خودتان را بنویسید؛ باید با ۰۹ شروع شود و ۱۱ رقم باشد (وگرنه «شماره موبایل باید با ۰۹ شروع و ۱۱ رقم باشد»).
3. ۳«تست پیامک» یک پیامک ساده با متن «پیام آزمایشی بارانزا ✅» می‌فرستد و «پیامک آزمایشی ارسال شد» می‌آید.
4. ۴«تست کد تایید» کد ۱۲۳۴۵ را فقط از راه قالب کد تایید می‌فرستد و به پیامک ساده برنمی‌گردد، تا اگر قالب تأیید نشده یا شناسه‌اش اشتباه است، خطای واقعی سرویس‌دهنده را ببینید. موفق باشد «کد تایید آزمایشی ارسال شد» می‌آید.
5. ۵هر دو دکمه پیش از ارسال تنظیمات روی صفحه را ذخیره می‌کنند و پس از ارسال، اعتبار حساب دوباره خوانده می‌شود.

چه پیامک‌هایی از این درگاه می‌روند

• ▸کد تایید شمارهٔ مشتری در باشگاه — کد تایید بدون پیامک.
• ▸کد تأیید «اعتبار سازمانی» در صفحهٔ پرداخت. این کد فقط پیامک می‌شود؛ بدون درگاه پیامک برای سازمانی که تأیید پیامکی خواسته کدی ارسال نمی‌شود («پیامک تنظیم نشده است؛ کد تأیید ارسال نمی‌شود») — استفاده از اعتبار سازمانی.
• ▸کمپین‌ها، کمپین‌های خودکار و زمان‌بندی‌شده — کمپین‌های پیامکی.
• ▸پیامک تکی و گروهی به مشتری — پیامک تکی و گروهی.
• ▸«پیام خوش‌آمد» و «پیام ثبت سفارش» — تنظیمات سیستم.

اگر پیامک نرسید

• ▸خطاهای کاوه‌نگار به فارسی نمایش داده می‌شوند؛ رایج‌ترین‌ها: «کلید API کاوه‌نگار نامعتبر است»، «اعتبار حساب کاوه‌نگار کافی نیست — حساب را شارژ کنید»، «شمارهٔ فرستنده (خط) نامعتبر است یا به حساب شما تعلق ندارد»، «قالب کد تایید در کاوه‌نگار پیدا نشد یا هنوز تأیید نشده است» و «آی‌پی این دستگاه در پنل کاوه‌نگار مجاز نشده است».
• ▸SMS.ir علت خطا را خودش به فارسی می‌دهد و همان نمایش داده می‌شود؛ کلید اشتباه «کلید API SMS.ir نامعتبر است» می‌دهد.
• ▸قطع اینترنت: «اتصال به کاوه‌نگار برقرار نشد — اینترنت را بررسی کنید» (برای SMS.ir هم همین پیام با نام SMS.ir).
• ▸وقتی درگاه «خاموش» است، هر ارسال خطای «درگاه پیامک تنظیم نشده است — در «تنظیمات ← پیامک» کاوه‌نگار یا SMS.ir را انتخاب و کلید API خود را وارد کنید» می‌گیرد و کمپین اصلاً شروع نمی‌شود — کمپین‌های پیامکی.