

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

# Specificazione delle azioni in risposta agli eventi di telefonia per il servizio audio PSTN di Amazon Chime SDK
<a name="use-case-2"></a>

Nel servizio audio, le applicazioni multimediali SIP AWS Lambda richiamano funzioni. *A sua volta, una funzione Lambda può restituire un elenco di istruzioni note come azioni.* Un'azione è un elemento che si desidera eseguire durante una chiamata telefonica, ad esempio l'invio o la ricezione di cifre, la partecipazione a una riunione e così via. Per ulteriori informazioni sulle azioni richiamate dal servizio audio PSTN, vedere. [Comprensione degli eventi di telefonia per il servizio audio PSTN Amazon Chime SDK](pstn-invocations.md)

Quando un'applicazione multimediale SIP esegue correttamente un elenco di azioni, richiama la AWS Lambda funzione con un tipo di evento di invocazione di. `ACTION_SUCCESSFUL` Se una delle azioni non viene completata, l'applicazione multimediale SIP richiama la AWS Lambda funzione con l'evento. `ACTION_FAILED`

L'applicazione multimediale SIP viene restituita solo `ACTION_SUCCESSFUL` se tutte le azioni dell'elenco hanno esito positivo. Se una delle azioni nell'elenco fallisce, l'applicazione multimediale SIP richiama la AWS Lambda funzione con l'`ACTION_FAILED`evento e cancella le azioni rimanenti nell'elenco dopo quella fallita. L'applicazione multimediale SIP esegue quindi l'azione successiva restituita dalla funzione. AWS Lambda Si utilizza la `ActionData` chiave per identificare quale chiamata ha richiamato la funzione.

L'evento seguente mostra un payload di esempio per il tipo di evento di `ACTION_SUCCESSFUL` invocazione dopo un'azione. `PlayAudioAndGetDigits`

```
{
    "SchemaVersion": "1.0",
    "Sequence": {{3}},
    "InvocationEventType": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type": "PlayAudioAndGetDigits",
        "Parameters" : {
            "CallId": "{{call-id-1}}",
            "AudioSource": {
                "Type": "S3",
                "BucketName": "{{bucket-name}}",
                "Key": "{{failure-audio-file.wav}}"
            },
            "FailureAudioSource": {
                "Type": "S3",
                "BucketName": "{{bucket-name}}",
                "Key": "{{failure-audio-file.wav}}"
            },
            "MinNumberOfDigits": {{3}},
            "MaxNumberOfDigits": {{5}},
            "TerminatorDigits": ["{{#}}"],
            "InBetweenDigitsDurationInMilliseconds": {{5000}},
            "Repeat": 3,
            "RepeatDurationInMilliseconds": {{10000}}
        },
        "ReceivedDigits": "{{123}}"
    }
    "CallDetails": {
        "TransactionId": "{{transaction-id}}",
        "AwsAccountId": "{{aws-account-id}}",
        "AwsRegion": "{{us-east-1}}",
        "SipRuleId": "{{sip-rule-id}}",
        "SipApplicationId": "{{sip-application-id}}",
        "Participants": [
            {
                "CallId": "{{call-id-1}}",
                "ParticipantTag": "LEG-A",
                "To": "{{+12065551212}}",
                "From": "{{+15105550101}}",
                "Direction": "Inbound",
                "StartTimeInMilliseconds": "{{159700958834234}}",
                "Status": "Connected"
                }
            ]
        }
    }
}
```

Quando un'azione in un elenco non viene completata correttamente, l'applicazione multimediale SIP richiama la AWS Lambda funzione per avvisare l'utente dell'errore e per ottenere un nuovo set di azioni da eseguire su quella chiamata. L'evento seguente mostra il payload di esempio per il tipo di evento di `ACTION_FAILED` invocazione dopo un'azione. `PlayAudio`

```
{
    "SchemaVersion": "1.0",
    "Sequence": {{4}},
    "InvocationEventType": "ACTION_FAILED",
    "ActionData": {
        "Type": "PlayAudio",
        "Parameters" : {
            "CallId": "{{call-id-1}}",
            "AudioSource": {
                "Type": "S3",
                "BucketName": "{{bucket-name}}",
                "Key": "{{audio-file.wav}}"            
            }
        },
        "ErrorType": "InvalidAudioSource",
        "ErrorMessage": "Audio Source parameter value is invalid."
    }
    "CallDetails": {
        "TransactionId": "{{transaction-id}}",
        "AwsAccountId": "{{aws-account-id}}",
        "AwsRegion": "{{us-east-1}}",
        "SipRuleId": "{{sip-rule-id}}",
        "SipApplicationId": "{{sip-application-id}}",
        "Participants": [
            {
                "CallId": "{{call-id-1}}",
                "ParticipantTag": "LEG-A",
                "To": "{{+12065551212}}",
                "From": "{{+15105550101}}",
                "Direction": "Inbound",
                "StartTimeInMilliseconds": "{{159700958834234}}",
                "Status": "Connected"
            }
        ]
    }
}
}
```