10分で自分の手でクラウド内のIP PBX

Habrの読者の多くは、マンゴー、オクテル、オクトレインなど、クラウド内の最新のIP PBXに精通しています。 それらはすべて、さまざまな顧客を満足させ、要件を満たすためにさまざまな機能と料金プランを提供していますが、とにかくアスタリスクを選択する人は常に多くいます。なぜなら、アスタリスクとは別に、提供できるシステムがほとんどないカスタマイズおよび統合機能が必要だからです。 アスタリスク自体に加えて、すべてを構成してサポートできる人、SIPまたはVoIPゲートウェイを介したサービスプロバイダーへの個別の接続などが必要になります。 VoxImplant通信アプリケーションを開発するためのクラウドベースのプラットフォームを作成し始めたとき、もちろん、IP PBXがその使用のための最も一般的なシナリオの1つであることを知っていたため、これに必要なすべての機能を実現しました。 アスタリスクの場合とは異なり、VoxImplantに基づいてIP PBXを作成することを決定した人は、Javascriptの知識、この記事に精通し、PBXの最初の作業バージョンを取得するのに10〜15分しか必要ありません。サービスを使用して、要件に従ってカスタマイズします。 カットの下でこれについての詳細。

まず、PBXのアーキテクチャと機能を決定します。この記事では、オフィスでテレフォニーを整理するのに適した基本バージョンを検討します。必要に応じて、スクリプトを要件に従ってカスタマイズできますが、それについては後で詳しく説明します。 次のスキームに従って電話交換を構築します。

PBXユーザーはお互いに電話をかけたり、実際の電話番号に電話をかけたりすることができます。ユーザー（オペレーター）の別のグループは、通常の電話（詳細は後述）またはSIPを介してPBXに着信する着信も受信できます。必要に応じて友達。 SIP電話-SIP、Web SDK / Mobile SDK-VoxImplantの適切なSDKを使用して作成されたブラウザまたはスマートフォン用のクライアントアプリケーションをサポートするソフトフォンまたはアイロン電話。

したがって、IP PBXを作成するには、無料のVoxImplant開発者アカウントが必要です。これはhttps://voximplant.com/sign-upから取得できます。
アカウントを作成して有効にした後、コントロールパネルhttps://manage.voximplant.com/にアクセスして 、主に今後のすべての作業を行います。 最初に、PBXのユーザーとオペレーターに対応するユーザー（ユーザー）を作成する必要があります。ユーザーを作成するとき、ユーザーが別の個人アカウントVoxImplant（別個のアカウント残高）を持っているか、彼の呼び出しがアカウントの一般アカウントから差し引かれるかを選択できますデフォルト）-何も変更していませんが、デフォルトで変更します。 重要：ログイン/ユーザー名（101、102、103など）には3桁の数字コードを使用します。スクリプトでは、この形式から進めます。 これで、PBX機能の作成に直接進むことができます。VoxImplantサーバーアプリケーションは、プラットフォームを通過するコールを処理するための一連のシナリオです。 これらのスクリプトは通常のJavascriptで記述されており、VoxImplant関数を操作するためにいくつかの名前空間とクラスを使用できます（詳細についてはリンクを参照してください ）。 スクリプトは、「シナリオ」セクションで作成および編集されます。 合計で、着信、発信、およびユーザー間の通話の3種類の通話処理シナリオがあります。それぞれ、PBX入力、PBX出力、およびPBXローカルと呼びます。 最も単純なPBXローカルから始めましょう。

VoxEngine.forwardCallToUser(); 

「これだけですか？」とあなたは尋ねます:)はい、それだけです。なぜなら、 forwardCallToUserは、アプリケーションの作成を高速化し、促進するために作成したヘルパー関数の1つだからです。 実際、この関数の背後にはJavaコードの一部があります：

 VoxEngine.addEventListener(AppEvents.CallAlerting, function(e) { var newCall = this.callUser(e.destination, e.callerid, e.displayName); VoxEngine.easyProcess(e.call, newCall); }); 

easyProcessがもう1つのヘルパー関数である場合、VoxEngineのドキュメントですべての関数の詳細情報を見つけることができます。現在VoxImplantを勉強する必要はないので、詳細に進むことなく続行します。 次のスクリプト（PBX out）は、通常の電話番号に発信呼び出しを送信します。

 VoxEngine.addEventListener(AppEvents.CallAlerting, function (e) { var call2 = VoxEngine.callPSTN(e.destination.substring(1), "74957893798"); VoxEngine.easyProcess(e.call, call2); }); 

このコードでは、 callPSTN関数を使用して、発信者ID-74957893798を示す電話ネットワークに通話をリダイレクトします。発信者IDが発信中であることを示すように、設定->発信者IDセクションで事前認証する必要があります 最初のパラメーターでは、1桁のプレフィックスを破棄します（後でスクリプトをアプリケーションにバインドするときにこの桁を構成します）。これは、PSTNでコールを逃す必要があることを通知します。つまり、番号が974952200022と入力されます。数。 ここでも、すべてが非常に単純であるため、最も興味深いシナリオに移ります。着信コール（PBXを処理する）を処理するために、部分に「肉」を追加して、より明確にします。

 //    var callerid, displayName; //          AppEvents.CallAlerting VoxEngine.addEventListener(AppEvents.CallAlerting, function(e) { //  Caller ID callerid = e.callerid; //  displayName -   SIP displayName = e.displayName; //     (     ) e.call.handleTones(true); //       ,        e.call.answer(); }); 

プラットフォームへの接続を許可しました。今度は呼び出し処理を行う必要があります。前のリスナー内で呼び出し接続イベント処理を追加します。

 //     ,         var GMT_offset = 4, workingHours = [ [0, 0], // Sun [10, 19], // Mon [10, 19], // Tue [10, 19], // Wed [10, 19], // Thu [10, 19], // Fri [0, 0] // Sat ], nonWorkingHours = false, workingHoursGreetingURL = 'http://yourdomain.com/ivr.mp3', //<===    URL  MP3-  ( ) nonWorkingHoursGreetingURL = 'http://yourdomain.com/ivr_nwh.mp3'; //<===    URL  MP3-  ( ) e.call.addEventListener(CallEvents.Connected, function(e) { // . /   ,   GMT_offset (GMT+4  ) var d = new Date(new Date().getTime() + GMT_offset * 3600 * 1000), day = d.getUTCDay(), hour = d.getUTCHours(); Logger.write("Day: " + day + " Hour: " + hour); if (hour >= workingHours[day][0] && hour < workingHours[day][1]) { /** *     *    */ e.call.startPlayback(workingHoursGreetingURL, false); e.call.record(); } else { /** *     *    */ nonWorkingHours = true; e.call.startPlayback(nonWorkingHoursGreetingURL, false); } }); 

呼び出しを接続するためにハンドラーをハングアップしましたが、切断するにはハンドラーをハングアップする必要があります。

 e.call.addEventListener(CallEvents.Disconnected, function(e) { //   VoxEngine.terminate(); }); 

そして、グリーティングの再生を完了するためのハンドラー：

 //          var TIMEOUT = 3000, operatorTimer; e.call.addEventListener(CallEvents.PlaybackFinished, function(e) { //      ,   -    ,      if (!nonWorkingHours) { operatorTimer = setTimeout(function() { forwardCallToOperator(e.call); }, TIMEOUT); } else VoxEngine.terminate(); //      -    }); 

おそらくforwardCallToOperator関数に気付いたでしょう。電話でボタンを押して内線番号を入力する処理を有効にしたらすぐに、この関数に戻ります。 前に、e.call.handleTones（true）を呼び出してハンドラーを既に有効にしていたので、宣言する必要があります。

 //      var input = ''; e.call.addEventListener(CallEvents.ToneReceived, function(e) { //        e.call.stopPlayback(); //    input += e.tone; if (input.length == 3) { //        3        forwardCallToExtension(e.call, input); } }); 

さて、次は最も興味深い関数、forwardCallToExtensionとforwardCallToOperatorの時間です。

 var operators = ['101', '102', '103'], // <==    ,    -    operatorCalls = {}, nOperatorCalls = 0, activeOperatorCall; function forwardCallToExtension(call, ext) { clearTimeout(operatorTimer); //       call.handleTones(false); //   (     ) call.playProgressTone("RU"); //  ,     var call2 = VoxEngine.callUser(ext, callerid, displayName); //   call2.addEventListener(CallEvents.Failed, VoxEngine.terminate); call2.addEventListener(CallEvents.Connected, function(e) { //   -      VoxEngine.sendMediaBetween(call, call2); }); call2.addEventListener(CallEvents.Disconnected, VoxEngine.terminate); } function forwardCallToOperator(call) { //       call.handleTones(false); nOperatorCalls = 0; //   (     ) call.playProgressTone("RU"); //      ,    ,  . for (var i in operators) { var j = operators[i]; nOperatorCalls++; operatorCalls[j] = VoxEngine.callUser(j, callerid, displayName); operatorCalls[j].addEventListener(CallEvents.Failed, function(e) { if (typeof activeOperatorCall == "undefined") { delete operatorCalls[e.call.number()]; nOperatorCalls--; if (nOperatorCalls == 0) { call.hangup(); } } }); operatorCalls[j].addEventListener(CallEvents.Connected, function(e) { delete operatorCalls[e.call.number()]; activeOperatorCall = e.call; VoxEngine.sendMediaBetween(call, e.call); activeOperatorCall.addEventListener(CallEvents.Disconnected, VoxEngine.terminate); for (var i in operatorCalls) { operatorCalls[i].hangup(); } operatorCalls = {}; }); } } 

すべての準備が整ったので、パーツを組み合わせて完全なスクリプトを取得します 。 残っているのは、VoxImplantアプリケーションを作成し、ユーザーとスクリプトを接続することだけです。 これは、次の簡単な方法で行われます。
1.「アプリケーション」セクションで、アプリケーションを作成し、名前を付けて、それを使用できるユーザーを指定します。

2.アプリケーションを作成したら、すぐに編集を選択します
3. [ルール]タブで、[ルールの追加]ボタンを使用して、ローカル、アウト、インの3つの新しいルールを作成します。
ユーザーの名前を101、102、103などの形式で指定した場合、ローカルルールを作成するとき パターンフィールドで1 [0-9] {2}を指定し、ドラッグアンドドロップを使用して、PBXローカルスクリプトをAvailableからAssignedにドラッグして、PBXに接続しているユーザーが内部番号を呼び出す場合に呼び出すスクリプトを割り当てます。同僚。 保存します。
同様に、[パターン]フィールドの出力ルールに対して、9 [0-9] +（callPSTNメソッドのe.destination.substring（1）で見た同じ9を思い出してください）を指定し、PBX outスクリプトをAssignedにドラッグします。 保存します。
最後のルール：パターンでは、スピリットに何かを指定し（74957893798 | 100）、PBXを割り当て済みにドラッグします。 保存します。 74957893798は単なる例です。電話番号セクションでアプリケーションに接続できる電話番号が必要です。 また、100を使用すると、sip：100@appname.accountname.voximplant.comという形式のURLを使用して、SIPを介してPBXを呼び出すことができます。appnameは作成時に指定したアプリケーションの名前で、accountnameは指定したVoxImplantアカウントの名前です登録時に。 SIP転送をサポートする購入済みの番号を既にお持ちの場合は、たとえば、経由で着信呼び出し用に作成したSIP URI（sip：100@appname.accountname.voximplant.com）に呼び出しを送信することにより、PBXに接続できます。一口

4.アプリケーションを保存します。

これで、PBXは、SIP電話（またはVoxImplant SDKに基づくクライアントアプリケーション）の接続、コールの受信と処理、PBXユーザー間のローカルコール、および実番号への発信の準備ができました。

PSこの記事の既製のスクリプトはGitHub https://github.com/voximplant/pbxに投稿されています 。 VoxImplant Web SDKに基づく既製のWeb電話は、 http： //webphone.voximplant.com/？account = accountname＆app = appnameにあります。accountnameとappnameを自分の名前に置き換えることを忘れないでください。 多かれ少なかれ正気なSIPソフトフォンが必要な場合、X-lite / Briaをキャンセルした人はいません。