# 連携の設定

> 会話中に AI が使うカレンダー・顧客台帳と、会話後の通知先（Slack・Teams など）を管理画面でつなぐ手順。テナントごとの連携と、ほかの会社の API との連携も扱います。

Source: https://voicast.jp/docs/dashboard-connections

左のメニューの［連携］で、この環境のすべてのテナントで使う連携を設定します。連携の操作は、開発者以上のロールで行います。使える連携先と、それぞれの操作の詳しい内容は[連携](https://voicast.jp/docs/connectors.md)を参照してください。

連携先は［予約・予定］［顧客台帳］［通知］に分かれて並びます。

## 連携する

1. ［連携］で、連携先のカードの［連携］を押します。
2. 連携先によって、次のどちらかを行います。
   - ログインする連携先（Google カレンダー・Google スプレッドシート・kintone など）: kintone のサブドメインなど求められた項目を入力し、［〇〇にログイン］を押して、連携先の画面で許可します。許可すると管理画面に戻ります。
   - URL やキーを貼る連携先（Slack・Microsoft Teams・Chatwork）: 連携先で発行した URL やトークンを貼り付けて［確認して保存］を押します。保存の前に、テストの通知の送信やアカウントの確認を行います。
3. 使い方を選びます（カレンダー・台帳のシートと列・通知を送るルームなど）。
4. ［保存］を押します。

連携が済むと、カードに「連携済み」と出ます。会話中に使うには、[エージェント](https://voicast.jp/docs/dashboard-agents.md)の［連携］で、使う連携先と操作を選んで保存します。通知の連携先は、会話後に要約を送ります（会話中に使う操作はありません）。

Google カレンダー・Microsoft 365 のカレンダーでは、使い方の選択で次のものを決めます。

| 項目 | 内容 |
| --- | --- |
| カレンダー | AI が予定を入れるカレンダー |
| 1 件の予約の長さ・予約の前後に空ける時間 | 空き時間を探すときの長さ |
| 受付時間 | 曜日ごとに 15 分単位。1 日 4 つまで。［平日にコピー］で月曜日の時間を火曜日〜金曜日に写せます。祝日は判別しないため、休みの日はカレンダーに予定を入れます |
| 予定のタイトル | `{name}` は予約した人の名前に置き換わります。病名などは書かないでください |

## 連携の状態

| 表示 | 意味 | カードのボタン |
| --- | --- | --- |
| 連携済み | 使える状態 | ［設定］ |
| 設定待ち | 使い方の選択が済んでいない | ［設定］ |
| 再ログインが必要 | 連携先の許可が切れた | ［再連携］ |

## 連携を解除する

1. 連携先のカードの［設定］を押します。
2. ［連携を解除］を押し、確認の画面でもう一度［連携を解除］を押します。

解除すると、会話中の AI と会話後の通知でこの連携を使えなくなります。連携先のアクセストークンも取り消します。

## テナントごとに連携する

お店や会社ごとに別のカレンダーなどを使うときは、テナント専用の連携をつなぎます。テナント専用の連携があればそれを使い、無ければ環境の連携を使います。

1. ［テナント］の一覧で、テナントの［編集］を押します。
2. ［連携］の［設定用のリンクを発行］を押します。
3. 表示されたリンクをコピーして、お店や会社の担当者に渡します（15 分間有効）。

担当者がリンクを開いて連携すると、編集の画面の［連携］に並びます。リンクを自社サービスの画面に埋め込む方法は、[連携](https://voicast.jp/docs/connectors.md#埋め込みの連携の画面)を参照してください。

テナント専用の連携を解除するには、編集の画面の［連携］で、その連携の［解除］を押し、確認の表示で［連携を解除］を押します。解除すると、そのテナントでは環境の連携を使います（環境で連携していない連携先は使えなくなります）。連携先のアクセストークンも取り消します。

## ほかの会社の API と連携する

ほかの会社の API を、AI が会話中に使うツールにできます（開発者向け）。

1. ［連携］の［カスタム］で［＋ API と連携］を押します。
2. 連携の方法で［URL と API キー］を選びます。
3. API の URL・API キーを付けるヘッダー（API キーが要らないときは［認証なし］）・API キーを入力して［保存］を押します。
4. 呼び出すツール（ツール名・説明・メソッド・パス・必須の引数・任意の引数）を設定して［保存］を押します。

使うかどうかは、エージェントの［連携］で選びます。自社の API を呼ぶときは、[ツールの設定](https://voicast.jp/docs/dashboard-agent-tools.md)を使います。
