Twilio音声通話のメンテナンスと回復：会議モードと独立したコールレッグ処理の詳細な説明

Twilio Voiceアプリケーションの開発では、コールを保留し、その後の回復を保留し、その後の回復が一般的な要件です。ただし、TWIML URLの変更など、単一のコールレッグでの直接更新操作は、多くの場合、相手からのコールの予期せぬ切断につながります。これは、呼び出し脚のTWIML命令が実行またはリダイレクトされると、Twilioがその脚の現在のプロセスが終了したと考えるためです。この記事では、コールの保持と回復を有効にする2つの方法を紹介します。Twilio会議機能（推奨）を使用し、独立した通話脚を処理します。

方法1：Twilio Conference（推奨）を使用する

Twilio会議機能は、コールを維持して回復するための最も簡単で堅牢な方法です。会議は、基本的に複数の参加者を結び付ける仮想ルームです。このモードでは、会議の各参加者のステータスを独立して制御できます。

1.参加者を保留にします

コールレッグが参加者として会議に参加すると、参加者のリソースを更新することで保留することができます。これには、更新リクエストをTwilio APIに送信し、参加者のホールドプロパティをTrueに設定し、Holdurlを指定してHold Musicを演奏することが含まれます。

サンプルコード（PHP）：

 会議（$ ConferencesID）
         - >参加者（$参加者）
         - >更新（[[
            "hold" => true、
            "Holdurl" => "http://www.myapp.com/hold_music.mp3" //音楽のURLを保持します
        ]）;

    エコー「参加者」。 $参加者 - > CallID。 「保留状態に正常に配置されます。\ n」;
} catch（例外$ e）{
    エコー「参加者を保留状態に置く際にエラーが発生しました：」。 $ e-> getMessage（）。 "\ n";
}
？>

上記のコードでは、HoldがTrueに設定されると、Twilioは参加者にHoldurlによって指定されたオーディオを再生し、他の会議参加者は参加者の声を聞くことができません。

2。コールの再開

参加者を会議に復元するには、参加者のリソースをもう一度更新し、保留プロパティをFalseに設定してください。

サンプルコード（PHP）：

 会議（$ ConferencesID）
         - >参加者（$参加者）
         - >更新（[[
            「hold」=> false
        ]）;

    エコー「参加者」。 $参加者 - > CallID。 「ホールドから正常に回復しました。\ n」;
} catch（例外$ e）{
    エコー「参加者の回復中にエラーが発生しました：」。 $ e-> getMessage（）。 "\ n";
}
？>

注：

• Twilioは会議内の接続ロジックを処理するため、会議機能を使用して州管理を簡素化します。
• Holdurlは、MP3およびWAV形式をサポートするアクセス可能なオーディオファイルURLにすることができます。

方法2：独立した呼び出し脚を処理する（高度）

会議機能を使用しないことを選択したが、代わりに2つの別々のコール脚を直接管理する場合、コールキーピングを達成する方が複雑になります。これは、1つのコールレッグのTWIMLを更新すると（たとえば、1つのHold TWIMLにリダイレクトする）、別のコールレッグの現在のTWIML命令が実行され続け、実行されると、コールレッグが切れます。

1。質問を理解してください：なぜ相手はなぜ破るのですか？

元の質問で説明されているシナリオ、つまり「呼び出し当事者が維持されると、呼び出し当事者が切断される」は、このメカニズムの具体化です。 APIを介して通話を更新すると（たとえば、音楽を再生および保持するURLをTWIMLに向けます）、そのコールレッグのTWIMLストリームが中断され、新しいURLを指します。それに接続された別のコールレッグの場合、そのTWIML命令（通常は）は、その接続ターゲットが「完了」されていると想定し、その脚のTWIMLプロセスが実行を継続し、将来他の命令がない場合は自動的に切れます。

元のコードスニペット分析：

 // ...
$ rr = array（
  "url" => "http://demo.twilio.com/docs/voice.xml"、// new Twiml url
  「method」=> "post"
）;
$ call = $ client-> calls（$ callingid） - > update（$ rr）; //発信者を更新// ...

このコードは、http://demo.twilio.com/docs/voice.xmlに$ callindidで表されるコールレッグのTwimlソースを更新します。 $ callingIDが呼び出しパーティーであり、以前にを介して呼び出し当事者に接続されていた場合、呼び出し当事者のTWIMLが更新されると、呼び出し当事者によって実行された命令はその接続「完了」を検討し、呼び出し元のTWIMLは引き続き実行されます（その後）、そうでなければハングアップします。

2.非保持脚にフォローアップTWIMLを提供します

発信者が保持されているときに非保持脚が切断されないようにするには、TWIMLでフォローアップの指示を提供する必要があります。たとえば、ディレクティブの後にを追加して、別のURLへの呼び出しを取得します。

例twiml：

 
  <dial> customer_number </dial> 
  <redirect> https://example.com/hold_waiting </redirect> 

この例では、操作が完了すると（例えば、他の脚が保持またはリダイレクトされているため）、コールは切れませんが、https：//example.com/hold_waitingによって提供されるTwimlにリダイレクトされます。このTWIMLは、迅速なトーンをプレイして、ユーザーが待っていることを知らせることができます。

3。維持と復元の戦略を実装します

完全な保持と回復を達成するために、次の戦略を採用できます。

• それを動作させてください：

  • Keep MusicのTWIML URLを再生するには、APIを介して保持する必要があるコールレッグ（例えば、エージェントレッグ）のTwimlを更新します。
  • APIを介して別のコールレッグ（たとえば、クライアントレッグ）のTwimlを、コール（）をキューするTwiml URLに更新します。このようにして、クライアントの足は電話を切ることはありませんが、待機中のキューになります。

  Enqueueの例Twiml：

   
    <enqueue waiturl="http://www.myapp.com/wait_music.mp3"> mycustomerqueue </enqueue>
  

• 回復操作：

  • エージェントの脚のTwimlを、ディレクティブを介してクライアントキューに接続するTwiml URLに更新します。
  • エージェントの脚がキューにダイヤルされると、Twilioはエージェントの脚をキューで待っているクライアントの脚に接続します。

  キューをダイヤルするためのTWIMLの例：

   
    <dial> <queue> myCustomerqueue </queue> </dial>
  

注：

• このアプローチでは、複雑さが大幅に増加して、2つのコール脚とTWIMLフローの状態を手動で管理する必要があります。
• アプリケーションが、各コールレッグの現在のステータスと対応するコールSIDを追跡できることを確認する必要があります。
• エラー処理とエッジケース（キューで待っていない顧客など）を慎重に検討する必要があります。

要約とベストプラクティス

上記の2つの方法から、Twilio会議機能を使用することが、呼び出しを維持および復元するための最も推奨される方法であることがわかります。組み込みの状態管理と、開発の複雑さを大幅に削減する簡素化されたAPIを提供します。

• 優先計画：Twilio会議。ユースケースで会議が許可されている場合は、必ずこのシナリオを選択してください。より強力な機能（複数の参加者、ミュート、キックアウトなど）を提供し、オペレーションを直感的で簡単に実装できるようにします。
• 高度なソリューション：独立したコール脚。アプリケーションシナリオに特別な制限があり、会議機能を使用できない場合にのみ、独立したコールレッグを手動で管理することを検討してください。このアプローチでは、TwilioのTwimlストリームとAPI呼び出しを深く理解する必要があり、呼び出しステータス、再接続ロジック、エラー状況を処理するためにより多くのコードが必要です。

選択した方法に関係なく、Twilio TwiMLがどのように機能するか、APIが呼び出しステータスにどのように影響するかを理解することが重要です。 TWIMLとバックエンドロジックを合理的に設計することにより、堅牢でユーザーエクスペリエンスTwilio Voiceアプリケーションを構築できます。