目的	ソフトフォンの設定値を管理画面に取り込み、一元管理することを目的としています。 取得した設定値は管理画面「ソフトフォン設定配信」メニューより、他のソフトフォンへ一括配信することが可能です。 「ソフトフォン設定値取得」と「ソフトフォン設定配信」を組み合わせて活用することで、組織間におけるソフトフォン設定内容の統一や、ソフトフォン設定作業の効率化に役立ちます。
対象プラン
用語	【ソフトフォン】 物理的な電話機を利用せず、PCの画面上でインストールし操作する通話アプリケーションです。 発信、着信、保留、パーク保留、ピック、転送、三者通話、手上げ、発着信履歴、電話帳機能などが利用できます。
ポイント	・本機能は、BIZTELバージョン 3.13.0 以降のバージョンをご利用のお客様の標準機能です。

目次

1. ソフトフォン設定値取得とは

2. 前提条件

2.1 ソフトフォン設定値取得の操作権限

2.2 設定値を取得可能なサーバ・ソフトフォンの条件

2.3 設定値取得対象のソフトフォン設定

3. ソフトフォン設定値の取得手順

4. 取得した設定を他のソフトフォンへ配信する

5. 設定取得時のエラーと対処

1. ソフトフォン設定値取得とは

ソフトフォン設定値取得とは、あらかじめソフトフォンに設定された一部内容を取得し、管理画面に設定値として取り込む機能です。
取得した設定値は、「ソフトフォン設定配信」メニューより他のソフトフォンに同じ設定を配信できます。

※ソフトフォン（WebRTC）、ハードフォン、モバイル端末は本機能の対象外です。

2. 前提条件

ソフトフォン設定値取得を利用するにあたり必要な条件を紹介します。

2.1 ソフトフォン設定配信の操作権限

・ソフトフォン設定値取得は、「リソース権限が初期状態の（権限設定可能なすべてのリソースが「参照・編集・削除」）システム管理者ロール」の管理画面でのみ設定可能です。

※リソース権限の設定や初期状態については、「2.権限（ロールとリソース）の設定（3.12.X以降）」をご参照ください。
※ソフトフォン側でサインインするアカウントの権限に対しての制限はありません。

2.2 設定値を取得可能なサーバ・ソフトフォンの条件

バージョンに関する条件

・ソフトフォンから設定値を取得できるのは、BIZTELサーバのバージョンが「3.13.0」、かつソフトフォンのバージョンが「3.13.7」以上の場合です。
BIZTELサーバがバージョン 3.13.0 以上でも、ソフトフォンのバージョンが古いと設定値の取得が行えません。

管理画面のバージョン確認手順

「システム設定」 > 「ライセンス設定」 > 「システム」 > 「バージョン」欄に、ご利用のバージョンが記載されています。

ソフトフォンのバージョン確認手順

ソフトフォンを右クリックし、「バージョン情報」を選択するとご利用のバージョンが表示されます。

ご利用のサーバに関する条件

・設定値の取得操作を行う管理画面と、取得元のソフトフォンのサーバは必ず同じものを利用してください。
管理画面のURLと、ソフトフォン設定「ネットワーク」 > 「BIZTELサーバアドレス」のURLそれぞれに記載されている値が一致していることを必ず確認してください。

ご利用サーバの確認手順

設定を行うPC環境に関する条件

・他のPCや、リモートデスクトップ環境にインストールされたソフトフォンの設定値は取得できません。
取得元のソフトフォンを起動しているPCと同じPC内でBIZTEL管理画面を開き、設定値の取得を行ってください。

ソフトフォン設定配信機能に関する条件

・「ソフトフォン設定配信」により制御が行われているソフトフォンの設定値は取得できません。

ソフトフォン設定配信による制御の確認手順

ソフトフォン右上のインフォメーションアイコンにカーソルを合わせ、「管理者により一部設定が制御されています。」のメッセージが表示される場合、ソフトフォン設定配信による制御が行われています。

管理画面「共通設定」 > 「ソフトフォン設定配信」メニューより、以下どちらかの操作で一時的に設定配信を無効化してください。
無効化後、ソフトフォンを起動してから再度設定値取得を行っててください。
※「ソフトフォン設定配信」メニューの詳細は、「1.ソフトフォン設定配信（バージョン 3.12.10 以降）」をご参照ください。

※設定配信を無効化しソフトフォンを再起動すると、ソフトフォンは配信前の設定に戻ります。
必ずソフトフォンの設定内容が正しいか確認してから設定値取得を行ってください。

・設定配信のステータスを無効化

・「配信先選択」タブから、対象のアカウントまたは内線番号のチェックを外す

・ソフトフォンを右クリックし再起動

2.3 設定値取得対象のソフトフォン設定

「ソフトフォン設定値取得」メニューで行える設定値の取得、ならびに「ソフトフォン設定配信」からの配信設定が可能な設定は以下のとおりです。
各設定の詳細は「2.「ソフトフォン」メニューの設定（BIZTELバージョン 3.3.X 以降」をご参照ください。

※オプション契約がない機能はご利用対象外です。ご契約情報をご確認ください。

※以下のメニューは設定値取得・配信対象外のため、ソフトフォン側で個別に設定を行ってください。

・ソフトフォン設定 > 「電話帳管理」メニュー
・ソフトフォン設定 > 「自動応答機能」メニュー
・ソフトフォン設定 > 「オーディオ」メニュー
・ソフトフォン設定 > 「着信音」メニュー

「ソフトフォン設定」メニューで取得・配信可能な項目

・「基本設定」 > 「ショートカットキーの設定」のチェック有無

・「電話機能」メニューの全項目

・「三者通話機能」メニューの全項目

・「表示設定」 > 「番号リストを電話帳の名前で表示する」「番号リストをソートして表示する」チェックの有無

※ソフトフォン上で表示対象とする番号・窓口リスト（以下画像青色の項目）は、管理画面「ソフトフォン配信設定」メニューで表示対象番号または窓口の選択・配信制御が可能です。
詳細は「1.ソフトフォン設定配信（バージョン 3.12.10 以降）」をご参照ください。

・「ネットワーク設定」 > 「DRサーバホスト名」「SIPログの出力方式」以外の全項目

「エージェント設定メニューで取得・配信可能な項目

・「基本設定」 > 「ソフトフォン終了時にステータスをログオフにする」のチェック有無

「CTI設定」メニューで取得・配信可能な項目

・基本設定 > 「着信通知の設定を行います。」以下の全項目

※CTI連携対象番号の選択は、管理画面「ソフトフォン配信設定」メニューで連携対象番号の選択・配信制御が可能です。
詳細は「1.ソフトフォン設定配信（バージョン 3.12.10 以降）」をご参照ください。

・「CRM選択」メニューの、認証情報に関連の項目を除く全項目

※「CRM選択」メニューで取得対象外の項目

「ログインID」
「サンドボックス環境にログインする」のチェック有無
「認証アクセス」
「認証レスポンスフォーマット」

・「動作設定」メニューの全項目

「その他設定」メニューで取得・配信可能な項目

・「特殊設定」メニューの全項目

3. ソフトフォン設定値の取得手順

「ソフトフォン設定値取得」メニューからソフトフォンの設定値を取得し、管理画面に取り込む手順を紹介します。

ソフトフォンの事前設定

「ソフトフォン設定値取得」メニューを操作する前に、あらかじめソフトフォン上で取得したい各種設定を行ってください。
ソフトフォン設定の詳細は、「2.「ソフトフォン」メニューの設定（BIZTELバージョン 3.3.X 以降）」をご参照ください。

管理画面の操作手順

手順１．管理画面より「共通設定」 > 「ソフトフォン設定値取得」 をクリックします。

手順２．「新規」をクリックします。

手順３．必要事項を入力し、「保存」をクリックします。

手順４．「保存しますか？」と表示後、「OK」をクリックします。

手順５．「設定値取得」タブをクリックします。

手順６．管理画面を開いているPCと同じ端末上で、設定取得元のソフトフォンが以下の状態であることを確認します。

・ソフトフォン側の設定メニュー画面が閉じられていること
・ソフトフォンで通話を行っていないこと

手順７．「設定値を取得」ボタンをクリックします。

手順８．（すでに設定値が登録されている場合のみ）「上書きしますか？」と表示されるので、「OK」をクリックします。

手順９－１．（Windows版をご利用の場合）「SoftphoneStart.exe を開きますか？」とポップアップが表示される場合は「SoftphoneStart.exe を開く」 をクリックします。

手順９－２．（Windows版をご利用の場合）「アプリの選択 を開きますか？」とポップアップが表示される場合は「アプリの選択 を開く」 をクリックし、次のポップアップ画面でソフトフォンのアイコンと「常に使う」を選択します。

※「URL:callto を開きますか？」とポップアップが表示される場合、同じPC上にソフトフォンがインストールされていないため設定値取得が行えません。
取得対象のソフトフォンをインストールしているPC上で管理画面を開いて操作を行うか、同じPCにソフトフォンをインストール・初期設定のうえ「ソフトフォンの事前設定」を行ってください。
設定値の取得条件は、「2.2 設定値を取得可能なサーバ・ソフトフォンの条件」をご確認ください。

手順10．「ご利用中のソフトフォンから設定値を取得します」とメッセージが表示されるので、「OK」をクリックします。

手順11．「設定値の送信が完了しました」と表示されるので、「OK」をクリックします。

※このポップアップが表示されない場合、ソフトフォンから設定値の取得が行えていません。
手順６に記載の該当項目がないかソフトフォンの状態を確認し、再度「設定値を取得」ボタンをクリックしてください。

手順12．画面中央または右上の「更新」ボタンをクリックし、画面をリロードします。
※管理画面は自動更新されないため、必ず手動で更新を行ってください。

手順13．「取得元ソフトフォンの内線番号」「取得元ソフトフォンのバージョン」「ソフトフォンから取得した設定値」が表示されたら取得完了です。

取得した設定値における注意事項

※取得した設定値は、管理画面上で変更・編集できません。
設定値を変更したい場合、設定を変更したソフトフォンから再度取得を行ってください。

※設定値の取得対象外となる項目は、「ソフトフォンから取得した設定値」一覧に表示されません。

※オプション契約の有無にかかわらず「2.3 設定値取得対象のソフトフォン設定」に記載の設定項目がすべて表示されますが、オプション契約がない場合は引き続き機能としてご利用いただけません。

例）「CRM連携オプション」のご契約がない場合
設定値を取得すると「CTI設定」メニューの設定値が「ソフトフォンから取得した設定値」として表示されますが、この設定値を配信してもCRM連携オプションの機能はご利用いただけません。

4. 取得した設定を他のソフトフォンへ配信する

取得したソフトフォン設定は、「ソフトフォン設定配信」メニューから他のソフトフォンへ配信し、同じ設定となるよう制御可能です。
設定配信の手順は、「1.ソフトフォン設定配信（バージョン 3.12.10 以降）」をご参照ください。

5. 設定取得時のエラーと対処

「設定値を取得」ボタンをクリック後にエラーメッセージが表示される場合は、以下の内容に従ってご確認ください。

「ソフトフォン配信設定が適用されているため、設定値を送信できません」

取得元ソフトフォンに設定配信が適用されている場合に表示されます。
「ソフトフォン設定配信機能に関する条件」に従って、設定配信を無効化してください。

ソフトフォンの接続先サーバが異なるため、設定値を送信できません

「ソフトフォンが接続しているサーバ」と、「設定値取得を行った管理画面のサーバ」が異なる場合に表示されます。
「ご利用のサーバに関する条件」に従って、ソフトフォンの設定内容を確認してください。

「認証に失敗したか、権限がありません
設定を確認し、再起動してください」

「設定値を取得」ボタンをクリック後、第三者の操作などにより管理画面にログインしているシステム管理者アカウントの権限が変更された場合に表示されます。
他のシステム管理者アカウントで管理画面にログインし、設定値取得を行うアカウントのリソース権限を「すべて参照・編集・削除」に復元のうえ、設定値の再取得を行ってください。

「BIZTELサーバに接続できません」

「設定値を取得」ボタンをクリック後、第三者の操作などにより操作していた「設定値取得」が削除された場合に表示されます。
「3. ソフトフォン設定値の取得手順」に従って、ソフトフォン設定値取得を再度作成してください。
※一度削除された設定は、弊社作業含め設定の復元はできません。