> ## 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 | 物件オーナーの連絡先詳細          |
| 問い合わせ     | Guesty → Trellis | ゲストからの予約前の問い合わせ       |
| カレンダーブロック | Trellis ↔ Guesty | 任意のメモ付きで日付のブロック・解除    |

<Tip>
  メッセージは双方向に同期されます。Trellisでゲストに返信するとGuestyにも表示され、その逆も同様です。オーナーとの会話も同期されるため、すべてのコミュニケーションを1つの受信トレイで管理できます。
</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日前   | 過去1週間の予約      |
| 30日前  | 過去30日間の予約     |
| 90日前  | 過去90日間の予約     |
| カスタム  | 指定した日数（最大90日） |

<Tip>
  **カスタム**オプションで正確な日数を入力できます。例えば、`45`と入力すると過去45日間のすべての予約をインポートできます。
</Tip>

<Note>
  Guestyの同期は最大90日間の範囲をサポートしています。より広い履歴インポートが必要な場合は、異なる日付範囲で複数の同期を実行するか、サポートにお問い合わせください。
</Note>

## カレンダーのブロックと解除

TrellisからGuestyカレンダーの日付を直接ブロック・解除できます - [AIエージェント](/ja/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>