6 دقیقه مطالعه

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

ثبت‌نام، دریافت API Key، تنظیم قالب OTP، و تست ارسال از پنل پرونوبت.

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

پیش‌نیازها

آدرس app.kavenegar.com را باز کنید و روی ثبت‌نام کلیک کنید.

نام، ایمیل، و شماره موبایل را وارد کنید. کد تأیید SMS را دریافت و وارد کنید.

پس از ورود، از منوی تنظیمات ← API Key بخش «API Access Token» را باز کنید. API Key را کپی کنید.

API Key کاوه‌نگار یک رشته طولانی است مثل 3D4C6B7E9F.... آن را در جای امنی نگه دارید.

اگر خط اختصاصی دارید، شماره آن را یادداشت کنید. اگر ندارید، از خط اشتراکی استفاده می‌کنید (برای شروع کافی است).

در پنل وردپرس، به پرونوبت ← تنظیمات ← پیامک بروید.

از dropdown «ارائه‌دهنده پیامک» مقدار Kavenegar را انتخاب کنید.

API Key کپی‌شده را در فیلد API Key وارد کنید.

شماره خط را در فیلد خط ارسال وارد کنید. اگر خط اشتراکی دارید، این فیلد را خالی بگذارید.

ذخیره را بزنید.

در همان صفحه تنظیمات پیامک، بخش ارسال پیامک آزمایشی را پیدا کنید.

شماره موبایل خودتان را وارد کنید (فرمت 09XXXXXXXXX).

دکمه ارسال را بزنید. در عرض چند ثانیه باید پیامک «نوبت - پیام آزمایشی» دریافت کنید.

در بخش رویدادهای پیامک، می‌توانید هر رویداد را جداگانه فعال یا غیرفعال کنید:

مشکل	راه‌حل
«API Key نامعتبر»	کپی‌پیست کنید، فاصله اضافی نداشته باشد
«اعتبار ناکافی»	از پنل کاوه‌نگار حساب را شارژ کنید
پیامک دریافت نمی‌شود	فیلتر opt-out مشتری را بررسی کنید
پیامک ارسال می‌شود ولی لاگ خطا دارد	سقف روزانه (`sms.daily_cap`) را در تب پیامک بالاتر ببرید

یک نمونه کامل و زنده از افزونه با داده‌های واقعی — بدون نیاز به نصب.