> ## 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 لمزامنة كاملة للعقارات والحجوزات والرسائل

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

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

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

<Tip>
  تتم مزامنة الرسائل في الاتجاهين - أجب على ضيف من Trellis فتظهر الرسالة في Guesty، والعكس صحيح. تتم مزامنة محادثات المالكين أيضاً، حتى تتمكن من إدارة كل التواصل من صندوق وارد واحد.
</Tip>

## الإعداد

<Steps>
  <Step title="افتح صفحة التكاملات">
    في Trellis، انتقل إلى **Settings > Integrations** واختر **Guesty**.
  </Step>

  <Step title="احصل على بيانات اعتماد Guesty API">
    في لوحة Guesty، انتقل إلى **Marketplace > API Keys**. انسخ API key وsecret.
  </Step>

  <Step title="أدخل بيانات الاعتماد في Trellis">
    الصق Guesty API key وsecret في الحقول المخصصة، ثم انقر على **Connect**.
  </Step>

  <Step title="انتظر المزامنة الأولية">
    ستستورد Trellis العقارات المدعومة من المزوّد والحجوزات الحديثة. يعتمد التوقيت على حجم Guesty API وحالة التكامل وحجم المحفظة.
  </Step>

  <Step title="تحقق من البيانات">
    راجع صفحتي **Properties** و**Reservations** في Trellis للتأكد من وصول كل شيء بشكل صحيح.
  </Step>
</Steps>

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

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

<Note>
  بعد المزامنة الأولية، تحافظ تحديثات المزوّد والمزامنات اليدوية على السجلات المدعومة محدثة. يعتمد التوقيت على حجم طلبات Guesty API وحالة التكامل وحجم المحفظة.
</Note>

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

يمكنك تشغيل مزامنة يدوية في أي وقت من **الإعدادات > التكاملات > Guesty**. انقر على زر **مزامنة** لفتح نافذة المزامنة، حيث تختار المدة الزمنية لاستيراد البيانات.

الخيارات المتاحة:

| الخيار | ما يتم استيراده              |
| ------ | ---------------------------- |
| 7 أيام | الحجوزات من الأسبوع الماضي   |
| 30 يوم | الحجوزات من آخر 30 يوم       |
| 90 يوم | الحجوزات من آخر 90 يوم       |
| مخصص   | عدد أيام مخصص تحدده (حتى 90) |

<Tip>
  استخدم خيار **مخصص** لإدخال عدد دقيق من الأيام. على سبيل المثال، أدخل `45` لاستيراد جميع الحجوزات من آخر 45 يوم.
</Tip>

<Note>
  تدعم مزامنة Guesty نطاقًا أقصى 90 يومًا. لاستيراد تاريخي أوسع، قم بتشغيل عدة مزامنات بنطاقات تاريخ مختلفة أو تواصل مع الدعم.
</Note>

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

يمكنك حظر التواريخ وإلغاء حظرها في تقويم Guesty مباشرة من Trellis - بما في ذلك عبر [وكيل الذكاء الاصطناعي](/ar/platform/ai-agent). يفيد ذلك في إقامات المالكين أو فترات الصيانة أو أي فترة تحتاج فيها إلى إخراج الوحدة من السوق.

عند حظر التواريخ، يمكنك إضافة **سبب** و**ملاحظة**:

* **السبب** - اختر من فئات Guesty القياسية، مثل "Owner block" أو "Maintenance"
* **الملاحظة** - أضف تفاصيل نصية توضح سبب حظر التواريخ، مثل "تجديد المطبخ حتى يوم 15"

<Tip>
  إذا لم يطابق سبب الحظر إحدى فئات Guesty المحددة مسبقاً، يحفظ Trellis النص تلقائياً كملاحظة حتى يبقى محفوظاً في تقويم Guesty.
</Tip>

لـ **إلغاء حظر** التواريخ، اطلب من وكيل AI أو استخدم التقويم في Trellis لإزالة حظر قائم. يُرسل التغيير إلى Guesty بعد أن تعالج Trellis التحديث.

***

## معلومات مهمة

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

<Warning>
  تأكد من أن مفتاح Guesty API لديه الصلاحيات الصحيحة. إذا لم تتم مزامنة العقارات أو الحجوزات، راجع إعدادات مفتاح API في Guesty Marketplace.
</Warning>

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

<AccordionGroup>
  <Accordion title="كم تستغرق المزامنة الأولية؟">
    يعتمد توقيت المزامنة الأولية على حجم Guesty API وحالة التكامل وحجم المحفظة. قد تستغرق المحافظ الأكبر وقتاً أطول.
  </Accordion>

  <Accordion title="هل يمكنني الرد على الضيوف والمالكين من Trellis؟">
    نعم. تتم مزامنة الرسائل في الاتجاهين لمحادثات الضيوف والموردين والمالكين. عند الرد في Trellis، تظهر الرسالة في Guesty أيضاً.
  </Accordion>

  <Accordion title="ماذا يحدث إذا حدّثت حجزاً في Guesty؟">
    التغييرات التي تتم في Guesty - مثل تغيير التواريخ أو تحديثات الضيف أو تغييرات الحالة - تتم مزامنتها إلى Trellis تلقائياً.
  </Accordion>

  <Accordion title="هل يمكن تعديل الحقول المخصصة في Trellis؟">
    الحقول المخصصة من Guesty حالياً للقراءة فقط في Trellis. يمكنك عرضها، لكن يجب إجراء التعديلات في Guesty.
  </Accordion>

  <Accordion title="هل يمكنني حظر التواريخ وإلغاء حظرها من Trellis؟">
    نعم. يمكنك حظر التواريخ في تقويم Guesty مع سبب وملاحظة اختيارية، وإلغاء الحظر عندما تكون جاهزاً. يمكنك فعل ذلك عبر وكيل AI بطلب حظر أو إلغاء حظر تواريخ محددة في عقار. تُرسل التغييرات إلى Guesty بعد أن تعالجها Trellis.
  </Accordion>

  <Accordion title="هل يمكنني إعادة مزامنة بياناتي يدويًا؟">
    نعم. اذهب إلى **الإعدادات > التكاملات > Guesty** وانقر على **مزامنة**. يمكنك اختيار نطاق محدد مسبقًا (7 أو 30 أو 90 يومًا) أو إدخال عدد مخصص من الأيام حتى 90.
  </Accordion>

  <Accordion title="هل يمكنني فصل التكامل وإعادة ربطه لاحقاً؟">
    نعم. يمكنك فصل التكامل في أي وقت من **Settings > Integrations**. ستبقى بياناتك الحالية في Trellis، ويمكنك إعادة الربط عندما تكون جاهزاً.
  </Accordion>

  <Accordion title="هل ستظهر تقييمات Guesty المدعومة؟">
    نعم - تتم مزامنة تقييمات Guesty المدعومة إلى Trellis عندما يتيحها Guesty عبر التكامل.
  </Accordion>
</AccordionGroup>