メニュー

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

PHPおよびLaravelを使用した通話の追跡

この Laravel ウェブアプリケーションでは、Twilio を使って、さまざまなマーケティングチャンネルの有効性を追跡する方法を示します。

このアプリケーションには、3 つの主要な機能があります。

  • さまざまなマーケティングキャンペーン(広告用掲示板やバスの車内広告など)で使う電話番号を Twilio から購入する
  • その電話番号に対する着信をセールス担当者に転送する
  • 電話番号および受け取った通話に関するデータを示すチャートを表示する

このチュートリアルでは、このアプリケーションを実行するための主要なコードをいくつか紹介します。コードを実行する方法については、GitHub のプロジェクトの README をお読みください。

Whatclinic.comがTwilioを使用してヘルスケア業界向けに通話の追跡プラットフォームを構築する方法を確認しましょう。

はじめましょう!

使用可能な電話番号を検索する

通話の追跡には必要に応じて電話番号を検索、購入することが求められ、特定の電話番号が引き合いのソースに関連づけられます。 Twilio PHPヘルパーライブラリーを使用して、利用可能な電話番号を確認するため(おそらく市外局番で絞り込んで)Twilioにサーバー側のリクエストを発行します。

        
        
        
        
        app/Http/Controllers/AvailableNumberController.php

        電話番号を検索する

        app/Http/Controllers/AvailableNumberController.php

        ここで、これらの番号を購入用にユーザーに表示し、キャンペーンを有効にする方法を見てみましょう。

        使用可能な電話番号を表示する

        使用可能な電話番号を表示する

        ユーザーが通話のトラッキングに使う電話番号を検索した場合、Twilio API から購入できる電話番号のリストが表示されます。それぞれの番号に対し、Twilio API からその番号を購入するためのフォームを作成します。

              
              
              
              
              resources/views/available_numbers/index.blade.php

              利用可能電話番号一覧テンプレート

              resources/views/available_numbers/index.blade.php

              Twilio PHPヘルパーライブラリーの助けを借りて、購入可能な電話番号の表示方法を見てきました。 ここでは、利用可能な電話番号を購入する方法を見てみましょう。

              電話番号の購入方法

              電話番号を購入

              ユーザーが購入する電話番号を選択したら、Twilio API を使ってトランザクションを完了します。電話番号を購入したら、それぞれの通話で発信者の ID 情報を検索するとともに、作成した TwiML アプリケーションを使って、着信を処理するように指定します。

              電話番号が購入されると、その番号を LeadSource モデルと関連付けます。これは、リダイレクト後にユーザーが編集できます。

                    
                    
                    
                    
                    app/Http/Controllers/LeadSourceController.php

                    電話番号を購入する

                    app/Http/Controllers/LeadSourceController.php

                    アプリケーションSIDの確認場所がわからない場合でもご安心ください。 次の手順で方法をご案内します。

                    アプリケーションSIDの確認方法を見る

                    TwiML アプリケーションでウェブホックの URL を設定する

                    電話番号を購入する際、VoiceアプリケーションSIDを指定します。 これはTwiMLアプリケーションに対する識別子で、REST API経由で作成するか、Twilio Consoleで作成できます。

                    TwiMLAppを作成する

                    電話番号を関連づける方法を確認する

                    電話番号をリードソースに関連付ける

                    電話番号を購入したので、ユーザーが転送番号とこの番号の説明を追加するためのフォームを表示します。これ以降、この番号への通話は、このソースに起因するものとみなされます。すべての電話番号は E.154 形式です。

                          
                          
                          
                          
                          app/Http/Controllers/LeadSourceController.php

                          引き合いソースを作成する

                          app/Http/Controllers/LeadSourceController.php

                          ここまで、リードソースの作成と、それをTwilio電話番号に関連づける方法は大変理解しやすいものです。 ここでは、この情報を保存するリードソースのモデルについて詳しく見ていくことにしましょう。

                          リードソースのモデルの定義方法

                          LeadSource モデル

                          このモデルには、前のステップのフォームで提供された情報が含まれます。LeadSource モデルは、Twilio 番号を指定したリードソース(「Wall Street Journal Ad」や「Dancing guy with sign」など)に関連付けます。また、セールスやサポートヘルプ回線など、すべての通話のリダイレクト先の電話番号も追跡します。また、このリードソースと関連付けられているリードを見つけるための便利なメソッドも提供します。

                                
                                
                                
                                
                                app/LeadSource.php

                                リードソースのモデル

                                app/LeadSource.php

                                As the application will be collecting leads and associating them to each LeadSource or campaign, it is necessary to have a Lead model as well to keep track of each Lead as it comes in and associate it to the LeadSource.

                                Let's see what the Lead model looks like

                                リードモデル

                                Lead は、LeadSource で生成された通話を表します。LeadSource に関連付けられた電話番号に電話がかかるたびに、Lead モデルを使って、その通話に関して Twilio が提供するデータの一部を記録します。

                                      
                                      
                                      
                                      
                                      app/Lead.php

                                      リードモデル

                                      app/Lead.php

                                      Twilio電話番号だけでなくLeadSourceを作成するコードのバックエンド部分が完成しました。 アプリケーションの次の部分は着信通話を処理し、それを適切な営業部のメンバーに転送するためのWebhookになります。 これらWebhookの構築方法を見ていきましょう。

                                      通話の転送方法を学ぶ

                                      通話を転送し、リードを作成する

                                      いずれかの Twilio 番号にお客様から電話がかかると、Twilio はこのビュー関数に関連付けられている URL(/lead)に POST リクエストを送信します。

                                      着信データを使って、LeadSource に新しい Lead を作成した後、LeadSourceforwarding_number と発信者を接続するTwiML を返します。

                                            
                                            
                                            
                                            
                                            app/Http/Controllers/LeadController.php

                                            電話の転送

                                            app/Http/Controllers/LeadController.php

                                            通話を転送してリードを作成したら、見込み顧客を生み出す着信通話が大量にやってくるでしょう。 そしてそれらは我々にとってのデータとなるのですが、これらデータから恩恵を得られるような情報に変えてやることが必要です。 そこで次のステップでは、これらのソースから統計を得る方法を見ていきます。

                                            リードソースから統計を取得する方法を確認する

                                            リードソースに関する統計を取得する

                                            データから取得できる便利な統計情報のひとつは、各引き合いソース(LeadSource)にどのくらい多くの通話着信があったか、というものです。 また、引き合いのやってきた都市を知ることも必要かもしれません。 そのためには、これらのデータを返す2つのEloquentクエリーを定義します。

                                                  
                                                  
                                                  
                                                  
                                                  app/Lead.php

                                                  この時点まで、アプリケーションのバックエンドのコードについて見てきました。 これで着信通話や見込み顧客の処理を開始する準備が整いました。 続いて、クライアント側に注目点を切り替えましょう。 今回の場合は、それはシンプルなJavaScriptアプリケーションで、またChart.jsを使用して適切な方法でこれら統計を描画します。

                                                  chart.jsで統計を描画する方法

                                                  Chart.js で統計を視覚化する

                                                  ホームページに戻り、jQuery を使い、サーバーから JSON に通話のトラッキングの統計を取り込みます。統計は、Chart.js で作成するカラフルな円グラフに表示します。

                                                        
                                                        
                                                        
                                                        
                                                        public/js/pieCharts.js

                                                        統計からの円グラフ

                                                        public/js/pieCharts.js

                                                        これで終わりです。これで、Laravel アプリケーションは新しい電話番号を購入し、着信を転送し、ビジネス上の統計情報を記録できるようになりました。

                                                        関連トピック

                                                        関連トピック

                                                        Twilio を使う PHP 開発者であれば、以下のチュートリアルもお楽しみください。

                                                        クリック トゥ コール (Laravel)

                                                        ウェブページのボタンを押して、電話を介して訪問者をライブサポートまたはセールス担当者に接続します。

                                                        アポイント リマインダー (Laravel)

                                                        アポイントメントに先立ち、Twilio SMS を使って自動リマインダーをお客様に送信します。

                                                        これは役に立ちましたか?

                                                        このチュートリアルをお読みいただき、ありがとうございます。 弊社に知らせたいフィードバックがある場合は、Twitter経由で英語でご連絡ください。 喜んでお話を伺います。

                                                        Mario Celi Jose Oliveros Agustin Camino Andrew Baker Kat King David Prothero
                                                        Rate this page:

                                                        ヘルプが必要ですか?

                                                        We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.