ページの一覧

ドキュメント

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

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

Markdown で見る

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

テナントを作成する#

  1. [テナント]で[+ テナントを作成]を押します。
  2. 次の項目を入力して、[作成]を押します。
  3. 表示された接続シークレットを[コピー]して、安全な場所に保管します。
項目 内容
お客様 ID(必須) 自社サービスでのお客様の ID(API では external_id)。半角英数字と . _ : - で 100 文字以内。作成後は変更できません
名前 お店や会社の名前。一覧と会話記録に表示されます
エージェント このテナントに電話がかかったときに使うエージェント。常に最新のバージョンを使います

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

テナントを編集する#

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

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

  • テナント専用の連携の確認と解除、設定用のリンクの発行(連携)
  • SIP の接続情報の追加・変更・削除(電話番号と SIP)

読み方を登録する#

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

  1. 編集の画面の[読み方]で[+ 読み方を追加]を押します。
  2. 書き方(例: 医療法人社団 東壽会)と、読み(ひらがなかカタカナ。例: いりょうほうじんしゃだん とうじゅかい)を入力して、[保存]を押します。
項目 内容
書き方 100 文字以内。同じ書き方は 1 つだけ
読み ひらがなかカタカナ(ー・空白・読点を含めて 100 文字以内)

20 個まで登録できます。エージェントの読み方(エージェント)と同じ書き方は、テナントの読み方が優先されます。変更は次の会話から使われます。

会話を止める#

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

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

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

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

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

テナントを削除する#

  1. 編集の画面の左下の[削除]を押します。
  2. 確認の画面で[削除]を押します。
  • このテナントの接続シークレットでは、すぐに会話を受けられなくなります。SIP の接続情報も削除されます。
  • これまでの会話記録は残ります。
  • 同じお客様 ID で、もう一度作成できます。