پیامک
تنظیمات پیامک
مسیر: پرونوبت ← تنظیمات ← پیامک
ارائهدهنده پیامک
یکی از چهار ارائهدهنده را انتخاب کنید:
| ارائهدهنده | احراز هویت |
|---|---|
| کاوهنگار | API Key + خط ارسال |
| ملیپیامک | نامکاربری / رمز عبور + خط ارسال |
| SMS.ir | کلید وبسرویس + شماره خط |
| فراز اساماس | Access Key + خط ارسال |
سقف روزانه ارسال
- پیشفرض: ۵۰۰ پیامک در روز (کلید
sms.daily_cap) - این محدودیت از ارسال ناخواسته و هزینه اضافی جلوگیری میکند.
- شمارنده در نیمهشب (به وقت ایران) ریست میشود.
رویدادهای پیامک
| رویداد | پیشفرض |
|---|---|
| نوبت تأییدشده | ✓ فعال |
| نوبت لغوشده | ✓ فعال |
| یادآور ۲۴ ساعته | ✓ فعال |
| تغییر زمان نوبت | ✓ فعال |
| درخواست استرداد تأیید شد | ✓ فعال |
قالب پیامها
قالب هر پیامک قابل ویرایش است. توکنهای موجود:
| توکن | مقدار |
|---|---|
{booking_ref} | کد رزرو |
{customer_name} | نام مشتری |
{service_name} | نام خدمت |
{staff_name} | نام کارمند |
{date_jalali} | تاریخ جلالی |
{time} | ساعت نوبت |
{price} | مبلغ |
{status} | وضعیت نوبت |
توکنهای لینک مانند {cancel_link} و {reschedule_link} در قالبهای ایمیل در دسترساند.
مثال پیشفرض تأییدیه (رویداد booking.created):
نوبت شما با کد {booking_ref} برای {service_name} در تاریخ {date_jalali} ساعت {time} ثبت شد.
فیلتر کردن پیام قبل از ارسال
آرگومان سوم فیلتر، شناسهی نوبت است و نام رویداد بهصورت booking.created، booking.confirmed، ... است.
add_filter( 'pronobat_sms_message', function( string $msg, string $event, int $appointment_id ) {
// اضافه کردن آدرس به پیامک تأییدیه
if ( $event === 'booking.created' ) {
$msg .= "\nآدرس: خیابان ولیعصر، پلاک ۱۲";
}
return $msg;
}, 10, 3 );لغو opt-out
اگر مشتری گزینه «دریافت پیامک» را در پروفایل خود غیرفعال کرده باشد، SmsService پیامک ارسال نمیکند (حتی اگر فیلتر pronobat_sms_before_send مقدار true برگرداند).
ارسال با الگو (پترن)
برای تحویل مطمئنِ پیامک تراکنشی، میتوانید برای هر رویداد یک کد الگو (پترن) مجزا تعیین کنید. در تنظیمات پیامک، «ارسال با الگو» را فعال کرده و کد الگوی هر رویداد (booking.created، booking.confirmed، booking.cancelled، payment.received و…) را وارد کنید. در این حالت، پیامک بهجای متن آزاد با الگوی ثبتشده در پنل اپراتور ارسال میشود.
حالت شبیهسازی (Dry-run)
با فعالکردن حالت شبیهسازی، اتصال و متن پیامک بدون مصرف اعتبار و بدون ارسال واقعی تست میشود؛ درخواست در لاگ ثبت میشود و پاسخ موفق برمیگردد. برای تست راهاندازی اولیه بسیار مفید است.
درگاه HTTP سفارشی
اگر از پنلی خارج از چهار سرویس داخلی استفاده میکنید، درگاه HTTP سفارشی را انتخاب کنید و آدرس، متد و قالب بدنهی درخواست را با جایگذارهای {phone} / {message} / {pattern} تنظیم کنید.
پرونوبت را همین الان امتحان کنید
یک نمونه کامل و زنده از افزونه با دادههای واقعی — بدون نیاز به نصب.