As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# SendDigits


Envie até 50 dígitos de multifrequência de tom duplo (DTMF) em qualquer trecho de uma chamada. Os sinais podem incluir o seguinte:
+ Números de 0 a 9
+ Caracteres especiais estrela (\$1) e jogo-da-velha (\$1)
+ Sinais de controle de rede A, B, C, D
+ O caractere de vírgula (,). Esse sinal adiciona um atraso de 0,5 segundo entre os sinais anteriores e os próximos.

**Topics**
+ [

## Usar o SendDigits action
](#send-digits-action)
+ [

## Manuseio ACTION\$1SUCCESSFUL eventos
](#send-digit-success)
+ [

## Manuseio ACTION\$1FAILED eventos
](#send-digit-fail)
+ [

## Fluxo de chamadas
](#send-digits-call-flow)

## Usar o SendDigits action


O exemplo a seguir mostra uma ação `SendDigits` típica:

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

**CallId**  
*Descrição* – O `CallId` do participante no `CallDetails` da invocação da função AWS Lambda   
*Valores permitidos*: um ID de chamada válido  
*Obrigatório* – Sim  
*Valor-padrão*: nenhum

**Digits**  
*Descrição* – Os dígitos a serem enviados no trecho de chamada que corresponde ao `CallId`  
*Valores permitidos*: 0-9, \$1, \$1, A, B, C, D, vírgula (,)  
*Obrigatório* – Sim  
*Valor-padrão*: nenhum

**ToneDurationInMilliseconds**  
*Descrição* – A quantidade de tempo permitida, em milissegundos, para transmitir cada dígito.  
*Valores permitidos*: qualquer número inteiro entre 50 e 24000  
*Obrigatório* – Não  
*Valor-padrão*: 250

## Manuseio ACTION\$1SUCCESSFUL eventos


O exemplo a seguir mostra um evento `ACTION_SUCCESSFUL` típico para a ação `SendDigits`.

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

## Manuseio ACTION\$1FAILED eventos


O exemplo a seguir mostra um evento `ACTION_FAILED` típico para a ação `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": {
        ...
        }
    }
}
```

## Fluxo de chamadas


O diagrama a seguir mostra o fluxo do programa para enviar dígitos de um chamador para um chamador.

![\[Diagrama mostrando o fluxo do programa da ação SendDigits.\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/images/send-digits-1.png)