Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Le service audio invoque votre AWS AWS Lambda fonction lorsque certains événements se produisent au cours d'un appel. L'exemple suivant montre les événements, et le texte qui suit l'exemple explique chaque événement.
{
"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
-
Version du schéma utilisée pour créer cet objet d'événement.
- Sequence
-
La séquence d'événements qui invoque votre AWS Lambda fonction. Chaque fois que votre fonction est invoquée pendant un appel, la séquence est incrémentée.
- InvocationEventType
-
Type d'événement qui déclenche un AWS Lambda appel. Pour plus d'informations, consultez Types d’événements plus loin dans cette rubrique.
- CallDetails
-
Informations sur l'appel associé à l' AWS Lambda invocation.
- TransactionId
-
L'ID d'un appel associé à une AWS Lambda invocation.
- AwsAccountId
-
L'ID de AWS compte associé à l'application multimédia SIP qui a entraîné le routage des appels.
- SipMediaApplicationId
-
ID de l'application multimédia SIP associée à l'appel.
- Participants
-
Informations sur les participants à l'appel qui invoque une AWS AWS Lambda fonction.
- CallId
-
Un identifiant unique attribué à chaque participant.
- ParticipantTag
-
Chaque participant à l'appel reçoit un tag,
LEG-A
ouLEG-B
. - To
-
Le numéro de téléphone « à » du participant, au format E.164.
- From
-
Le numéro de téléphone « du » participant, au format E.164.
- Direction
-
La direction d'où provient un segment d'appel.
Inbound
représente un appel effectué vers le service audio.Outbound
représente un appel effectué depuis le service audio. - StartTimeInMilliseconds
-
Durée en millisecondes, à partir du moment où un participant rejoint un appel.
- Status
-
Si un participant est
Connected
ouDisconnected
Types d’événements
Le service audio invoque la fonction Lambda avec les types d'événements suivants :
- NEW_INBOUND_CALL
-
Un nouvel appel a été lancé par un numéro de téléphone associé à votre application multimédia SIP.
- NEW_OUTBOUND_CALL
-
Un nouvel appel sortant a été effectué via l'CreateSipMediaApplicationCallAPI.
- ACTION_SUCCESSFUL
-
Une action renvoyée par votre AWS Lambda fonction a réussi. Les actions réussies incluent
ActionData
celles qui correspondent à l'action réussie."ActionData": { // The previous successful action },
- ACTION_FAILED
-
Une action renvoyée par votre AWS Lambda fonction n'a pas abouti. Les actions
ActionData
qui ont échoué incluent celles qui correspondent à l'action échouée, un type d'erreur et un message d'erreur décrivant l'échec :"ActionData": { // The previous unsuccessful action "ErrorType": "
error-type
", "ErrorMessage": "error message
" }, - ACTION_INTERRUPTED
-
Une action en cours d'exécution a été interrompue par un appel d' UpdateSipMediaApplicationCallAPI.
ActionData
Cela inclut les actions interrompues :"ActionData": { // The action that was interrupted },
- HANGUP
-
Un utilisateur ou l'application a raccroché un segment d'appel.
ActionData
Cela inclut les détails suivants sur l'événement :"ActionData": { "Type": "Hangup", "Parameters": { "SipResponseCode":
486
, "CallId": "c70f341a-adde-4406-9dea-1e01d34d033d
", "ParticipantTag": "LEG-A" } },- Type
-
Raccrochez.
- Parameters
-
Informations sur l'
HANGUP
événement :-
SipResponseCode— Le code de réponse associé à l'événement. Les codes les plus courants sont les suivants :
-
0 — Effacement normal
-
480 — Pas de réponse
-
486 — L'utilisateur est occupé
-
-
CallIdL'identifiant du participant qui a raccroché.
-
ParticipantTagL'étiquette du participant qui a raccroché.
-
- CALL_ANSWERED
-
Le service audio a répondu à un appel entrant. Cet événement est renvoyé lors d'un appel d'appel sortant, sauf si l'appel est ponté.
- INVALID_LAMBDA_RESPONSE
-
La réponse fournie à la dernière AWS Lambda invocation a causé un problème.
ActionData
Cela inclut les champs supplémentaires suivants :"ErrorType": "
error-type-1
", "ErrorMessage": "error-msg-1
" - DIGITS_RECEIVED
-
L'application a reçu des chiffres DTMF après la fin d'une
ReceiveDigits
action.ActionData
Inclut les chiffres reçus."ActionData": { "ReceivedDigits":
###
// The ReceiveDigits action data }, - CALL_UPDATE_REQUESTED
-
L'UpdateSipMediaApplicationCallAPI a été invoquée.
ActionData
Cela inclut des informations sur la demande de mise à jour :"ActionData": { "Type": "CallUpdateRequest", "Parameters": { "Arguments": { "leg": "LEG-A" } } }, }
- RINGING
-
Une jambe d'appel sonne