Comprendre le modèle de programmation du service audio PSTN

Le service PSTN Audio utilise un modèle de programmation requête/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 au format JSON sont renvoyées au service PSTN Audio à l'aide d'un rappel de votre fonction. AWS Lambda

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 a exécuté 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 l'CreateSipMediaApplicationCallAPI, et votre API AWS Lambda est invoquée 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 de l'UpdateSipMediaApplicationCallAPI pour implémenter des minuteries, la mise en sourdine des participants et des salles d'attente.