> ## 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に認証情報を入力">
    Krossbookingの認証情報をフィールドに貼り付け、**接続**をクリックします。
  </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**で確認できます。

ダッシュボードは3つの同期タイプのレイテンシーを追跡します：

| 同期タイプ | 計測内容                                 |
| ----- | ------------------------------------ |
| メッセージ | 新しいゲストメッセージがTrellisの受信トレイに表示されるまでの時間 |
| スレッド  | 会話スレッドがKrossbookingから同期されるまでの時間      |
| 予約    | 新規または更新された予約がTrellisに反映されるまでの時間      |

各同期タイプについて、ダッシュボードは3つのパフォーマンスパーセンタイルを表示します：

* **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側で何か変更する必要がありますか？">
    Krossbooking側での変更は不要です。TrellisでAPI認証情報を提供するだけで接続が確立されます。
  </Accordion>

  <Accordion title="異なるOTAチャネルからのメッセージはどうなりますか？">
    サポートされているKrossbookingチャネルのメッセージがTrellisの1つの統合スレッドに入ります。一か所からサポート対象の会話を確認・返信できます。
  </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>