Comprendre le modèle de programmation des services PSTN audio

Le service PSTN audio utilise un modèle de programmation de demande/réponse qui utilise à son tour des fonctions. AWS Lambda Votre AWS Lambda fonction est appelée automatiquement pour les appels entrants et sortants. Par exemple, lorsqu'un nouvel appel entrant arrive, le service PSTN audio appelle votre AWS Lambda fonction avec un NEW_INCOMING_CALL événement et attend les commandes appelées Actions. Par exemple, votre application peut choisir des actions telles que la lecture d'une invite audio, la collecte de chiffres, l'enregistrement audio ou le renvoi de l'appel. Ces actions JSON formatées sont renvoyées au service PSTN audio à l'aide d'un rappel provenant de votre AWS Lambda fonction.

Cet exemple montre une PlayAudio action.

{
    "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"
        }
    }
}

Cet exemple montre une RecordAudio action.

{
    "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"
        }
    }
}

Une fois que le service PSTN audio exécute l'action, il invoque à nouveau votre AWS Lambda fonction avec une indication de réussite ou d'échec.

Votre application peut également passer des appels téléphoniques sortants et utiliser votre AWS Lambda fonction pour contrôler le flux d'appels, l'expérience de l'appelant et le contexte des appels. Dans ce cas, vous appelez le CreateSipMediaApplicationCallAPI, et votre AWS Lambda est invoqué avec un NEW_OUTBOUND_CALL événement. Une fois que vous avez répondu à l'appel, vous pouvez revenir sur certaines actions, telles que lancer une invite vocale et collecter les chiffres saisis par l'utilisateur. Vous pouvez également déclencher votre AWS Lambda fonction à l'aide du UpdateSipMediaApplicationCallAPIpour mettre en place des minuteries, la mise en sourdine des participants et des salles d'attente.