PHP と Vonage Voice API で電話会議を構築する

はじめに

このチュートリアルでは、PHP と Vonage Voice API を使って電話会議アプリケーションを作成する方法を学びます。このチュートリアルでは、PHP と Vonage Voice API を使って電話会議アプリケーションを作成する方法を学びます。最後には、複数の参加者が同じライブ会話に参加できる電話番号を作成します。

Vonageアプリケーションを設定し、コール・コントロール・オブジェクト（NCCO）で着信コールを処理し、シンプルなPHPエンドポイントからダイナミック・レスポンスを返します。このプロジェクトは、チームのミーティング・ライン、イベント・ホットライン、またはコラボレーティブなボイス・エクスペリエンスを構築するための実用的な出発点です。

このチュートリアルの完全なソースコードは Vonage コミュニティ GitHub リポジトリで公開されていますので、そちらを参考にしてください。

前提条件

• PHP8.3以上

• Vonage APIアカウント

Vonage API Account

To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.

Ready to start building?

Experience seamless connectivity, real-time messaging, and crystal-clear voice and video calls—all at your fingertips.

PHPで着信に応答する

この例では、ユーザーがVonageのバーチャル番号に電話をかけ、アプリケーションコードがその着信に応答します。Vonageは、コール・コントロール・オブジェクト、つまり NCCO.

まず、音声合成（TTS）による挨拶があり、次にユーザーが電話会議に参加する。

そのために answer.phpファイルを public/ディレクトリ（私たちのウェブルート）にファイルを追加し、NCCOを返すようにします。NCCOはJSONなので、PHPは適切な Content-Typeヘッダを含める必要がある：

<?php

$ncco = [
    [
        "action" => "talk",
        "text" => "Thank you for joining the call today. You will now be added to the conference.",
        "language" => "en-GB",
        "style" => 0,
        "premium" => true
    ],
    [
        "action" => "conversation",
        "name" => "weekly-team-meeting"
    ]
];

header("Content-Type: application/json");
echo json_encode($ncco);

この $ncco変数は、Vonageのサーバーに着信の処理方法を指示するために返すNCCOを保持する。この例では、ユーザーに挨拶する "talk "アクションの後に、ユーザーを電話会議に追加する "conversation "アクションを記述している。このコードでは header()ヘッダーをPHPに送信させるために Content-TypeヘッダをPHPに送信させ、その後にJSONを送信します。

NCCOで他にどんなことができるのか気になる方は NCCOリファレンス・ドキュメントをご覧ください。

レスポンスに奉仕する

この時点で、アプリケーションの可動部分のテストを開始できます。PHPのWebサーバーを public/ディレクトリから起動します：

cd public/
php -S localhost:8080

にリクエストしたときに、アプリケーションが正しくNCCOを返すかチェックしてください。 http://localhost:8080/answer.phpにリクエストしたときに、アプリケーションがNCCOを正しく返すかどうか確認してください。

コードを公開する

Vonageがあなたのアプリケーションに着信を通知するには、そのアプリケーションに到達できる必要があるので、このコードは一般に公開されていなければならない。サーバーにデプロイするという方法もあるが、開発目的では ngrokを使ってローカルの開発環境を公開する。ウェブサーバーを起動したら（私の場合はポート8080）、ngrokを次のように実行する：

ngrok http 8080

ダッシュボードには、ウェブインターフェースへのリンク（とても便利なのでクリックしてください）、トンネルのhttps URL（これをコピーしてください。

を ngrok https URL に置き換えることができます。 http://localhost:8080をあなたの ngrok https URL に置き換えることができます。 /answer.phpにリクエストしてみてください。

電話番号の設定

Vonage番号の購入

Voice対応Vonageアプリケーションの作成

通話設定を保持し、使用する番号にリンクすることができます。この分離は、異なる地域の番号を同じ電話会議に参加させたい場合に非常に便利です。

Vonageアプリケーションは公開鍵/秘密鍵を使用する。この例では、単に着信を受けるだけなので、今のところ秘密鍵は必要ありません。しかし、作業ディレクトリに private.keyファイルを作業ディレクトリに保存しておくとよいだろう。

アプリケーションを作成するには、名前を付け、いくつかの重要なWebhookエンドポイントを設定する必要があります：

• 回答URLは、すでに作成した answer.phpエンドポイントになります。

• イベントのURLを event.php.このファイルは次のセクションで作成する。

アプリケーションをVonage番号にリンクする

Vonageアプリケーションが作成され、利用可能なバーチャルナンバーが画面の下に表示されます。

このチュートリアルで使用する番号を選択し、次のボタンをクリックします。 リンクボタンをクリックして、バーチャル番号とVonageアプリケーションをリンクさせます。

その結果、バーチャル番号に電話をかけると、Vonageは次のように指定したURLでコールフローの指示を探します。 応答URLにイベントウェブフックを送信します。 イベントURLにイベントウェブフックを送信します。

次に、ここまでにやったことがすべて機能しているか確認してみましょう。その番号に電話して、挨拶が聞こえるかどうか確認してください。もし聞こえるなら、他の人に電話してもらい、おしゃべりを楽しんでください。

最初はうまくいかなくても心配しないでください。次のステップは、何が起こっているのかを確認できるようにイベント処理を構築することです。

コールイベントの処理

物事を単純にするために、アプリケーションはそのイベントURLを/event.php-そして、もしあなたがすでにこれをテストしたのであれば、失敗したリクエストがそこに到着するのを見たでしょう。

単純なイベント・ハンドラを作成するには、ファイル public/event.phpを作成し、以下のコードを追加する：

<?php

$post_params = json_decode(file_get_contents("php://input"), true);
$input_params = $_GET;

if (is_array($post_params)) {
    $input_params = array_merge($input_params, $post_params);
}

if (isset($input_params['status'])) {
    error_log("Status: " . $input_params['status']);
}
error_log("Event data: " . json_encode($input_params));

イベントURLには GETまたは POSTリクエストを使用するようにイベントURLを設定することが可能です！非常にシンプルで、データを error_logこの例で行ったようにローカルの PHP ウェブサーバを使用している場合は、 ウェブサーバプロセスの出力にイベントが表示されます。実際のアプリケーションでは、イベントのURLをもっと正式なものにリンクすることができます。

パーティーの電話会議を始める

まだ試していない方は、Vonageの番号に電話してみてください。そして、お友達やご家族、同僚にも同じようにお誘いください。通話中のイベントが表示されます。 event.phpに届き、様々な通話が応答され、リクエストが answer.php.

次の一手は？

次にやりたいことがいくつかあるだろう：

• NCCOのドキュメント NCCOドキュメント通話を録音したり、保留音楽を再生したり、特定のモデレーターを割り当てたりする方法については、NCCOのマニュアルを参照してください。

• このプロジェクトのコードを見る GitHub.

• 他の Vonage Voice API を使用するためのコードスニペットです。.

結論

このチュートリアルでは、Vonage Voice API を使って PHP による電話会議を作成しました。Voice アプリケーションを設定し、着信コールの webhook を処理し、複数の発信者を同じ会話に参加させるために NCCO を返しました。

ここから、通話録音、司会者の割り当て、保留音楽の再生、会議室名の動的生成などを追加して、このプロジェクトを拡張することができます。このワークフローを メッセージAPIと組み合わせてリマインダーを送ったり 認証を統合することもできる。