ما هي وسوم Liquid (وكيف يمكنك استخدامها في TicketingHub)؟

هل تمنيت يومًا أن تخصّص كل رسالة بريد إلكتروني أو تذكرة يتلقاها عملاؤك، من دون إعادة كتابة المحتوى بالكامل في كل مرة؟ هذا هو المجال الذي تتألق فيه وسوم Liquid. يوضّح هذا الدليل لمستخدمي TicketingHub كيفية إرسال رسائل ذكية وديناميكية تستخرج معلومات آنية من كل حجز.

سواء كنت ترحّب بالضيوف بأسمائهم، أو تغيّر الرسائل بناءً على اللغة، أو تعدّل التفاصيل وفقًا ليوم الأسبوع، تساعدك وسوم Liquid على أتمتة العملية مع الحفاظ على الطابع الشخصي. ولا تحتاج إلى أي معرفة بالبرمجة.

ما هو وسم Liquid تحديدًا؟

وسوم Liquid هي عناصر نائبة — أجزاء صغيرة من التعليمات البرمجية تُدرج تلقائيًا معلومات مخصّصة من حجز العميل في رسائل البريد الإلكتروني أو التذاكر أو الرسائل الآلية.

على سبيل المثال، إذا كتبت:

Hello {{ customer.first_name }}, your tour is confirmed!

فسيتلقى العميل:

Hello Carl, your tour is confirmed!

مهم: تستخدم جميع وسوم Liquid في TicketingHub قوسين معقوفين مزدوجين {{ }} لمتغيرات الإخراج، و{% %} للمنطق. استخدم هذا التنسيق دائمًا — ولا تستخدم الأقواس المفردة { }.

ملاحظة حول أدوات الذكاء الاصطناعي: إذا طلبت من ChatGPT أو Gemini أو أي مساعد ذكاء اصطناعي آخر كتابة قوالب لوسوم Liquid، فقد لا تتوافق الصياغة التي يقترحها مع تطبيق TicketingHub. تحقّق من النافذة المنبثقة لشارة Liquid Supported عند ظهورها، واستعن بالأمثلة الموجودة في هذه الصفحة.

أنواع وسوم Liquid التي يمكنك استخدامها

يدعم TicketingHub نوعين رئيسيين من وسوم Liquid:

وسوم الإخراج

تُظهر هذه الوسوم تفاصيل محددة عن الحجز، مثل الأسماء والتواريخ ومعلومات المنتج.

Hello {{ customer.first_name }}, your tour on {{ booked_for_date }} is confirmed.

وسوم المنطق

تتيح لك هذه الوسوم إنشاء قواعد وعرض محتوى مختلف وفقًا لشروط معينة، مثل لغة الحجز أو نوع التذكرة أو يوم الأسبوع.

{% if order.language == "fr" %}
  Add your French-language message here.
{% else %}
  Hello! Thank you for your booking.
{% endif %}

كيفية التحقق مما إذا كان القسم يدعم وسوم Liquid

لا يوجد مفتاح تفعيل. تعمل Liquid في المحرر أو الحقل الذي تظهر فيه شارة Liquid Supported. كما أنها مدعومة في رسائل حجز التذاكر والقسائم، وفي تذييلات التذاكر.

مرّر المؤشر فوق شارة Liquid Supported لفتح نافذتها المنبثقة. استخدمها كمرجع مباشر لذلك القسم، لكن لا تفترض أن النافذة المنبثقة تعرض كل الحقول الممكنة. عاين رسالتك أو اختبرها قبل إرسالها إلى العملاء.

أين تستخدم وسوم Liquid في TicketingHub

تعمل وسوم Liquid في:

• المحررات والحقول التي تحمل شارة Liquid Supported
• رسائل حجز التذاكر والقسائم المدعومة
• تذييلات التذاكر
• قوالب رسائل البريد الإلكتروني المدعومة للمنتجات والحسابات

لا تتوفر جميع المتغيرات في كل موضع. يمكن لرسائل البريد الإلكتروني الخاصة بالحجز استخدام تفاصيل حجز واحد، بينما تشمل الإيصالات والفواتير وعمليات ردّ المبالغ وطلبات الدفع الطلب بأكمله، ولها مجموعة مختلفة من التفاصيل. إذا ظهر وسم فارغًا، فتحقّق من النافذة المنبثقة للشارة ومن إرشادات السياق أدناه، ثم اختبره باستخدام مثال حقيقي.

إضافة Liquid إلى رسالة بريد إلكتروني لمنتج

1. افتح المنتج وانتقل إلى Emails.
2. ابحث عن القالب الذي تريد تغييره وحدد View، ثم Edit.
3. أضف مخرجات Liquid أو منطقها المدعوم إلى الرسالة.
4. احفظ القالب.
5. استخدم Send Test Email عند توفره، وتحقق من النتيجة المعروضة قبل استخدام القالب مع العملاء.

تخصيص الرسائل حسب اللغة

إذا كان لديك عملاء دوليون ومحليون، يمكنك تخصيص رسائلك وفقًا للغة المحددة عند إجراء الحجز.

تحديث: يلتقط المتغير {{ order.language }} الآن اللغة التي اختارها العميل في أداة الحجز بشكل صحيح. وسيعمل منطق اللغة الشرطي لديك بشكل موثوق مع جميع الحجوزات الجديدة.

{% if order.language == "es" %}
  Add your Spanish-language message here.
{% elsif order.language == "fr" %}
  Add your French-language message here.
{% else %}
  Hello! Thank you for your booking.
{% endif %}

تخصيص الرسائل حسب نوع التذكرة

هل تريد تقديم رسائل خاصة لحاملي تذاكر كبار الشخصيات أو للطلاب؟ استخدم الوسوم الشرطية للتخصيص وفقًا لنوع التذكرة.

{% if tier_names contains "VIP" %}
  Welcome VIP! Enjoy your complimentary welcome drink.
{% elsif tier_names contains "Student" %}
  Don't forget to bring your student ID.
{% else %}
  Thanks for booking! Please arrive on time and enjoy the tour.
{% endif %}

تغيير نقطة الالتقاء حسب يوم الأسبوع

إذا تغيّر موقع الالتقاء في أيام معينة، يمكنك إعداد قاعدة لعرض المعلومات الصحيحة تلقائيًا.

{% assign weekday = booked_for_date | date: '%a' %}
{% if weekday == 'Mon' %}
  Please meet at our annex building.
{% else %}
  Please meet at our main office.
{% endif %}

شروط اللغة المتقدمة

ينظّم العديد من المشغّلين جولات لجمهور دولي. تُبقي هذه الأمثلة المخرجات كنصوص نائبة باللغة الإنجليزية، بحيث يمكنك استبدالها بترجمتك التي راجعتها.

رسالة من اليمين إلى اليسار:

{% if order.language == "he" %}
<p style="direction: rtl; text-align: right;">
  Add your reviewed right-to-left message for {{ customer.first_name }} here.<br>
  <strong>Product:</strong> {{ product.name }}
</p>
{% else %}
  Hello {{ customer.first_name }}! Thank you for your booking.
{% endif %}

رسالة خاصة بلغة معينة:

{% if order.language == "ja" %}
  Add your Japanese-language message for {{ customer.first_name }} here.
  Product: {{ product.name }}
{% else %}
  Hello {{ customer.first_name }}, thank you for your booking.
  Tour: {{ product.name }}
{% endif %}

نصيحة احترافية: يمكنك جمع شروط نوع التذكرة واللغة واليوم في رسالة واحدة. تحقّق من شارة Liquid Supported عند ظهورها، وعاين النتيجة دائمًا.

تحقق من الدعم قبل النشر

لا تفترض أن Liquid تعمل في كل حقل نصي. إذا لم تظهر شارة Liquid Supported، ولم يكن الحقل رسالة حجز تذكرة أو قسيمة مدعومة أو تذييل تذكرة مدعومًا، فاختبره قبل الاعتماد على المحتوى الديناميكي.

قد تظهر الوسوم غير المدعومة فارغة أو تبقى كما كُتبت. أرسل رسالة بريد إلكتروني تجريبية أو أنشئ تذكرة أو قسيمة تجريبية قبل نشر التغييرات الموجّهة إلى العملاء.

لماذا تستخدم وسوم Liquid؟

لأنها تساعدك على:

• تخصيص رسائل العملاء تلقائيًا باستخدام بيانات الحجز الفعلية
• إرسال رسائل البريد الإلكتروني بلغة عملائك من دون إدارة قوالب منفصلة
• تجنّب التعديلات اليدوية وتقليل الأخطاء البشرية
• عرض معلومات دقيقة وديناميكية لكل حجز — مثل نقاط الالتقاء وأوقات الاستلام وتفاصيل المرشد وغير ذلك

وسوم Liquid الشائعة

فيما يلي مجموعة من الوسوم الشائعة مرتبة حسب الفئة. يعتمد توفرها على موضع استخدامها، وقد لا يشمل هذا المرجع كل الحقول الممكنة. استخدم النافذة المنبثقة لشارة Liquid Supported عند ظهورها، وراجع الوسوم التي يدعمها كل بريد إلكتروني أدناه لمعرفة سياق رسائل البريد الإلكتروني.

الطلب والحجز

{{ reference }}
{{ order.reference }}
{{ order.language }}         — Language selected by the customer in the booking widget.
{{ order.referral_code }}
{{ order.checkout_url }}
{{ booked_for_date }}
{{ size }}                   — Number of people in the booking.
{{ group_booking }}
{{ questions_with_answers }}
{{ extra_names }}

القسيمة

{{ voucher }}                — Note: returns true or false indicating whether this is a voucher
                               booking. It does not contain a voucher or reference code — use
                               {{ reference }} for the booking reference.

المنتج

{{ product.name }}
{{ product.address.name }}
{{ product.address.building }}
{{ product.address.street }}
{{ product.address.city }}
{{ product.address.region }}
{{ product.address.postal_code }}
{{ product.address.country }}
{{ product.address.google_maps_url }}
{{ product.formatted_address }}

الموسم والمتغيّر والخيار

{{ season.name }}
{{ variant.name }}
{{ tier_names }}
{{ option.name }}
{{ option.time }}

العميل

{{ customer.first_name }}
{{ customer.last_name }}
{{ customer.full_name }}
{{ customer.company }}
{{ customer.email }}

الحاضر

{{ attendee.first_name }}
{{ attendee.last_name }}
{{ attendee.full_name }}
{{ attendee.company }}
{{ attendee.email }}

الاستلام

{{ pickup.location }}
{{ pickup.time }}
{{ pickup.note }}
{{ pickup.map }}

المورّد

{{ supplier.name }}
{{ supplier.logo }}
{{ supplier.logo_url }}
{{ supplier.website }}
{{ supplier.telephone }}
{{ supplier.email }}

المرشد

{{ guide.name }}
{{ guide.first_name }}
{{ guide.last_name }}
{{ guide.telephone }}

القناة وبائع إعادة البيع

{{ channel.name }}
{{ reseller.name }}

الدفع وردّ المبلغ

{{ amount }}
{{ payment_link }}

المنتجات التجارية

{{ merchandise.name }}

أخرى

{{ notes }}
{{ manage_booking_url }}
{{ smartwaiver_url }}
{{ tickets_download_url }}     — Link for the customer to download their tickets.

الوسوم التي يدعمها كل بريد إلكتروني

لا يعمل كل وسم في كل رسالة بريد إلكتروني. وقد يظهر الوسم غير المدعوم في رسالة معينة فارغًا، لذا اختبر القوالب قبل استخدامها. وتُعد النافذة المنبثقة لشارة Liquid Supported المرجع المباشر لذلك القالب عند ظهورها، مع أنها قد لا تعرض كل الحقول الممكنة.

مهم — تفاصيل الحجز مقابل تفاصيل الطلب: تصف وسوم مثل {{ attendee.* }} و{{ product.* }} و{{ option.* }} و{{ pickup.* }} و{{ guide.* }} حجزًا واحدًا، ولا تعمل إلا في رسائل البريد الإلكتروني الخاصة بالحجز. أما رسائل الإيصال والفاتورة وردّ المبلغ وطلب الدفع فتغطي الطلب بأكمله، والذي قد يحتوي على عدة حجوزات، ولذلك لا تتوفر هذه الوسوم فيها — استخدم {{ customer.first_name }} بدلًا منها في التحية.

رسائل البريد الإلكتروني الخاصة بالحجز

تأكيد حجز التذكرة، وتأكيد حجز القسيمة، وتذكير بالحجز، وتغيير الحجز، وإلغاء الحجز، وملاحظات الحجز، واستعادة الحجز المتروك.

المدعوم: الطلب والحجز، والقسيمة، والمنتج، والموسم/المتغيّر/الخيار، والعميل، والحاضر، والاستلام، والمورّد، والمرشد، والقناة وبائع إعادة البيع، وأخرى.

رسائل الإيصال والفاتورة

الإيصال (يُرسل عند سداد الطلب بالكامل) والفاتورة/الفاتورة الأولية (تُرسل عند بقاء دفعة مقدّمة أو رصيد مستحق).

المدعوم: العميل، والمورّد، والطلب.

في هذه الرسائل يكون الطلب هو موضوع الرسالة، لذا اكتب حقول الطلب من دون البادئة order.: {{ reference }} و{{ language }} و{{ referral_code }} و{{ checkout_url }}.

رسائل ردّ المبلغ

تُرسل عند إصدار ردّ للمبلغ.

المدعوم: العميل، والمورّد، والطلب، و{{ amount }}.

رسائل طلب الدفع

تُرسل عندما تطلب من العميل سداد رصيد مستحق.

المدعوم: الطلب، و{{ amount }}، و{{ payment_link }}.

في هذه الرسائل يكون العميل والمورّد متداخلين ضمن الطلب — استخدم {{ order.customer.first_name }} و{{ order.supplier.name }}.

رسائل بطاقات الهدايا

تُرسل عند شراء العميل بطاقة هدية.

المدعوم: العميل، والمورّد، و{{ reference }}، و{{ merchandise.name }}.

أخطاء شائعة يجب تجنّبها

1. استخدام الأقواس المفردة بدلًا من الأقواس المزدوجة

Wrong:   { customer.first_name }
Correct: {{ customer.first_name }}

2. الخلط بين product وtour في أسماء المتغيرات

Wrong:   {{ tour.name }}
Correct: {{ product.name }}

يستخدم TicketingHub المتغير product — وهذا هو خطأ الصياغة الأكثر شيوعًا الذي نراه.

3. الثقة في صياغة الوسوم التي ينشئها الذكاء الاصطناعي

قد يقترح ChatGPT وGemini صيغًا لوسوم Liquid لا تتوافق مع تطبيق TicketingHub. تحقّق من شارة Liquid Supported عند ظهورها، وقارن الاقتراح بالأمثلة الموجودة في هذه الصفحة.

4. استخدام وسوم Liquid من دون التحقق من الدعم

ابحث عن شارة Liquid Supported، أو استخدم رسالة حجز تذكرة أو قسيمة مدعومة أو تذييل تذكرة مدعومًا. عاين النتيجة قبل النشر.

5. عدم توفر المتغير في نوع البريد الإلكتروني المعني

لا تتوفر بعض المتغيرات إلا في أنواع محددة من رسائل البريد الإلكتروني. إذا لم يُعرض الوسم، فتحقّق من الوسوم التي يدعمها كل بريد إلكتروني أعلاه — فقد لا يكون المتغير مدعومًا في رسالة البريد الإلكتروني تلك.

تبسيط وسوم Liquid

قد تبدو وسوم Liquid تقنية، لكنك ما إن تتقن استخدامها حتى تصبح أداة فعّالة للغاية. فهي مثالية للمشغّلين المشغولين الذين يريدون أتمتة التواصل من دون فقدان الطابع الشخصي.

وإذا لم تكن متأكدًا من كيفية بناء وسم ما، فنحن هنا لمساعدتك — ما عليك سوى التواصل معنا!