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
<a name="send-digits"></a>

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 (\$1) y almohadilla (\$1)
+ 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.

**Topics**
+ [Uso de SendDigits acción](#send-digits-action)
+ [Manipulación ACTION\$1SUCCESSFUL eventos](#send-digit-success)
+ [Manipulación ACTION\$1FAILED eventos](#send-digit-fail)
+ [Flujo de llamada](#send-digits-call-flow)

## Uso de SendDigits acción
<a name="send-digits-action"></a>

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, \$1, \$1, 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\$1SUCCESSFUL eventos
<a name="send-digit-success"></a>

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\$1FAILED eventos
<a name="send-digit-fail"></a>

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
<a name="send-digits-call-flow"></a>

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.\]](http://docs.aws.amazon.com/es_es/chime-sdk/latest/dg/images/send-digits-1.png)