این راهنما ساختار اعلان‌های فرم رزرو را در بوکلیو یک‌جا توضیح می‌دهد: رویدادهای رزرو چه هستند، چه تمپلیت‌هایی به‌صورت خودکار ساخته می‌شوند، اعلان‌های ایمیلی چطور کار می‌کنند، پیامک در کجای این معماری قرار می‌گیرد و اعلان‌های پیش‌رو چطور اجرا می‌شوند.
اعلان در بوکلیو دقیقا به چه معناست
در فرم‌های رزرو بوکلیو، اعلان فقط یک ایمیل ساده بعد از ثبت فرم نیست. افزونه چند لایه اطلاع‌رسانی دارد:
- اعلان‌های رویدادی گرویتی‌فرمز برای رخدادهای رزرو
- زیرساخت مرج‌تگ و متادیتا برای استفاده در ایمیل و پیامک
- آرشیو داخلی
اطلاعرسانیدر پنل برای مدیر و کارمند
پس وقتی می‌گوییم «اعلان رزرو»، باید روشن کنیم درباره ایمیل/پیامک فرم صحبت می‌کنیم یا درباره اعلان داخلی داخل پنل.
چه رویدادهایی برای رزرو ثبت می‌شوند
بوکلیو این رویدادها را به لیست رویدادهای اعلان گرویتی‌فرمز اضافه می‌کند:
booklio_booking_createdیا رزرو ایجاد شدbooklio_booking_confirmedیا رزرو تایید شدbooklio_booking_cancelledیا رزرو لغو شدbooklio_booking_upcomingیا رزرو پیش‌روbooklio_booking_rescheduledیا رزرو تغییر زمان یافت
به این ترتیب، در فرم رزرو می‌توانید اعلان‌ها را بر اساس رخدادهای واقعی رزرو تنظیم کنید، نه فقط بر اساس ارسال عادی فرم.
بوکلیو چه تمپلیت‌های پیش‌فرضی را برای اعلان‌ها می‌سازد
اگر فرم دارای فیلد رزرو بوکلیو باشد، افزونه برای آن چند اعلان پیش‌فرض به فرم اضافه می‌کند:
بوکلیو - رزرو تایید شدبوکلیو - رزرو لغو شدبوکلیو - زمان رزرو تغییر کردبوکلیو - یادآوری رزرو
نکته مهم این است که رویداد رزرو ایجاد شد در فهرست رویدادها ثبت می‌شود، اما در هسته فعلی برای آن تمپلیت پیش‌فرض خودکار ساخته نمی‌شود. اگر به این سناریو نیاز دارید، باید اعلانش را دستی بسازید.
گیرنده اعلان‌های ایمیلی چطور تعیین می‌شود
بوکلیو در تمپلیت‌های پیش‌فرض دنبال اولین فیلد ایمیل داخل فرم می‌گردد. اگر فیلد ایمیل پیدا شود، اعلان به همان فیلد متصل می‌شود. اگر فرم فیلد ایمیل نداشته باشد، مقصد پیش‌فرض ایمیل ادمین سایت خواهد بود.
آدرس فرستنده و پاسخ نیز از ایمیل ادمین سایت گرفته می‌شود و نام فرستنده از نام سایت پر می‌شود.
آیا این اعلان‌های پیش‌فرض بعدا قابل ویرایش هستند
بله، تفاوت مهم اعلان‌ها با تاییدیه‌های مدیریت‌شده همین‌جاست. بوکلیو اعلان‌های پیش‌فرض را در صورت نبودن به فرم اضافه می‌کند، اما اعلان‌های موجود را دوباره بازنویسی نمی‌کند. یعنی بعد از ساخته‌شدن، می‌توانید عنوان، موضوع و متن آن‌ها را برای نیاز پروژه خودتان شخصی‌سازی کنید.
چه زمانی هر رویداد اجرا می‌شود
رزرو ایجاد شد
وقتی رزرو ساخته می‌شود، این رویداد فراخوانی می‌شود. اگر اعلان مرتبط را دستی بسازید، می‌توانید از آن برای اطلاع اولیه استفاده کنید.
رزرو تایید شد
این رویداد وقتی اجرا می‌شود که وضعیت رزرو از یک وضعیت تاییدنشده به یکی از وضعیت‌های تاییدشده برسد. در منطق فعلی، رسیدن به وضعیت‌هایی مثل confirmed یا success می‌تواند باعث اجرای آن شود.
رزرو لغو شد
به محض اینکه وضعیت رزرو به cancelled برسد، اعلان لغو اجرا می‌شود.
رزرو تغییر زمان یافت
فقط وقتی تاریخ یا ساعت رزرو واقعا عوض شود این رویداد اجرا می‌شود. باز کردن مودال تغییر زمان بدون ثبت زمان جدید، اعلان را فعال نمی‌کند.
رزرو پیش‌رو
این رویداد بر اساس زمان‌بندی سیستم اجرا می‌شود و با فاصله‌ی زمانی مشخص قبل از شروع رزرو فعال می‌شود.
اعلان‌های پیش‌رو چطور کار می‌کنند
اعلان رزرو پیش‌رو وابسته به قابلیت پلن upcoming_notifications است. اگر این قابلیت در پلن فعال باشد و در تنظیمات هم روشن شده باشد، بوکلیو رزروهای آینده را بررسی می‌کند و در زمان مناسب رویداد یادآوری را می‌فرستد.
فاصله زمانی این اعلان می‌تواند بر حسب دقیقه، ساعت، روز یا ماه تنظیم شود. هسته برای اینکه اعلان‌های دقیقه‌محور از دست نروند، یک زمان‌بندی پنج‌دقیقه‌ای ثبت می‌کند و رزروهای واجد شرایط را در هر نوبت اسکن می‌کند.
مرج‌تگ‌های بوکلیو در اعلان‌ها چه کمکی می‌کنند
بوکلیو تعداد زیادی مرج‌تگ اختصاصی به گرویتی‌فرمز اضافه می‌کند تا اعلان‌ها فقط یک متن ثابت نباشند. از جمله:
{bko_customer_name}{bko_customer_phone}{bko_customer_email}{bko_service}{bko_datetime}{bko_employee}{bko_payment_status}{bko_payment_method}{bko_total_amount}{bko_invoice_url}
این مرج‌تگ‌ها در اعلان‌های ایمیلی، تاییدیه‌ها و بسیاری از مسیرهای یکپارچه‌سازی قابل استفاده‌اند.
ترکیب اعلان‌های بوکلیو با پیامک چطور است
در خود این افزونه، هسته برای پیامک چند کار مهم انجام می‌دهد: مرج‌تگ‌های بوکلیو را ثبت می‌کند، نسخه‌ی سازگار با لیست مرج‌تگ افزونه‌های پیامکی را می‌سازد و داده‌های رزرو را به‌صورت متای ورودی روی اینتری گرویتی‌فرمز همگام می‌کند.
به همین دلیل وقتی افزونه پیامک بوکلیو یا زیرساخت سازگار آن فعال باشد، می‌توانید در قالب‌های پیامکی هم از همان داده‌های رزرو استفاده کنید. در کد فعلی، این سازگاری به‌طور مشخص برای لیست مرج‌تگ gravity_sms_pro_merge_tags_list نیز پل زده شده است.
چرا همگام‌سازی متای رزرو با ورودی گرویتی مهم است
بوکلیو بعد از ثبت فرم و همین‌طور بعد از رویدادهای پرداخت، بخشی از داده‌های رزرو را به‌عنوان متای عمومی روی ورودی گرویتی‌فرمز ذخیره می‌کند. این کار باعث می‌شود افزونه‌های جانبی، خروجی‌ها، مپینگ‌ها و مسیرهای پیامکی راحت‌تر به داده رزرو دسترسی داشته باشند.
در عمل، این همان پلی است که ترکیب گرویتی‌فرمز، بوکلیو و ابزارهای پیامک/اعلان را قابل اتکا می‌کند.
آرشیو داخلی اعلان‌ها در پنل چه تفاوتی دارد
صفحه اطلاع‌رسانی داخل پنل با اعلان‌های ایمیلی/پیامکی یکی نیست. این بخش یک آرشیو داخلی برای مدیر و کارمند است و انواعی مثل این‌ها را نگه می‌دارد:
- رزرو جدید
- تایید رزرو
- لغو رزرو
- پرداخت ناموفق
- درخواست تسویه
- تسویه تاییدشده یا ردشده
- اطلاع‌رسانی عمومی و بروزرسانی هسته
در این صفحه می‌توانید بر اساس نوع، وضعیت خوانده‌شدن و بازه تاریخ فیلتر کنید و اعلان‌ها را به‌صورت خوانده‌شده علامت بزنید.
اعلان ایمیلی، پیامکی و آرشیو داخلی را چطور از هم جدا کنیم
- اگر هدف نمایش پیام برای مشتری یا مدیر از طریق ایمیل است، سراغ اعلان‌های فرم رزرو بروید.
- اگر هدف پیامک است، علاوه بر رویداد رزرو، پیکربندی افزونه پیامکی و مرج‌تگ‌های بوکلیو را بررسی کنید.
- اگر هدف پیگیری داخلی تیم است، صفحه
اطلاعرسانیرا مبنا قرار دهید.
برای عیب‌یابی اعلان‌ها از کجا شروع کنیم
- اول مطمئن شوید خود رویداد رزرو واقعا رخ داده است.
- اگر اعلان ایمیلی است، رویداد اعلان و مقصد ایمیل را در فرم بررسی کنید.
- اگر اعلان پیش‌رو است، تنظیمات زمانی و فعال‌بودن قابلیت را بررسی کنید.
- اگر موضوع پیامک است، فعال‌بودن افزونه پیامکی و دسترسی به مرج‌تگ‌های بوکلیو را بررسی کنید.
- اگر دنبال اثر داخلی هستید، آرشیو
اطلاعرسانیرا ببینید.