مرج‌تگ‌های بوکلیو در گرویتی‌فرمز و روش استفاده از آن‌ها

مرج‌تگ‌های بوکلیو برای زمانی هستند که بخواهید اطلاعات رزرو را در تاییدیه‌ها، نوتیفیکیشن‌های ایمیلی، پیامک، ادآن‌های پیام‌رسان یا متن‌های داینامیک گرویتی‌فرمز نمایش دهید. این تگ‌ها داده‌هایی مثل کد رزرو، خدمت، زمان، ارائه‌دهنده، مبلغ، تخفیف، خدمات اضافی و وضعیت پرداخت را از رزرو ثبت‌شده می‌خوانند و داخل متن جایگزین می‌کنند.

مرج‌تگ‌های بوکلیو کجا استفاده می‌شوند

• تاییدیه بعد از ثبت رزرو
• نوتیفیکیشن‌های ایمیلی گرویتی‌فرمز
• ادآن‌های پیامکی که از مرج‌تگ‌های گرویتی‌فرمز استفاده می‌کنند
• متن‌های داینامیک در بعضی ادآن‌های جانبی
• قالب‌های آماده پیام‌های بوکلیو که روی گرویتی‌فرمز سوار هستند

روش استفاده در گرویتی‌فرمز

برای استفاده از این تگ‌ها، کافی است آن‌ها را در متن تاییدیه، نوتیفیکیشن یا پیام ادآن مربوط قرار دهید تا بعد از ثبت رزرو با مقدار واقعی جایگزین شوند.

1. فرم موردنظر را در گرویتی‌فرمز باز کنید.
2. به بخش تاییدیه‌ها، نوتیفیکیشن‌ها یا تنظیمات ادآن پیامکی بروید.
3. داخل متن پیام، مرج‌تگ موردنظر را وارد یا از لیست مرج‌تگ‌ها انتخاب کنید.
4. تنظیمات را ذخیره کنید.
5. یک رزرو آزمایشی ثبت کنید و خروجی پیام را بررسی کنید.

دو شکل نوشتن مرج‌تگ‌ها

مرج‌تگ‌های بوکلیو با هر دو شکل زیر قابل استفاده هستند و از نظر خروجی تفاوتی ندارند:

• {bko_service}
• {booklio:service}

ارجاع به فیلد مشخص

وقتی یک فرم چند فیلد رزرو بوکلیو دارد، می‌توانید شناسه فیلد را هم به تگ اضافه کنید تا داده از همان فیلد خوانده شود.

• {bko_service:3}
• {booklio:service:3}

در این مثال، عدد 3 شناسه فیلد رزرو در همان فرم است.

فهرست کامل مرج‌تگ‌های بوکلیو

اطلاعات پایه رزرو و مشتری

اطلاعات خدمت، واحد و ارائه‌دهنده

تاریخ، زمان و ساختار زمانی رزرو

تخصیص و انتخاب منبع

خدمات اضافی

وضعیت‌ها و پرداخت

مبالغ و تخفیف

فاکتور و رزرو تکرارشونده

بهترین کاربرد هر خانواده از تگ‌ها

• برای پیام‌های کوتاه به مشتری: {bko_customer_name}، {bko_reservation_code}، {bko_service}، {bko_datetime}، {bko_payment_method}
• برای تاییدیه کامل رزرو: {bko_service}، {bko_employee}، {bko_resource}، {bko_total_amount}
• برای خروجی‌های مالی: {bko_total_amount}، {bko_discount_amount}، {bko_wallet_amount}، {bko_online_amount}، {bko_onsite_amount}
• برای رزروهای چندجلسه‌ای: {bko_booking_occurrences_count} و {bko_booking_occurrences}

خروجی بعضی تگ‌ها به چه شکل برمی‌گردد

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

• {bko_allocation_mode} به‌جای کد داخلی، برچسب خوانا برمی‌گرداند؛ مثل انتخاب توسط کاربر، منبع ثابت یا تخصیص خودکار.
• {bko_allocation_strategy} هم به‌صورت خوانا برمی‌گردد؛ مثل چرخشی، توزیع ظرفیت، تجمیع ظرفیت یا پرشدن براساس اولویت.
• {bko_total_amount} و سایر تگ‌های مالی با فرمت مبلغ نمایش داده می‌شوند و برای متن‌های نهایی آماده هستند.
• {bko_addons_duration} مدت زمان خدمات اضافی را همراه با واحد دقیقه برمی‌گرداند.
• {bko_booking_occurrences} برای رزروهای چندجلسه‌ای، فهرست همه جلسات را به‌صورت چندخطی برمی‌گرداند.

نمونه‌های آماده

نمونه پیام تایید رزرو

نمونه سطر مالی

تگ‌های مناسب برای تاییدیه‌های بعد از ثبت

در تاییدیه‌های موفق رزرو، معمولاً این تگ‌ها بیشترین کاربرد را دارند:

• {bko_reservation_code}
• {bko_service}
• {bko_datetime}
• {bko_employee}
• {bko_resource}
• {bko_payment_method}
• {bko_total_amount}

نکات مهم در استفاده

مرج‌تگ مخصوص خود فیلد رزرو

خود فیلد رزرو جلالی هم در خروجی مرج‌تگ گرویتی‌فرمز، مقدار فرمت‌شده‌تری نمایش می‌دهد. اگر از مودیفایر :value استفاده کنید، مقدار خام فیلد برگردانده می‌شود. اگر از :value استفاده نکنید، خروجی خواناتر و فرمت‌شده‌تری می‌گیرید.

متای ذخیره‌شده روی Entry

بوکلیو علاوه بر مرج‌تگ‌ها، نسخه‌ای از بعضی اطلاعات رزرو را به‌صورت متای Entry هم نگه می‌دارد تا بعضی ادآن‌ها و خروجی‌ها راحت‌تر از آن استفاده کنند. اگر یک ابزار جانبی مرج‌تگ سفارشی را مستقیم تفسیر نمی‌کند، این متاها می‌توانند راه‌حل جایگزین باشند.

راهکارهای آماده برای سناریوهای رایج

• برای پیام تایید ثبت رزرو، از تگ‌های کوتاه و قطعی استفاده کنید؛ مثل کد رزرو، خدمت، تاریخ‌وساعت و مبلغ.
• برای پیام‌های داخلی به مدیر، تگ‌های تکمیلی مثل روش پرداخت، وضعیت پرداخت، خدمات اضافی و تفکیک پرداخت کاربردی‌تر هستند.
• برای رزروهای چندجلسه‌ای، بهتر است تعداد جلسات و جزئیات جلسات را فقط در ایمیل یا پیام بلندتر قرار دهید، نه در پیامک کوتاه.
• اگر یک فرم چند فیلد رزرو دارد، در همه متن‌ها نسخه دارای شناسه فیلد را استفاده کنید تا پیام از رزرو درست تغذیه شود.
• اگر خروجی یک ادآن جانبی خالی است، به‌جای حذف تگ‌ها، ابتدا بررسی کنید همان ابزار مرج‌تگ سفارشی را می‌خواند یا باید از متای Entry استفاده شود.

خطاهای رایج

• استفاده از مرج‌تگ در فرمی که فیلد رزرو بوکلیو ندارد
• وجود چند فیلد رزرو در یک فرم بدون مشخص‌کردن شناسه فیلد در تگ
• انتظار خروجی برای تگ‌هایی که در آن رزرو اصلاً مقدار ندارند، مثل کوپن یا فاکتور
• استفاده از تگ‌های مالی در جایی که هنوز پرداخت کامل یا نهایی نشده است
• قراردادن جزئیات طولانی مثل همه جلسات رزرو در پیام‌های کوتاه یا پیامک