跳转到主要内容

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宾客的预订前咨询
日历封锁Trellis ↔ Guesty封锁和解封日期，可附备注
消息双向同步 - 在 Trellis 回复宾客会显示在 Guesty 中，反之亦然。业主对话也会同步，您可以在一个收件箱中管理所有沟通。

​
设置

1

打开集成页面

在 Trellis 中，前往设置 > 集成并选择 Guesty。
2

获取 Guesty API 凭证

在 Guesty 仪表板中，前往市场 > API 密钥。复制您的 API 密钥和密钥。
3

在 Trellis 中输入凭证

将 Guesty API 密钥和密钥粘贴到提供的字段中，然后点击连接。
4

等待初始同步

Trellis 将导入供应商支持的房产和近期预订。所需时间取决于 Guesty API 数据量、集成状态和资产组合规模。
5

验证数据

检查 Trellis 中的房产和预订页面，确认所有数据正确导入。

​
连接后的预期

  • 支持的房产会在初始同步后出现在 Trellis 中，包含照片、设施和地址
  • 新预订从 Guesty 自动同步
  • 宾客、供应商和业主消息出现在 Trellis 收件箱中，团队可以在一处回复
  • Guesty 的自定义字段在 Trellis 中可供参考（以 gy_cf_ 为前缀便于识别）
  • Guesty 的预订备注作为内部备注同步到 Trellis 的预订中
初始同步后，提供商更新和手动同步会让支持的记录保持最新。所需时间取决于 Guesty API 数据量、集成状态和房源规模。

​
手动同步

您可以随时从设置 > 集成 > Guesty触发手动同步。点击同步按钮打开同步对话框，选择要导入多久之前的数据。 可用选项：
选项导入内容
7 天前过去一周的预订
30 天前过去 30 天的预订
90 天前过去 90 天的预订
自定义您指定的天数（最多 90 天）
使用自定义选项输入确切的天数。例如，输入 45 可导入过去 45 天的所有预订。
Guesty 同步支持最多 90 天的范围。如需更广泛的历史导入，请使用不同日期范围运行多次同步，或联系支持团队。

​
日历封锁和解封

您可以直接从 Trellis 封锁和解封 Guesty 日历上的日期 - 包括通过 AI 助手。这对于业主入住、维护窗口或任何需要将房源下架的时段很有用。 封锁日期时，您可以包含原因和备注：
  • 原因 - 从 Guesty 的标准类别中选择（例如”业主封锁”或”维护”）
  • 备注 - 添加解释封锁原因的自由文本（例如”厨房翻新至15号”）
如果您的封锁原因不匹配 Guesty 的预定义类别，Trellis 会自动将文本保存为备注，确保始终保留在 Guesty 的日历中。
要解封日期，请让 AI 助手操作或使用 Trellis 中的日历移除现有封锁。更改会立即同步回 Guesty。

​
须知

  • 自定义字段目前从 Guesty 到 Trellis 单向同步。在 Trellis 中编辑自定义字段暂时不会推送回 Guesty。
  • Guesty 的所有预订备注作为内部备注导入 - 对团队可见但宾客不可见。
  • 如果在 Guesty 中添加新房产，它会在下次同步周期自动出现在 Trellis 中。
确保您的 Guesty API 密钥具有正确的权限。如果房产或预订未同步，请在 Guesty 市场中仔细检查 API 密钥设置。

​
常见问题

初始同步时间取决于 Guesty API 数据量、集成状态和资产组合规模。大型资产组合可能需要更长时间。
可以！消息对宾客、供应商和业主对话双向同步。在 Trellis 中回复时，消息也会出现在 Guesty 中。
在 Guesty 中所做的更改 - 如日期变更、宾客更新或状态变更 - 会自动同步到 Trellis。
Guesty 的自定义字段目前在 Trellis 中为只读。您可以查看但编辑需要在 Guesty 中进行。
可以。您可以在 Guesty 日历上封锁日期并附上原因和可选备注，准备好后解封。可以通过 AI 助手请求封锁或解封特定房产的日期。更改会立即同步回 Guesty。
可以。前往设置 > 集成 > Guesty并点击同步。您可以选择预设范围（7、30 或 90 天）或输入最多 90 天的自定义天数。
可以。您可以随时从设置 > 集成断开集成。Trellis 中的现有数据将保留，准备好后可以重新连接。
是的 - 当 Guesty 通过集成公开支持的评价时，这些评价会同步到 Trellis。