コール マークアップ言語
コール マークアップ言語 (ML または CML の呼び出し) は、開発者向けに設計された音声機能で、API を通じてのみ使用できます。Calls ML を使用して、インバウンドコールとアウトバウンドコールを処理する任意のアプリケーションを作成できます。アプリケーションは、音声シナリオ ロジックを実装し、通話マークアップ言語を使用して、通話と会議でのアクションを制御および実行します。
Calls API と Calls Markup Language の違い
Calls API のイベント駆動型モデルは、音声プラットフォームと開発者のバックエンド間の継続的なリアルタイムの会話ループに依存しています。呼び出し中の個別の発生ごとに、プラットフォームは非同期 Webhook イベントをディスパッチします。これらのイベントには、通話への応答、DTMF キーの押下、またはオーディオ ファイルの再生の終了が含まれます。その後、開発者のサーバーはこのイベントを処理し、対応する API リクエストを発行して次のアクションを指示する必要があります。
対照的に、Calls ML は、一連の命令 (テキストの読み上げ、音声の録音、番号のダイヤルなど) を含む宣言型ドキュメント (JSON) を使用して、この対話を簡略化します。マイクロアクションごとに継続的にやり取りする代わりに、音声プラットフォームは重要な実行マイルストーンでこの指示書を要求します。次に、開発者のバックエンドへの定期的なラウンドトリップを必要とせずに、指定されたシーケンスを自律的に解析して実行します。
これら 2 つの方法は、さまざまな開発者エクスペリエンスと技術シナリオに合わせて最適化されます。
- Calls API を使用したイベント ドリブン メソッド: 呼び出し状態を維持する動的で複雑なアプリケーションに最適です。通話セッションを柔軟かつリアルタイムで制御できます。これにより、コンタクトセンター(CCaaS)、ライブエージェントルーティング、リアルタイムAI音声アシスタント、または通話中にデータベース検索を繰り返す必要があるワークフローなどのソリューションに適しています。トレードオフは、バックエンドが呼び出し状態を維持し、大量の非同期 Webhook を処理する必要があるため、開発者のオーバーヘッドが高くなります。
- Calls Markup Languageを使用したマークアップ言語メソッド:シンプルさと低遅延に最適です。読み取り可能でコードがほとんど必要ない一連のアクションを使用するため、動作を予測するのは簡単です。これにより、対話型音声応答(IVR (自動音声応答))メニュー、自動電話アラート、匿名通話転送、ボイスメールドロップなど、リニアまたは標準のコールフローに適しています。これにより、サーバー インフラストラクチャの要件が軽減され、一般的な音声アプリケーションの開発が迅速化されます。
CML アクション
コールマークアップ言語は、NTT CPaaS音声プラットフォームに指示を与える個々のアクションで構成されています。次の表に、通話マークアップ言語で使用できるアクションを示します。
| アクション | 説明 |
|---|---|
play | URLからオーディオファイルを再生します。 |
say | テキスト読み上げコンテンツを再生します。 |
captureDtmf | オプションの割り込みプロンプトを使用して数字を収集します。 |
dial | 電話、SIP、WebRTC、Viber、または WhatsApp エンドポイントにブリッジします。 |
record | コール レッグを記録します。 |
startRecording / stopRecording | きめ細かな録音制御。 |
pause | 指定した秒数待機します。 |
fetch | URL から次の CML アクションのセットをロードします。 |
hangup | 通話を終了します。 |
通話マークアップ言語は、会議、ストリーミング、音声キャプチャ、または通話のリアルタイム文字起こしをサポートしていません。
すべての呼び出しマークアップ言語アクションの完全なリファレンスについては、 API ドキュメントを参照してください。