> ## 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.

# Krossbooking

> 将 Trellis 连接到 Krossbooking，同步房产、预订和消息

连接您的 Krossbooking 账户到 Trellis，在两个平台之间保持房产、预订、宾客和对话同步。

## 同步内容

| 实体 | 方向              | 包含内容                                   |
| -- | --------------- | -------------------------------------- |
| 房产 | Kross → Trellis | 房源详情和房产信息                              |
| 预订 | Kross → Trellis | 包含宾客数据和入住详情的预订                         |
| 宾客 | Kross → Trellis | 宾客联系人资料                                |
| 消息 | Kross ↔ Trellis | 支持的 Kross 渠道对话线程，可通过 Krossbooking 发回回复 |

<Tip>
  Trellis 可访问的 Krossbooking 渠道对话 - OTA 消息、直接消息和可用的业主沟通 - 会自动出现在您的 Trellis 收件箱中。
</Tip>

## 设置

<Steps>
  <Step title="打开集成页面">在 Trellis 中前往**设置 > 集成**并选择 **Krossbooking**。</Step>
  <Step title="获取 Krossbooking API 凭证">联系您的 Krossbooking 客户经理或在管理面板中找到 API 凭证。</Step>
  <Step title="在 Trellis 中输入凭证">将凭证粘贴到字段中并点击**连接**。</Step>
  <Step title="等待初始同步">Trellis 将导入房产、预订和近期对话。所需时间取决于 Krossbooking API 数据量、集成状态和房源规模。</Step>
  <Step title="验证数据">检查 Trellis 中的**房产**、**预订**和**收件箱**确认同步正确。</Step>
</Steps>

## 连接后的预期

* Krossbooking 的**房产**及其所有详情出现在 Trellis 中
* **预订**自动同步，包括宾客信息和入住日期
* 支持的对话线程的**消息**出现在 Trellis 收件箱
* 进入 Krossbooking 的**新预订**自动反映到 Trellis
* 从 Trellis 发送的**回复**通过 Krossbooking 送达宾客

<Note>消息方向会保留 - 您始终知道哪些来自宾客，哪些由团队发送。</Note>

## 监控同步状态

从 Trellis 直接查看 Krossbooking 集成的运行状况。前往**设置 > 集成 > Krossbooking**查看同步活动、API 统计和延迟趋势。

| 指标       | 描述                                  |
| -------- | ----------------------------------- |
| 近期同步运行   | 近期同步操作的日志，显示运行时间和成功与否               |
| API 调用统计 | 对 Krossbooking 的调用次数及成功率            |
| 错误       | 同步期间发生的问题                           |
| 同步延迟     | Krossbooking 中的变更出现在 Trellis 中所需的时间 |

### 同步延迟仪表板

同步延迟仪表板实时显示数据从 Krossbooking 流入 Trellis 的速度。位于**设置 > 集成 > Krossbooking**下。

仪表板跟踪三种同步类型的延迟：

| 同步类型 | 测量内容                     |
| ---- | ------------------------ |
| 消息   | 新宾客消息出现在 Trellis 收件箱的时间  |
| 线程   | 对话线程从 Krossbooking 同步的时间 |
| 预订   | 新建或更新的预订反映到 Trellis 的时间  |

每种同步类型显示三个性能百分位数：

* **p50** - 中位同步时间。一半的同步比这更快完成。
* **p90** - 90% 的同步在此时间内完成。
* **p99** - 99% 的同步在此时间内完成。捕获偶尔较慢的同步。

折线图显示这些值随时间的变化趋势，便于发现同步性能是在改善还是恶化。

<Tip>延迟仅针对常规增量同步测量 - 连接账户后的首次导入不包含在内，因为它处理的历史数据量更大。</Tip>

<Note>使用延迟仪表板查看您工作区的实际同步时间。如果 p99 值持续上升，请联系支持团队调查。</Note>

## 须知

* Krossbooking 在意大利和南欧的运营商中特别受欢迎。Trellis 完全支持这些市场的 Kross 功能集。
* Krossbooking 集成暴露的对话渠道（Booking.com、Airbnb、直接预订等）会统一到 Trellis 收件箱。
* 同步会定期运行，因此新预订和消息会在提供商更新处理后出现在 Trellis 中。

## 常见问题

<AccordionGroup>
  <Accordion title="新预订多快会出现在 Trellis 中？">新预订会在您的工作区处理 Krossbooking 更新后同步到 Trellis。</Accordion>
  <Accordion title="可以从 Trellis 回复宾客吗？">可以。消息双向同步。在 Trellis 中回复时，回复通过 Krossbooking 在原始渠道上送达宾客。</Accordion>
  <Accordion title="需要在 Krossbooking 中做任何更改吗？">不需要。只需在 Trellis 中提供 API 凭证即可建立连接。</Accordion>
  <Accordion title="来自不同 OTA 渠道的消息会怎样？">支持的 Krossbooking 渠道消息会进入 Trellis 的统一线程。您可以在一处查看并回复这些对话。</Accordion>
  <Accordion title="可以断开集成吗？">可以。前往**设置 > 集成**随时断开 Krossbooking。Trellis 中的现有数据将保留。</Accordion>
  <Accordion title="如何知道同步是否正常工作？">前往**设置 > 集成 > Krossbooking**查看同步历史、API 统计和同步延迟仪表板。</Accordion>
  <Accordion title="p50、p90 和 p99 延迟数字是什么意思？">这些是性能百分位数。p50 是中位数。p90 表示 90% 的同步在该时间内完成。p99 捕获最慢的 1%。综合起来，它们提供 Krossbooking 数据到达 Trellis 速度的完整图景。</Accordion>
</AccordionGroup>
