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, in formato E.164.

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

**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\$1INBOUND\$1CALL**  
Una nuova chiamata è stata avviata da un numero di telefono associato all'applicazione multimediale SIP.

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

**ACTION\$1SUCCESSFUL**  
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\$1FAILED**  
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\$1INTERRUPTED**  
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\$1ANSWERED**  
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\$1LAMBDA\$1RESPONSE**  
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\$1RECEIVED**  
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\$1UPDATE\$1REQUESTED**  
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