> ## 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に接続し、物件、予約、ゲスト、会話を両方のプラットフォームで同期します。

## ゲストポータルの宿泊税の支払い

宿泊税ルールの支払い同期が設定されている場合、Trellis ゲストポータルで受け取った新しい Stripe の本番決済は、Krossbooking に宿泊税の支払いとして記録されます。連携が有効で、書き込みが許可されている必要があります。他の必須料金や過去の未反映の支払いは自動では送信されません。税ルールの設定や過去の支払いの照合については、サポートにお問い合わせください。

## Inboxの宿泊ステータス

InboxでKrossbookingのステータスを使用する場合、滞在中のままの予約は、ワークスペースのタイムゾーンで出発日を過ぎるとチェックアウト済みとして表示され、既存のチェックアウトフィルターにも含まれます。これはTrellisの表示ルールであり、Krossbookingに保存されたステータスは変更しません。予約の詳細には、出発日からチェックアウトを推定した場合の説明と、Krossbookingから最後に受信したステータスが表示されます。

## 同期内容

| エンティティ | 方向 | 含まれる内容 |
| - | - | - |
| 物件 | 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.