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á.

# Noções básicas sobre eventos de telefonia do serviço de áudio PSTN do SDK do Amazon Chime
<a name="pstn-invocations"></a>

O serviço de áudio invoca sua AWS AWS Lambda função quando certos eventos ocorrem durante uma chamada. O exemplo a seguir mostra os eventos e o texto após o exemplo explica cada evento.

```
{ 
    "SchemaVersion": "1.0", 
    "Sequence": 3, 
    "InvocationEventType": "event-type", 
    "CallDetails": { 
        "TransactionId": "transaction-id-1", 
        "AwsAccountId": "aws-acct-id-1", 
        "AwsRegion": "us-east-1", 
        "SipMediaApplicationId": "sip-media-app-id-1", 
        "Participants": [ 
            { 
                "CallId": "call-id-1", 
                "ParticipantTag": "LEG-A", 
                "To": "e164PhoneNumber", 
                "From": "e164PhoneNumber", 
                "Direction": "Inbound/Outbound", 
                "StartTimeInMilliseconds": "1641998241509", 
                "Status": "Connected/Disconnected" 
            } 
        ] 
    } 
}
```

**SchemaVersion**  
A versão do esquema usada para criar esse objeto de evento.

**Sequence**  
A sequência de eventos que invocam sua AWS Lambda função. Sempre que sua função é invocada durante uma chamada, a sequência é incrementada.

**InvocationEventType**  
O tipo de evento que aciona uma AWS Lambda invocação. Para obter mais informações, consulte [Tipos de eventos](#pstn-event-types) mais adiante neste tópico.

**CallDetails**  
Informações sobre a chamada associada à AWS Lambda invocação.

**TransactionId**  
O ID de uma chamada associada a uma AWS Lambda invocação.

**AwsAccountId**  
O ID da AWS conta associado ao aplicativo de mídia SIP que resultou no roteamento de chamadas.

**SipMediaApplicationId**  
O ID do aplicativo de mídia SIP associado à chamada.

**Participants**  
Informações sobre os participantes da chamada que invoca uma AWS AWS Lambda função.

**CallId**  
Um ID exclusivo atribuído a cada participante.

**ParticipantTag**  
Cada participante da chamada recebe uma etiqueta, `LEG-A` ou`LEG-B`.

**To**  
O número de telefone "para" do participante, no formato E.164.

**From**  
O número de telefone “de” do participante, no formato E.164.

**Direction**  
A direção de onde vem um trecho de chamada. `Inbound` representa uma chamada feita para o serviço de áudio. `Outbound` representa uma chamada feita a partir do serviço de áudio.

**StartTimeInMilliseconds**  
O tempo de espera em milissegundos, começando quando um participante entra em uma chamada.

**Status**  
Se um participante está `Connected` ou `Disconnected`

## Tipos de eventos
<a name="pstn-event-types"></a>

O serviço de áudio invoca a função do Lambda com esses tipos de eventos:

**NEW\$1INBOUND\$1CALL**  
Uma nova chamada foi iniciada por um número de telefone associado ao seu aplicativo de mídia SIP.

**NEW\$1OUTBOUND\$1CALL**  
Uma nova chamada externa foi feita por meio da [CreateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateSipMediaApplicationCall.html)API.

**ACTION\$1SUCCESSFUL**  
Uma ação retornada de sua AWS Lambda função foi bem-sucedida. Ações bem-sucedidas incluem `ActionData` que correspondem à ação bem-sucedida.   

```
    "ActionData": {
        // The previous successful action 
    },
```

**ACTION\$1FAILED**  
Uma ação retornada de sua AWS Lambda função não foi bem-sucedida. As ações malsucedidas incluem `ActionData` que correspondem à ação com falha, um tipo de erro e uma mensagem de erro que descreve a falha:  

```
    "ActionData": {
        // The previous unsuccessful action
        "ErrorType": "error-type",
        "ErrorMessage": "error message"
    },
```

**ACTION\$1INTERRUPTED**  
Uma ação no processo de execução foi interrompida por uma invocação [ UpdateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html)da API. `ActionData` inclui as ações interrompidas:   

```
"ActionData": {
        // The action that was interrupted
    },
```

**HANGUP**  
Um usuário ou o aplicativo desligou um trecho de chamada. `ActionData` inclui os seguintes detalhes sobre o evento:  

```
   "ActionData": {
        "Type": "Hangup",
        "Parameters": {
            "SipResponseCode": 486,
            "CallId": "c70f341a-adde-4406-9dea-1e01d34d033d",
            "ParticipantTag": "LEG-A"
        }
    },
```  
**Type**  
Hangup.  
**Parameters**  
As informações sobre o evento `HANGUP`:   
+ **SipResponseCode**— O código de resposta associado ao evento. Os códigos mais comuns são:
  + **0** – Limpeza normal
  + **480** – Sem resposta
  + **486** – Usuário ocupado
+ **CallId**O ID do participante que desligou.
+ **ParticipantTag**A etiqueta do participante que desligou.

**CALL\$1ANSWERED**  
O serviço de áudio atendeu e uma chamada de entrada foi atendida. Esse evento é retornado em uma chamada discada, a menos que a chamada seja interliga seja ancorada.

**INVALID\$1LAMBDA\$1RESPONSE**  
A resposta fornecida à última AWS Lambda invocação causou um problema. `ActionData` inclui esses campos adicionais:  

```
    "ErrorType": "error-type-1", 
    "ErrorMessage": "error-msg-1"
```

**DIGITS\$1RECEIVED**  
O aplicativo recebeu dígitos do DTMF após a conclusão de uma ação `ReceiveDigits`. `ActionData` inclui os dígitos recebidos.  

```
    "ActionData": {
        "ReceivedDigits": ###
        // The ReceiveDigits action data
    },
```

**CALL\$1UPDATE\$1REQUESTED**  
A [UpdateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html)API foi invocada. `ActionData` inclui informações sobre a solicitação de atualização:  

```
    "ActionData": {
        "Type": "CallUpdateRequest", 
        "Parameters": {
            "Arguments": {
                "leg": "LEG-A"
                }
            }
        },
    }
```

**RINGING**  
Um trecho de chamada está tocando