SendDigits - Amazon Chime SDK
Uso de SendDigits acciónManipulación ACTION_SUCCESSFUL eventosManipulación ACTION_FAILED eventosFlujo de llamada

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

SendDigits

Envíe hasta 50 dígitos de doble tono y multifrecuencia (DTMF) en cualquier tramo de una llamada. Las señales pueden incluir lo siguiente:

  • Números del 0 al 9

  • Caracteres especiales como asterisco (*) y almohadilla (#)

  • Señales de control de red A, B, C, D

  • El carácter de coma (,). Esta señal añade un retraso de 0,5 segundos entre la señal anterior y la siguiente.

Uso de SendDigits acción

A continuación se muestra una acción típica de SendDigits.

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

Descripción: el CallId de un participante en la invocación de los CallDetails de la función AWS Lambda

Valores permitidos: un identificador de llamada válido

Obligatorio: sí

Valor predeterminado: ninguno

Digits

Descripción: los dígitos que se van a enviar en el tramo de llamada que corresponde al CallId

Valores permitidos: 0-9, *, #, A, B, C, D, coma (,)

Obligatorio: sí

Valor predeterminado: ninguno

ToneDurationInMilliseconds

Descripción: cantidad de tiempo permitida, en milisegundos, para transmitir cada dígito.

Valores permitidos: cualquier número entero entre 50 y 24000

Obligatorio: no

Valor predeterminado: 250

Manipulación ACTION_SUCCESSFUL eventos

En el ejemplo siguiente se muestra un evento ACTION_SUCCESSFUL típico para la acción SendDigits.

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

Manipulación ACTION_FAILED eventos

En el ejemplo siguiente se muestra un evento ACTION_FAILED típico para la acción SendDigits.

{
    "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": {
        ...
        }
    }
}

Flujo de llamada

El siguiente diagrama muestra el flujo del programa para enviar dígitos de una persona que llama a una persona que recibe la llamada.

Diagrama que muestra el flujo programático de la acción SendDigits.