# テナントの作成と接続シークレット

> 電話を受けるお店や会社（テナント）を管理画面で作成し、使うエージェントの選択、接続シークレットの再発行、停止と削除を行う手順。

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

テナントは、実際に電話を受けるお店や会社です。自社サービスのお客様 1 社ごとに作成し、使うエージェントを選びます。左のメニューの［テナント］で、今の環境のテナントを一覧できます。作成と変更は、開発者以上のロールで操作します。

## テナントを作成する

1. ［テナント］で［+ テナントを作成］を押します。
2. 次の項目を入力して、［作成］を押します。
3. 表示された接続シークレットを［コピー］して、安全な場所に保管します。

| 項目 | 内容 |
| --- | --- |
| お客様 ID（必須） | 自社サービスでのお客様の ID（API では `external_id`）。半角英数字と `. _ : -` で 100 文字以内。作成後は変更できません |
| 名前 | お店や会社の名前。一覧と会話記録に表示されます |
| エージェント | このテナントに電話がかかったときに使うエージェント。常に最新のバージョンを使います |

接続シークレットは、作成したときに 1 回だけ表示されます。閉じると二度と表示できません。電話や Web の会話を voicast に接続するときに渡す文字列です（電話では `<Parameter name="secret">`。[電話でつなぐ](https://voicast.jp/docs/phone.md)）。

## テナントを編集する

1. ［テナント］の一覧で、テナントの［編集］を押します。
2. 名前・エージェント・状態・読み方を変更して、［保存］を押します。

編集の画面では、ほかに次のことができます。

- テナント専用の連携の確認と解除、設定用のリンクの発行（[連携](https://voicast.jp/docs/dashboard-connections.md#テナントごとに連携する)）
- SIP の接続情報の追加・変更・削除（[電話番号と SIP](https://voicast.jp/docs/dashboard-sip.md)）

## 読み方を登録する

お店や会社の名前など、このテナントの会話だけで使う読み方を登録できます。1 つのエージェントを多くのテナントで使い、あいさつで `{{tenant_name}}` を名乗るときに、名前の読み違いを防ぎます。

1. 編集の画面の［読み方］で［+ 読み方を追加］を押します。
2. 書き方（例: 医療法人社団 東壽会）と、読み（ひらがなかカタカナ。例: いりょうほうじんしゃだん とうじゅかい）を入力して、［保存］を押します。

| 項目 | 内容 |
| --- | --- |
| 書き方 | 100 文字以内。同じ書き方は 1 つだけ |
| 読み | ひらがなかカタカナ（ー・空白・読点を含めて 100 文字以内） |

20 個まで登録できます。エージェントの読み方（[エージェント](https://voicast.jp/docs/dashboard-agents.md)）と同じ書き方は、テナントの読み方が優先されます。変更は次の会話から使われます。

## 会話を止める

編集の画面で［状態］を［停止中］にして［保存］を押すと、このテナントへの会話を受け付けなくなります。［有効］に戻すと、また受け付けます。

## 接続シークレットを再発行する

シークレットが漏れた可能性があるときは再発行します。

1. 編集の画面の左下の［接続シークレットを再発行］を押します。
2. 確認の画面で［接続シークレットを再発行］を押します。
3. 表示された新しいシークレットをコピーします。

古いシークレットも 24 時間は使えます。そのあいだに、自社サービスの設定を新しいシークレットに変更してください。

## テナントを削除する

1. 編集の画面の左下の［削除］を押します。
2. 確認の画面で［削除］を押します。

- このテナントの接続シークレットでは、すぐに会話を受けられなくなります。SIP の接続情報も削除されます。
- これまでの会話記録は残ります。
- 同じお客様 ID で、もう一度作成できます。
