Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Comprensione degli eventi di telefonia per il servizio audio PSTN Amazon Chime SDK
<a name="pstn-invocations"></a>

Il servizio audio richiama la AWS AWS Lambda funzione quando si verificano determinati eventi durante una chiamata. L'esempio seguente mostra gli eventi e il testo dopo l'esempio spiega ogni 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**  
La versione dello schema utilizzata per creare questo oggetto evento.

**Sequence**  
La sequenza di eventi che richiamano la AWS Lambda funzione. Ogni volta che la funzione viene richiamata durante una chiamata, la sequenza viene incrementata.

**InvocationEventType**  
Il tipo di evento che attiva una chiamata. AWS Lambda Per ulteriori informazioni, consulta [Event types (Tipi di evento)](#pstn-event-types) più avanti in questo argomento.

**CallDetails**  
Informazioni sulla chiamata associata alla chiamata. AWS Lambda 

**TransactionId**  
L'ID di una chiamata associata a una AWS Lambda chiamata.

**AwsAccountId**  
L'ID AWS dell'account associato all'applicazione multimediale SIP che ha provocato il routing delle chiamate.

**SipMediaApplicationId**  
L'ID dell'applicazione multimediale SIP associata alla chiamata.

**Participants**  
Informazioni sui partecipanti alla chiamata che richiama una funzione. AWS AWS Lambda 

**CallId**  
Un ID univoco assegnato a ciascun partecipante.

**ParticipantTag**  
Ogni partecipante alla chiamata riceve un tag, `LEG-A` o. `LEG-B`

**To**  
Il numero di telefono «a» del partecipante, nel E.164 formato.

**From**  
Il numero di telefono «da» del partecipante, nel E.164 formato.

**Direction**  
La direzione da cui proviene una chiamata. `Inbound`rappresenta una chiamata effettuata al servizio audio. `Outbound`rappresenta una chiamata effettuata dal servizio audio.

**StartTimeInMilliseconds**  
L'ora in millisecondi, a partire dal momento in cui un partecipante partecipa a una chiamata.

**Status**  
Se un partecipante è o `Connected` `Disconnected`

## Event types (Tipi di evento)
<a name="pstn-event-types"></a>

Il servizio audio richiama la funzione Lambda con questi tipi di eventi:

**NEW\_INBOUND\_CALL**  
Una nuova chiamata è stata avviata da un numero di telefono associato all'applicazione multimediale SIP.

**NEW\_OUTBOUND\_CALL**  
È stata effettuata una nuova chiamata in uscita tramite l'API. [CreateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateSipMediaApplicationCall.html)

**ACTION\_SUCCESSFUL**  
Un'azione restituita dalla tua AWS Lambda funzione è riuscita. Le azioni riuscite includono quelle `ActionData` che corrispondono all'azione riuscita.   

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

**ACTION\_FAILED**  
Un'azione restituita dalla tua AWS Lambda funzione non ha avuto successo. Le azioni non riuscite includono `ActionData` una corrispondenza all'azione non riuscita, un tipo di errore e un messaggio di errore che descrive l'errore:  

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

**ACTION\_INTERRUPTED**  
Un'azione in corso di esecuzione è stata interrotta da una chiamata all'[ UpdateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html)API. `ActionData`Include le azioni interrotte:   

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

**HANGUP**  
Un utente o l'applicazione hanno interrotto una sessione di chiamata. `ActionData`Include questi dettagli sull'evento:  

```
   "ActionData": {
        "Type": "Hangup",
        "Parameters": {
            "SipResponseCode": {{486}},
            "CallId": "{{c70f341a-adde-4406-9dea-1e01d34d033d}}",
            "ParticipantTag": "LEG-A"
        }
    },
```  
**Type**  
Riagganciare.  
**Parameters**  
Le informazioni sull'evento: `HANGUP`   
+ **SipResponseCode**— Il codice di risposta associato all'evento. I codici più comuni sono:
  + **0** — Cancellazione normale
  + **480** — Nessuna risposta
  + **486** — Utente occupato
+ **CallId**L'ID del partecipante che ha riattaccato.
+ **ParticipantTag**L'etichetta del partecipante che ha riattaccato.

**CALL\_ANSWERED**  
Il servizio audio ha risposto a una chiamata in arrivo. Questo evento viene restituito durante una chiamata in uscita, a meno che la chiamata non venga interrotta.

**INVALID\_LAMBDA\_RESPONSE**  
La risposta fornita all'ultima AWS Lambda chiamata ha causato un problema. `ActionData`Include questi campi aggiuntivi:  

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

**DIGITS\_RECEIVED**  
L'applicazione ha ricevuto cifre DTMF dopo il completamento di un'azione. `ReceiveDigits` `ActionData`Include le cifre ricevute.  

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

**CALL\_UPDATE\_REQUESTED**  
L'[UpdateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html)API è stata richiamata. `ActionData`Include informazioni sulla richiesta di aggiornamento:  

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

**RINGING**  
Sta suonando un pulsante di chiamata