الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.trellistech.com/llms.txt

Use this file to discover all available pages before exploring further.

اربط حساب Guesty بـ Trellis وحافظ على مزامنة عقاراتك وحجوزاتك وبيانات ضيوفك ورسائلك - تلقائيًا وفي الوقت الحقيقي.

ما تتم مزامنته

الكيانالاتجاهما يشمله
العقاراتGuesty → Trellisالوحدات مع وسائل الراحة والصور والعناوين
الحجوزاتGuesty → Trellisالحجوزات مع معلومات الضيف والتواريخ والبيانات المالية
الضيوفGuesty → Trellisملفات التواصل مع البريد الإلكتروني والهاتف
الرسائلGuesty ↔ Trellisمحادثات الضيوف والموردين والمالكين في الاتجاهين
الحقول المخصصةGuesty → Trellisحقول مخصصة على مستوى العقار والحجز
التقييماتGuesty → Trellisتقييمات الضيوف مع الدرجات
المالكينGuesty → Trellisتفاصيل تواصل مالك العقار
الاستفساراتGuesty → Trellisاستفسارات الضيوف قبل الحجز
حظر التقويمTrellis ↔ Guestyحظر التواريخ وإلغاء حظرها مع ملاحظات اختيارية
تتم مزامنة الرسائل في الاتجاهين - أجب على ضيف من Trellis فتظهر الرسالة في Guesty، والعكس صحيح. تتم مزامنة محادثات المالكين أيضاً، حتى تتمكن من إدارة كل التواصل من صندوق وارد واحد.

الإعداد

1

افتح صفحة التكاملات

في Trellis، انتقل إلى Settings > Integrations واختر Guesty.
2

احصل على بيانات اعتماد Guesty API

في لوحة Guesty، انتقل إلى Marketplace > API Keys. انسخ API key وsecret.
3

أدخل بيانات الاعتماد في Trellis

الصق Guesty API key وsecret في الحقول المخصصة، ثم انقر على Connect.
4

انتظر المزامنة الأولية

ستستورد Trellis العقارات المدعومة من المزوّد والحجوزات الحديثة. يعتمد التوقيت على حجم Guesty API وحالة التكامل وحجم المحفظة.
5

تحقق من البيانات

راجع صفحتي Properties وReservations في Trellis للتأكد من وصول كل شيء بشكل صحيح.

ما المتوقع بعد الاتصال

  • تظهر العقارات المدعومة في Trellis بعد المزامنة الأولية، مع الصور ووسائل الراحة والعناوين
  • يتم التقاط الحجوزات الجديدة عبر تحديثات Guesty ودورات المزامنة
  • تظهر رسائل الضيوف والموردين والمالكين في صندوق وارد Trellis حتى يتمكن فريقك من الرد من مكان واحد
  • تتوفر الحقول المخصصة من Guesty في Trellis للرجوع إليها، مع بادئة gy_cf_ للتوضيح
  • تتم مزامنة ملاحظات الحجز من Guesty كملاحظات داخلية على الحجز في Trellis
بعد المزامنة الأولية، تحافظ تحديثات المزوّد والمزامنات اليدوية على السجلات المدعومة محدثة. يعتمد التوقيت على حجم طلبات Guesty API وحالة التكامل وحجم المحفظة.

المزامنة اليدوية

يمكنك تشغيل مزامنة يدوية في أي وقت من الإعدادات > التكاملات > Guesty. انقر على زر مزامنة لفتح نافذة المزامنة، حيث تختار المدة الزمنية لاستيراد البيانات. الخيارات المتاحة:
الخيارما يتم استيراده
7 أيامالحجوزات من الأسبوع الماضي
30 يومالحجوزات من آخر 30 يوم
90 يومالحجوزات من آخر 90 يوم
مخصصعدد أيام مخصص تحدده (حتى 90)
استخدم خيار مخصص لإدخال عدد دقيق من الأيام. على سبيل المثال، أدخل 45 لاستيراد جميع الحجوزات من آخر 45 يوم.
تدعم مزامنة Guesty نطاقًا أقصى 90 يومًا. لاستيراد تاريخي أوسع، قم بتشغيل عدة مزامنات بنطاقات تاريخ مختلفة أو تواصل مع الدعم.

حظر التقويم وإلغاء الحظر

يمكنك حظر التواريخ وإلغاء حظرها في تقويم Guesty مباشرة من Trellis - بما في ذلك عبر وكيل الذكاء الاصطناعي. يفيد ذلك في إقامات المالكين أو فترات الصيانة أو أي فترة تحتاج فيها إلى إخراج الوحدة من السوق. عند حظر التواريخ، يمكنك إضافة سبب وملاحظة:
  • السبب - اختر من فئات Guesty القياسية، مثل “Owner block” أو “Maintenance”
  • الملاحظة - أضف تفاصيل نصية توضح سبب حظر التواريخ، مثل “تجديد المطبخ حتى يوم 15”
إذا لم يطابق سبب الحظر إحدى فئات Guesty المحددة مسبقاً، يحفظ Trellis النص تلقائياً كملاحظة حتى يبقى محفوظاً في تقويم Guesty.
لـ إلغاء حظر التواريخ، اطلب من وكيل AI أو استخدم التقويم في Trellis لإزالة حظر قائم. يُرسل التغيير إلى Guesty بعد أن تعالج Trellis التحديث.

معلومات مهمة

  • تتم مزامنة الحقول المخصصة حالياً من Guesty إلى Trellis فقط. تعديل الحقول المخصصة في Trellis لا يدفع التغييرات إلى Guesty بعد.
  • يتم استيراد كل ملاحظات الحجز من Guesty كملاحظات داخلية - تظهر لفريقك ولا تظهر للضيوف.
  • إذا أضفت عقاراً جديداً في Guesty، فسيظهر تلقائياً في Trellis أثناء دورة المزامنة التالية.
تأكد من أن مفتاح Guesty API لديه الصلاحيات الصحيحة. إذا لم تتم مزامنة العقارات أو الحجوزات، راجع إعدادات مفتاح API في Guesty Marketplace.

الأسئلة الشائعة

يعتمد توقيت المزامنة الأولية على حجم Guesty API وحالة التكامل وحجم المحفظة. قد تستغرق المحافظ الأكبر وقتاً أطول.
نعم. تتم مزامنة الرسائل في الاتجاهين لمحادثات الضيوف والموردين والمالكين. عند الرد في Trellis، تظهر الرسالة في Guesty أيضاً.
التغييرات التي تتم في Guesty - مثل تغيير التواريخ أو تحديثات الضيف أو تغييرات الحالة - تتم مزامنتها إلى Trellis تلقائياً.
الحقول المخصصة من Guesty حالياً للقراءة فقط في Trellis. يمكنك عرضها، لكن يجب إجراء التعديلات في Guesty.
نعم. يمكنك حظر التواريخ في تقويم Guesty مع سبب وملاحظة اختيارية، وإلغاء الحظر عندما تكون جاهزاً. يمكنك فعل ذلك عبر وكيل AI بطلب حظر أو إلغاء حظر تواريخ محددة في عقار. تُرسل التغييرات إلى Guesty بعد أن تعالجها Trellis.
نعم. اذهب إلى الإعدادات > التكاملات > Guesty وانقر على مزامنة. يمكنك اختيار نطاق محدد مسبقًا (7 أو 30 أو 90 يومًا) أو إدخال عدد مخصص من الأيام حتى 90.
نعم. يمكنك فصل التكامل في أي وقت من Settings > Integrations. ستبقى بياناتك الحالية في Trellis، ويمكنك إعادة الربط عندما تكون جاهزاً.
نعم - تتم مزامنة تقييمات Guesty المدعومة إلى Trellis عندما يتيحها Guesty عبر التكامل.