Web API リファレンス|Tropo Web API

{"conference":} オブジェクト

   

これを使えば2つ以上の通話を1つに結ぶことができるので、参加者全員が同時に通話できます。 conferenceのIDは全て、アプリケーション間で共有され、 同様に開発アプリのconferenceIDは、すべての開発アプリケーション間で共有されます。 これらのIDは、他のアカウントと共有されません。 ですから、もしあなたのconferenceIDが1234の場合、別のTropoユーザーも1234を使用していても、競合することはありません。

詳細については、こちらをご覧ください。

パラメータ

id
データの種類:String型 デフォルト:なし 必須
会議室の番号を指定します。
allowSignals
データの種類:String型またはArray型 デフォルト:*(任意の信号) 任意
このパラメータを使用すると、この関数にシグナルを割り当てることができます。一致するシグナル名を持つTropo REST APIからのイベントは、この関数を中断します。 すでにこの関数が実行され完了していた場合、中断の要求は無視されます。 この関数がまだ実行されていない場合、中断の要求は実行されるまでジョブキューに並びます。 デフォルトでは、allowSignalsはどんなシグナルも有効なものとして認識します。 allowSignalsを定めなかった場合、その関数は「中断なし」として定義されます。 配列を使うこともできます。配列にある名前のいずれかに一致するシグナルを受信した際に、この関数を中断します。
interdigitTimeout
データの種類:Integer型 デフォルト:なし 任意
Tropoが新たなキー入力を認識するまでに、ユーザが必要とする待機時間を秒単位で定めます。 基本的には、ユーザが間違ったキーを押してセッションを終了してしまった場合 (#を押そうとして *を押した場合など)に、キーを押し直すまでにTropoにどれくらいの待機させるかを意味します。
joinPrompt
データの種類:Boolean型またはHash型 デフォルト:false 任意
会議に参加する際の入室音を設定します。 trueと設定すると、デフォルトのビープ音が再生されますが、追加の属性として valuevoiceを使った音声合成(TTS)やオーディオURLを記述することができます。   *valueは簡単な音声合成(TTS)および/またはオーディオURLを再生するために使われ、 SSMLに対応しています。*voiceはTTSで利用可能な音声を定めます。音声が指定されていない場合には、 デフォルトの音声が使用されます。
leavePrompt
データの種類:Boolean型またはHash型 デフォルト:false 任意
会議から抜ける際の退室音を設定します。 trueと設定すると、デフォルトのビープ音が再生されますが、追加の属性として valuevoiceを使った音声合成(TTS)やオーディオURLを記述することができます。   *valueは簡単な音声合成(TTS)および/またはオーディオURLを再生するために使われ、 SSMLに対応しています。*voiceはTTSで利用可能な音声を定めます。音声が指定されていない場合には、 デフォルトの音声が使用されます。
mute
データの種類:Boolean型 デフォルト:false 任意
音声をミュートにして会議室に加えます。
name
データの種類:String型 デフォルト:なし 必須
これが、作業の結果を識別するのに使われるキーです。こうして、複数の結果を区別できます。 例えば、あなたがユーザに好みの色を質問するとします。ネーム値を 'color(色)'と設定しても、戻ってくる値が 'blue(青)'かもしれません。 1つの結果しか戻ってこない場合には、それほど役立たないかもしれませんが、結果が複数ある場合には、 これが、どの結果がどの作業に属するかを決定する助けとなります。
playTones
データの種類:Boolean型 デフォルト:false 任意
電話のキーが押されたときに鳴る音(DTMF音)がconferenceの参加者が会議のメンバーに聞こえるかどうかを設定します。
required
データの種類:Boolean型 デフォルト:true 任意
これにより、Tropoが次の動詞に移動すべきかどうかを決めます。もし、要求が「true」と設定されて、 現在の作業が完全に成功していれば、Tropoは次の動詞に移動します。
terminator
データの種類:String型 デフォルト:なし 任意
これは、会議から抜ける際に使われるタッチトーンキー(DTMF)です。
 

サンプル

 
{    
    "tropo": [
        {
            "conference": {
                "playTones":true,
                "name": "foo",
                "terminator": "#",
                "id": "1234",
                "mute": false
            }
        }
    ]
}
   
call hangup