> ## 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 | Профили контактов с email и телефоном                         |
| Сообщения             | Guesty ↔ Trellis | Разговоры с гостями, подрядчиками и владельцами в обе стороны |
| Пользовательские поля | Guesty → Trellis | Пользовательские поля объектов и бронирований                 |
| Отзывы                | Guesty → Trellis | Отзывы гостей с оценками                                      |
| Владельцы             | Guesty → Trellis | Контактные данные владельцев                                  |
| Запросы               | Guesty → Trellis | Предбронировочные запросы гостей                              |
| Блокировка календаря  | Trellis ↔ Guesty | Блокировка и разблокировка дат с примечаниями                 |

<Tip>
  Сообщения синхронизируются в обе стороны -- ответьте гостю в Trellis, и это появится в Guesty, и наоборот.
</Tip>

## Настройка

<Steps>
  <Step title="Откройте страницу Интеграции">
    В Trellis перейдите в **Настройки > Интеграции** и выберите **Guesty**.
  </Step>

  <Step title="Получите API-ключи Guesty">
    В панели Guesty перейдите в **Marketplace > API Keys**. Скопируйте API-ключ и секрет.
  </Step>

  <Step title="Введите учетные данные в Trellis">
    Вставьте API-ключ и секрет Guesty, нажмите **Подключить**.
  </Step>

  <Step title="Дождитесь начальной синхронизации">
    Trellis импортирует поддерживаемые провайдером объекты и недавние бронирования. Время зависит от объема Guesty API, состояния интеграции и размера портфеля.
  </Step>

  <Step title="Проверьте данные">
    Проверьте страницы **Объекты** и **Бронирования** в Trellis.
  </Step>
</Steps>

## Чего ожидать после подключения

* **Поддерживаемые объекты** появляются в Trellis после начальной синхронизации с фото, удобствами и адресами
* **Новые бронирования** синхронизируются автоматически
* **Сообщения** гостей, подрядчиков и владельцев появляются в почтовом ящике Trellis
* **Пользовательские поля** из Guesty доступны в Trellis (с префиксом `gy_cf_`)
* **Заметки бронирований** из Guesty синхронизируются как внутренние заметки

<Note>
  После начальной синхронизации обновления провайдера и ручные синхронизации поддерживают актуальность поддерживаемых записей. Время зависит от объема API Guesty, состояния интеграции и размера портфеля.
</Note>

## Ручная синхронизация

Вы можете запустить ручную синхронизацию в любое время из **Настройки > Интеграции > Guesty**. Нажмите кнопку **Синхронизировать**, чтобы открыть диалог синхронизации, где вы выбираете, за какой период импортировать данные.

Доступные варианты:

| Вариант          | Что импортируется                      |
| ---------------- | -------------------------------------- |
| 7 дней назад     | Бронирования за последнюю неделю       |
| 30 дней назад    | Бронирования за последние 30 дней      |
| 90 дней назад    | Бронирования за последние 90 дней      |
| Пользовательский | Указанное вами количество дней (до 90) |

<Tip>
  Используйте вариант **Пользовательский**, чтобы ввести точное количество дней. Например, введите `45` для импорта всех бронирований за последние 45 дней.
</Tip>

<Note>
  Синхронизации Guesty поддерживают максимальный диапазон 90 дней. Для более широкого исторического импорта выполните несколько синхронизаций с разными диапазонами дат или обратитесь в поддержку.
</Note>

## Блокировка и разблокировка календаря

Вы можете блокировать и разблокировать даты в календаре Guesty прямо из Trellis -- включая через [ИИ-агента](/ru/platform/ai-agent). При блокировке можно указать **причину** и **примечание**.

<Tip>
  Если причина блокировки не соответствует стандартным категориям Guesty, Trellis автоматически сохраняет текст как примечание.
</Tip>

***

## Полезно знать

* Пользовательские поля синхронизируются **из Guesty в Trellis** (односторонне).
* Все заметки бронирований импортируются как внутренние заметки.
* Новые объекты в Guesty автоматически появятся в Trellis при следующем цикле синхронизации.

<Warning>
  Убедитесь, что API-ключ Guesty имеет правильные разрешения.
</Warning>

## Часто задаваемые вопросы

<AccordionGroup>
  <Accordion title="Сколько длится начальная синхронизация?">
    Время начальной синхронизации зависит от объема Guesty API, состояния интеграции и размера портфеля. Большие портфели могут занять больше времени.
  </Accordion>

  <Accordion title="Могу ли я отвечать гостям и владельцам из Trellis?">
    Да! Сообщения синхронизируются в обе стороны.
  </Accordion>

  <Accordion title="Что происходит при обновлении бронирования в Guesty?">
    Изменения в Guesty автоматически синхронизируются с Trellis.
  </Accordion>

  <Accordion title="Можно ли редактировать пользовательские поля в Trellis?">
    Пользовательские поля из Guesty доступны только для чтения в Trellis.
  </Accordion>

  <Accordion title="Можно ли блокировать и разблокировать даты из Trellis?">
    Да. Вы можете блокировать даты с причиной и примечанием и разблокировать их. Можно делать это через ИИ-агента. Изменения синхронизируются мгновенно.
  </Accordion>

  <Accordion title="Можно ли вручную пересинхронизировать данные?">
    Да. Перейдите в **Настройки > Интеграции > Guesty** и нажмите **Синхронизировать**. Можно выбрать предустановленный диапазон (7, 30 или 90 дней) или ввести пользовательское количество дней до 90.
  </Accordion>

  <Accordion title="Можно ли отключить и переподключить позже?">
    Да. Существующие данные в Trellis сохраняются.
  </Accordion>

  <Accordion title="Синхронизируются ли поддерживаемые отзывы Guesty?">
    Да -- поддерживаемые отзывы Guesty синхронизируются с Trellis, когда Guesty предоставляет их через интеграцию.
  </Accordion>
</AccordionGroup>