SendDigits

任意の通話レッグで、最大 50 のデュアルトーンマルチ周波数 (DTMF) ディジットを送信できます。シグナルには以下を含めることができます。

• 0 から 9 までの数字

• 特殊文字: 星 (*) とポンド (#)

• ネットワーク制御シグナル A、B、C、D

• カンマ文字 (,)。このシグナルにより、前のシグナルと次のシグナルの間に 0.5 秒の遅延が追加されます。

SendDigits アクションの使用

次の例は、一般的な SendDigits アクションを示しています。

{
    "SchemaVersion": "1.0",
    "Actions":[
        {
            "Type": "SendDigits",
            "Parameters": {
                "CallId": "call-id-1", // required
                "Digits": ",,*1234,56,7890ABCD#", // required
                "ToneDurationInMilliseconds": 100 // optional
            }
        }
    ]
} 

CallId

説明 – AWS Lambda 関数呼び出しの CallDetails における、参加者の CallId

使用できる値 – 有効な通話 ID

必須 – はい

デフォルト値 – なし

Digits

説明 - CallId に対応する通話レッグで送信されるディジット

使用できる値 – 0～9、*、#、A、B、C、D、カンマ (,)

必須 – はい

デフォルト値 – なし

ToneDurationInMilliseconds

説明 - 各ディジットの送信で許容される時間 (ミリ秒単位)

使用できる値 - 50～24000 の任意の整数

必須 – いいえ

デフォルト値 – 250

ACTION_SUCCESSFUL イベントの処理

SendDigits アクションの一般的な ACTION_SUCCESSFUL イベントの例を次に示します。

{
    "SchemaVersion": "1.0",
    "Sequence": 3,
    "InvocationEventType": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type": "SendDigits",
        "Parameters": {
            "Digits": "1,2A#",
            "ToneDurationInMilliseconds": 100,
            "CallId": "call-id-1"
        },  
    "CallDetails": { 
        ...
        }
    }
}

ACTION_FAILED イベントの処理

SendDigits アクションの一般的な ACTION_FAILED イベントの例を次に示します。

{
    "SchemaVersion": "1.0",
    "Sequence": 3,
    "InvocationEventType": "ACTION_FAILED",
    "ActionData": {
        "Type": "SendDigits",
        "Parameters": {
            "Digits": "1,2A#",
            "ToneDurationInMilliseconds": 20000000,
            "CallId": "call-id-1"
        },
    "ErrorType": "InvalidActionParameter",
    "ErrorMessage": "ToneDuration parameter value is invalid."
    },
    "CallDetails": {
        ...
        }
    }
}

通話フロー

次の図は、発信者から受信者にディジットを送信するプログラムフローを示しています。