> ## 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 更新和手动同步协调支持的房产、预订、宾客数据和消息。

## 同步内容

| 实体    | 方向               | 包含内容              |
| ----- | ---------------- | ----------------- |
| 房产    | 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 中，前往**设置 > 集成**并选择 **Guesty**。
  </Step>

  <Step title="获取 Guesty API 凭证">
    在 Guesty 仪表板中，前往**市场 > API 密钥**。复制您的 API 密钥和密钥。
  </Step>

  <Step title="在 Trellis 中输入凭证">
    将 Guesty API 密钥和密钥粘贴到提供的字段中，然后点击**连接**。
  </Step>

  <Step title="等待初始同步">
    Trellis 将导入供应商支持的房产和近期预订。所需时间取决于 Guesty API 数据量、集成状态和资产组合规模。
  </Step>

  <Step title="验证数据">
    检查 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>

## 日历封锁和解封

您可以直接从 Trellis 封锁和解封 Guesty 日历上的日期 - 包括通过 [AI 助手](/zh/platform/ai-agent)。这对于业主入住、维护窗口或任何需要将房源下架的时段很有用。

封锁日期时，您可以包含**原因**和**备注**：

* **原因** - 从 Guesty 的标准类别中选择（例如"业主封锁"或"维护"）
* **备注** - 添加解释封锁原因的自由文本（例如"厨房翻新至15号"）

<Tip>
  如果您的封锁原因不匹配 Guesty 的预定义类别，Trellis 会自动将文本保存为备注，确保始终保留在 Guesty 的日历中。
</Tip>

要**解封**日期，请让 AI 助手操作或使用 Trellis 中的日历移除现有封锁。更改会立即同步回 Guesty。

***

## 须知

* 自定义字段目前**从 Guesty 到 Trellis** 单向同步。在 Trellis 中编辑自定义字段暂时不会推送回 Guesty。
* Guesty 的所有预订备注作为内部备注导入 - 对团队可见但宾客不可见。
* 如果在 Guesty 中添加新房产，它会在下次同步周期自动出现在 Trellis 中。

<Warning>
  确保您的 Guesty API 密钥具有正确的权限。如果房产或预订未同步，请在 Guesty 市场中仔细检查 API 密钥设置。
</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。
  </Accordion>

  <Accordion title="可以手动重新同步数据吗？">
    可以。前往**设置 > 集成 > Guesty**并点击**同步**。您可以选择预设范围（7、30 或 90 天）或输入最多 90 天的自定义天数。
  </Accordion>

  <Accordion title="可以断开后重新连接吗？">
    可以。您可以随时从**设置 > 集成**断开集成。Trellis 中的现有数据将保留，准备好后可以重新连接。
  </Accordion>

  <Accordion title="支持的 Guesty 评价会显示吗？">
    是的 - 当 Guesty 通过集成公开支持的评价时，这些评价会同步到 Trellis。
  </Accordion>
</AccordionGroup>