Grundlegendes zum Programmiermodell für PSTN-Audiodienste

Der PSTN-Audiodienst verwendet ein Anforderungs-/Antwort-Programmiermodell, das wiederumAWS LambdaFunktionen. DeinAWS LambdaDie Funktion wird automatisch für eingehende und ausgehende Anrufe aufgerufen. Wenn beispielsweise ein neuer eingehender Anruf eingeht, ruft der PSTN-Audiodienst IhrenAWS LambdaFunktion mit einemNEW_INCOMING_CALLEreignis und wartet auf aufgerufene BefehleAktionen. Ihre Anwendung kann beispielsweise Aktionen wie das Abspielen einer Audioaufforderung, das Erfassen von Ziffern, das Aufzeichnen von Audio oder das Weiterleiten des Anrufs auswählen. Diese JSON-formatierten Aktionen werden mithilfe eines Rückrufs von Ihrem an den PSTN-Audiodienst zurückgesendetAWS LambdaFunktion.

Dieses Beispiel zeigt einePlayAudioAktion.

{
    "Type": "PlayAudio",
    "Parameters": {
        "CallId": "call-id-1",
        "ParticipantTag": "LEG-A",
        "PlaybackTerminators": ["1", "8", "#"],
        "Repeat": "5",
        "AudioSource": {
            "Type": "S3",
            "BucketName": "valid-S3-bucket-name",
            "Key": "wave-file.wav"
        }
    }
}

Dieses Beispiel zeigt eineRecordAudioAktion.

{
    "Type": "RecordAudio",
    "Parameters": {
        "CallId": "call-id-1",
        "DurationInSeconds": "10",
        "SilenceDurationInSeconds": 3,
        "SilenceThreshold": 100,
        "RecordingTerminators": [
            "#"
        ],
        "RecordingDestination": {
            "Type": "S3",
            "BucketName": "valid-bucket-name",
            "Prefix": "valid-prefix-name"
        }
    }
}

Sobald der PSTN-Audiodienst die Aktion ausführt, ruft er IhreAWS Lambdafunktioniert wieder mit einer Erfolgs- oder Fehleranzeige.

Ihre Anwendung kann auch ausgehende Telefonanrufe tätigen und IhreAWS LambdaFunktion zur Steuerung des Anrufablaufs, der Anrufererfahrung und des Anrufkontextes. In diesem Fall rufen Sie denCreateSipMediaApplicationCallAPI und deinAWS Lambdawird mit einem aufgerufenNEW_OUTBOUND_CALLEreignis. Sobald der Anruf beantwortet wurde, können Sie Aktionen wie das Abspielen einer Sprachansage und das Erfassen von vom Benutzer eingegebenen Ziffern zurückgeben. Sie können auch Ihre auslösenAWS LambdaFunktion mit demUpdateSipMediaApplicationCallAPI zur Implementierung von Timern, Stummschalten von Teilnehmern und Wartezimmern.