
# Trafft

> **対象となるユーザーは？** この統合は、Trafftでスケジュールを管理している予約ビジネス（サロン、理髪店、クリニック、スタジオ、コンサルタント、修理店など）向けです。Trafftを使用していない場合は、このページをスキップしてください。
>
> 別の予約システムを使用していますか？APIを備えたシステムであれば、どのようなものでも接続可能です。[リストにないツールの接続](connecting-other-tools.md)を参照してください。カスタム関数、API、Webhookについて説明しています。

Trafftは、時間を販売するビジネス向けの予約プラットフォームです。サービス、スタッフ、場所を設定し、顧客がスロットを予約します。Trafftを<span data-t="appName">Your AI Connector</span>に接続すると、AIエージェントがチャット内で予約プロセス全体を処理できるようになります。予約リンクを送信して完了を待つのではなく、実際に空いている時間を確認し、予約を行い、時間を確定させることができます。

---

## Trafftでできること

Trafftは、予約ビジネスに以下を提供します。

- それぞれの所要時間と価格を持つサービス
- それぞれの勤務時間を持つスタッフ（従業員）
- 1つ以上の場所
- チーム用の予約ウェブサイトとカレンダー

Trafftを<span data-t="appName">Your AI Connector</span>に接続すると、そのスケジュールをAIがWhatsApp、SMS、Instagram、またはウェブサイトのチャットで利用できるようになります。AIはサービスとスタッフを読み取り、Trafftで実際の空き状況を確認し、予約を直接Trafftに書き込みます。そのため、チームがTrafftで確認する情報は常に最新の状態となります。

---

## Trafftの接続

> **開始する前に：** TrafftのBusinessプランに含まれるAPIアクセス権が必要です。Trafftの管理パネルを開き、**Features & Integrations → API & Connectors**を探してください。そのページがない場合、現在のTrafftプランには含まれていないため、接続はできません。

1. 左側のサイドバーで、**Settings**（歯車アイコン）をクリックします。
2. 設定サイドバーの**Integrations**グループの下にある、**Booking & Calendar**をクリックします。
3. **Trafft**カードを見つけて、**Connect**をクリックします。


4. **会社のアドレス**を入力します。これは、サインインするアドレスの `.admin.trafft.com` より前の部分です。例えば `acme.admin.trafft.com` でサインインする場合は、`acme` と入力してください。アドレス全体を貼り付けても問題ありません。その場合は、こちらで適切な部分を抽出します。**ホワイトラベルのTrafftアカウントですか？** Trafftのアドレスが代わりに `.admin.wlbookings.com` で終わる場合（代理店のホワイトラベルプランで作成されたアカウントに付与されるアドレス）、`acme.admin.wlbookings.com` のようにアドレス全体を貼り付けてください。これにより、Trafftの場所が特定されます。`acme` だけを入力すると、標準のTrafftアドレスで検索が行われ、別のアカウントとして扱われてしまいます。
5. **クライアントID**と**クライアントシークレット**を入力します。これらは両方とも、Trafft管理パネルの **Features & Integrations → API & Connectors** にあります。
6. 必要に応じて**ラベル**を追加します。これは独自のリスト用の名前で、複数のビジネスを管理している場合に便利です。
7. **Connect** をクリックします。


### 認証情報の確認

Trafftが確認するまで、何も保存されません。**Connect**をクリックすると、入力された情報でTrafftにサインインし、設定を読み取ります。会社のアドレスが間違っている、Client IDやSecretが間違っている、またはAPIアクセス権のないTrafftプランである場合は、その場で拒否され、理由が画面に表示されます。そのため、接続は成功したように見えて、顧客が予約しようとした時に失敗するという事態は発生しません。

接続が成功すると、接続された行に貴社の住所とともに、Trafft内で検出された**サービス**数と**スタッフ**数が表示されます。この数は、正しいアカウントが接続されていることの証明になります。例えば、サービスが2つと表示されているのに実際には20提供している場合は、間違ったアカウントを接続しています。

クライアントシークレットは暗号化されて保存され、二度と表示されることはありません（あなたにも、チームにも表示されません）。紛失した場合は、Trafftで新しいものを生成し、再度接続してください。

### 一時停止または接続解除

接続されたTrafftの行には、「予約とカレンダー」ページに専用のボタンが表示されます。


- **更新**：Trafftからサービスとスタッフの数を再度読み込みます（[後からサービスを追加または変更する](#adding-or-changing-services-later)を参照）。
- **一時停止**：接続設定を保持したまま、AIによるTrafftへの予約入力を停止します。**有効化**で再開できます。サービスの整理中や休業期間中に使用してください。
- **接続解除**：接続を完全に削除します。Trafftにすでに入っている予約はそのまま残ります。接続を解除しても、Trafftカレンダー内のデータがキャンセルされたり削除されたりすることはありません。後で同じ詳細情報を使用して再度接続することができます。

---

## AIエージェントにTrafftでの予約を指示する

Trafftを接続しただけでは、AIの動作は変わりません。エージェントに設定を割り当てます。

1. サイドバーの**AIエージェント**をクリックし、エージェントを開きます。
2. **AI機能**ステップに進み、**予約**カードを見つけます。
3. **このエージェントによる予約を許可する**をオンにします。
4. プロバイダー選択ツールをクリックし、**Trafft**を選択します（プロバイダーの選択肢はスイッチのすぐ下に表示されます）。
5. **変更を保存**をクリックします。


---

## AIにできること

プロバイダーとしてTrafftを選択すると、エージェントは通常の会話の中で以下のすべてを行うことができます。

- **提供内容を伝える。** Trafftのサービス一覧、所要時間、料金を提示し、スタッフの名前を挙げることができます。
- **空き状況を正確に確認する。** 顧客が希望するサービスの空き時間をTrafftに問い合わせます。顧客から特定のスタッフや場所の指定があれば、それに絞り込むことも可能です。最大1週間先まで確認するため、カレンダー全体を読み上げるのではなく、どの曜日や週を希望するかを尋ねます。
- **予約する。** 予約はその場でTrafftに作成され、確定予約として登録されます。AIは顧客に確定した時間を伝えます。顧客はTrafftの顧客リストに追加されるか、メールアドレスによって既存の記録と照合されます。
- **予約内容を確認する。** AIは顧客に、自身の今後のTrafft予約について伝えることができます。
- **キャンセルする。** 「急用ができたので木曜日の予約をキャンセルできますか？」といったメッセージ一つで、Trafftカレンダーから予約が削除されます。
- **予約を変更する。** AIはまず新しい時間を予約してから古い予約を削除するため、新しい時間が埋まっていた場合でも、顧客は元の予約枠を保持できます。

この方法で行われたすべての予約は、プロバイダーとしてTrafftが表示された状態で**予約**ページにも表示されるため、他の予約と同様にカウントされます。**予約完了**[Webhook](webhooks.md)が実行され、新規予約をトリガーとする自動化も通常通り動作します。Trafft自体が送信するリマインダーや確認メールは、貴社のTrafftウェブサイトで行われた予約と同様に、Trafftから送信されます。

---

## 後からサービスを追加・変更する

Trafftでサービスを追加したり、価格を変更したり、サービスを終了したり、新しいスタッフを迎え入れたりしても、ここで何かを切り替える必要はありません。AIは**すべての予約の会話において、Trafftのカタログをリアルタイムで読み取ります**。そのため、接続時にコピーしたデータではなく、その瞬間のTrafftの情報に基づいて動作します。今朝追加したサービスは、今日の午後には予約可能です。

以下の2点を知っておくと便利です。

- **接続行のカウントは、接続時のものです。** **予約とカレンダー**ページのTrafft行に表示されるサービス数やスタッフ数は、認証情報を確認した時点で見つかったものです。そのため、Trafftのメニューが増えても自動的には更新されません。その行の**更新**をクリックすると、再度読み込まれます。更新されるのはその数値のみで、AIはどちらの場合でも常に最新のカタログを読み取っています。
- **アシスタントがサービスが存在しないと言った場合は、サービスの一覧を表示するように指示してください。** そうすることで、カタログを再取得し、最新のリストに基づいて回答します。それでもサービスが表示されない場合は、接続したTrafftアカウントに実際に存在しない可能性があります。正しいアカウントに接続されているか確認してください（行のカウントが最も素早い判断材料になります）。

---

## 知っておくべきこと

- **キャンセルを行うと、Trafft上の予約が削除されます。** TrafftのAPIは予約を「キャンセル済み」とマークするのではなく削除するため、チャットからキャンセルされた予約は、Trafftカレンダー上に「キャンセル済み」の行を残しません。キャンセルの記録を残しておきたい場合は、別の場所にメモしてください。
- **AIは自身の担当範囲内でのみ動作します。** AIが参照・変更できるのは、その会話内で予約されたもの、または対話中の連絡先に紐付く予約のみです。他の人の予約を読み取ったり移動したりすることはできません。
- **予約にはメールアドレスと名前が必要です。** Trafftはメールアドレスで顧客を識別するため、AIは予約の確定前に不足している情報を尋ねます。
- **グループ予約はまだサポートされていません。** 1予約につき1名までです。現時点では、追加のゲストや人数をTrafftに送信することはできません。
- **支払いはTrafft内で行われます。** AIは価格を提示しますが、支払いを受け付けることはなく、支払いリンクを送信することもできません。TrafftのAPIは請求書や支払いリンクを公開していないため、AIが取得できる情報はありません。サービスの前払いやデポジットが必要な場合は、Trafftでオンライン決済方法を有効にし、Trafftの支払いリンクプレースホルダー（「メール/SMS通知設定」→「**予約**」ドロップダウン）を「**予約承認**」通知に追加してください。AIが予約を作成するたびにTrafftから送信される確認メールに、全額またはデポジットの支払いリンクが含まれます。予約自体は支払いステップなしで作成されるため、支払いの有無にかかわらず承認されます。チャット内で直接リンクを送信したい場合は、独自の支払いリンク（Stripe、PayPal、その他の決済ページ）をエージェントのナレッジベースや指示に追加し、送信タイミングを明記してください。そうすれば、顧客が支払う必要がある際にAIがリンクを共有します。
- **1つの<span data-t="appName">Your AI Connector</span>アカウントにつき1つのTrafftアカウント。** 複数のビジネスを別々のTrafftアカウントで運営している場合は、エージェントが予約を行う対象のアカウントを接続してください。
- **ホワイトラベルのTrafftアカウントも同様に動作します。** アドレスが`.admin.wlbookings.com`で終わるアカウント（Trafftのホワイトラベルプラン）も、標準アカウントと全く同じ手順で接続できます。会社のアドレスとして完全なアドレスを貼り付けてください。クライアントIDとクライアントシークレットは、そのアカウント自身の**機能と統合 → APIとコネクタ**ページから取得するため、TrafftプランでAPIアクセスが有効になっている必要があります。

---

## 次のステップ

- [AIエージェント](../ai-agents/ai-agents.md) — 予約を受け付けるエージェントを設定します。
- [予約システム](../appointments/booking-system.md) — アプリ全体で予約がどのように機能し、どこに表示されるかを説明します。
- [ナレッジベース](../ai-automation/faq-management.md) — 料金、ポリシー、駐車場、キャンセル規定を追加して、AIが予約に関する質問にも答えられるようにします。
