概要
Rockは、さまざまな
電話システムとの通信を可能にするプラグインに対応しています。この特定のプラグインにより、Rockは
Switchvox電話システムと情報をやり取りできるほか、クリック・トゥ・コール機能も利用できるようになります。
SWITCHVOXの設定
統合の設定を行う前に、
Switchvox環境が正しく設定されていることを確認してください。
接続性を確保する
まず最初に、SwitchvoxサーバーとRockサーバーの間に
接続が確立されていることを確認してください。両者が同じ
ネットワーク上にある場合は問題ありません！そうでない場合は、Switchvox内で
アクセス制御ルールを設定する必要があるかもしれません。この手順の詳細については、
本ドキュメントの範囲外となります。必要に応じて、ネットワーク管理者にご相談ください。
また、連携機能で使用するためのSwitchvoxユーザーを作成・設定する必要があります。
デフォルトの管理者アカウントを使用することも可能です。
新しいアカウントを使用する場合は、そのアカウントに
実行に必要な適切な権限が与えられていることを確認してください。以下のスクリーンショットは、このユーザーが
持つべき最低限の権限を示しています。
注記
具体的な設定は、Switchvoxの
バージョンによって異なる場合があります。詳細については、Switchvoxのドキュメントをご参照ください。
プラグインの設定
プラグインのインストールが完了したら、「管理ツール >
システム設定 > 電話システム」をクリックしてください。リストにSwitchvoxプラグインが
表示されるはずです。設定の編集をクリックする前に、まずプラグインの
セキュリティ設定を調整することをお勧めします。「表示」アクションは、
クリックして通話リンクを表示したり、通話を発信したりできるユーザーを決定します。デフォルトでは、
「RSR – スタッフ」ロールに対してこの機能が有効になっています。ただし、このセキュリティ設定を
調整した方が良い場合もあります。
セキュリティの設定が完了しましたので、
Switchvoxの設定の詳細に進むことができます。
- Rockでこのプロバイダーが利用できるようになるよう、必ず有効化してください。
- Switchvox サーバーのベース URL を指定してください（例：https://switchbox.rocksolidchurchdemo.com）
- API呼び出しに使用するSwitchvoxのユーザー名とパスワードを入力してください。
- 次に、発信ルールを設定することができます。これらのルールは、Switchvoxに送信して発信する前に、電話番号の形式を整えるのに役立ちます。例えば、次のような設定が必要になる場合があります：
- オフィスの電話番号全体（例：(602) 555-5534）を、内線番号（5534）のみに変換してください。
- 長距離通話の場合は、番号の先頭に「1」を付けてください。
- 市内通話の場合は市外局番を省略してください。
このフィールドでは、Lavaでルールを記述できます。
以下に、完全なオフィス番号を内線番号のみに変換するルールの
例を示します。これは、ぜひ参考にしていただきたい一般的なパターンです。
{% assign phonePrefix = PhoneNumber | Slice: 0, 6 -%}
{% if phonePrefix == '319297' -%}
{% assign extension = PhoneNumber | Right:4 | AsInteger -%}
{% if extension > 2339 and extension < 2481 -%}
{{ extension }}
{% else -%}
{{ PhoneNumber }}
{% endif -%}
{% else -%}
{{ PhoneNumber }}
{% endif -%}
5.
「内線番号テンプレート」を使用すると、完全な
電話番号から内線番号を取得することができます。例えば、組織内で (602) 555-3454 という形式の直通電話番号が
使用されており、その末尾の4桁が内線
番号である場合、このテンプレートでそのロジックを定義します。これにより、
内線番号を統一された形式で管理できるようになります。
6.
「発信者IDに組織名を使用する」設定は、クリック・トゥ・コールを使用する際に、
発信者IDにどのテキストを表示するかを決定するのに役立ちます。デフォルトでは、
組織名が使用されます。 ただし、この設定を無効にすると、発信者の名前が
使用されます。これは最も理にかなった方法のように思えるかもしれませんが、クリック・トゥ・コールのリンクをクリックした相手にとっては、発信者番号に自分の名前が表示された状態で電話がかかってくることに、しばしば
戸惑いを覚えることがあります。
7. クリック・トゥ・コールを
開始する際、Switchvox では、通話を承認する内線番号を
渡す必要があります。ほとんどの場合、ログインしているユーザーが誰であるかは
わかっているため、その内線番号を使って Switchvox アカウントを検索できます。しかし、ごくまれに
、そうではない場合もあります。 例えば、2つの外部番号間で通話を開始するためにREST API
呼び出しを行う場合を考えてみましょう。この場合、ここで設定されたデフォルトの内線番号の
アカウントIDを、承認用
内線番号として使用します。この値は、
その内線番号の「アカウントID」でなければなりません。内線番号のアカウントIDは、
「管理ツール > 一般設定 > 定義済みタイプ > Switchvox
内線番号」で確認できます。 この定義済みタイプにデータが
反映されるには、同期を1回実行する必要があります。最初は、この値をランダムな数字（例：「1234」）に
設定し、後で戻ってきて実際の値に更新してください。ただし、後で戻ってくることを
忘れないでください。そうしないと、クリック・トゥ・コールが機能しなくなります。
8. 最後に、
「内部電話タイプ」によって、Rockの電話タイプのうちどれを
内部番号として使用するかが決まります。
その他の設定
同期ジョブ
プラグインのインストールが完了すると、通話詳細記録（CDR）と内線番号リストを同期するためのジョブが追加されます。
設定を変更したい場合は、「管理ツール > システム設定 > ジョブ管理
> Switchvox 同期ジョブ」から行うことができます。このジョブを初めて実行する際は、
電話システム内の過去のすべての CDR 記録をダウンロードしようとするため、
実行に時間がかかる場合があります。
拡張機能一覧
Switchvoxとの連携が稼働し始めると、
内線番号のリストが自動的に作成・同期されます。これらは
「Switchvox Extensions」という定義済みタイプとして保存されます。通常、このリストについて
気にする必要はありません。最新の状態に保たれるよう自動化されています。 ただし、
このリストが存在することを知っておくと役立ちます。なぜなら、ユーザーAに
紐づいているはずの内線番号が、実際には別のユーザーに紐づいているという
ケースに遭遇する可能性があるからです。このような
事態が発生した場合、その原因は、Rock内の両方のユーザーの記録に
同じ内線番号が登録されていることにある可能性が高いです。このリストは、
何が起きているかを確認するための有効なチェック手段となります。
個人の好み
クリック・トゥ・コール機能を利用できる各ユーザーは、
通話開始時に使用する電話番号を指定することができます。
デフォルトでは社内内線番号が使用されますが、
希望に応じて携帯電話や自宅の電話番号に変更することも可能です。この設定は、
社内ページの右上にあるログインステータスのドロップダウンメニューから「マイ設定」
を選択して行うことができます。