Comprendre les événements de téléphonie

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

ID de AWS compte associé à l'application multimédia SIP à l'origine du 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. Inboundreprésente un appel passé au service audio. Outboundrepré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 ou Disconnected

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. ActionDataCela inclut les actions interrompues :

"ActionData": {
        // The action that was interrupted
    }, 

HANGUP

Un utilisateur ou l'application a raccroché un segment d'appel. ActionDataCela 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 — Nettoyage normal

  • 480 — Aucune réponse

  • 486 — Utilisateur 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. ActionDataCela inclut les champs supplémentaires suivants :

    "ErrorType": "error-type-1", 
    "ErrorMessage": "error-msg-1"
                                

DIGITS_RECEIVED

L'application a reçu des chiffres DTMF une fois l'ReceiveDigitsaction terminée. ActionDataInclut les chiffres reçus.

    "ActionData": {
        "ReceivedDigits": ###
        // The ReceiveDigits action data
    },

CALL_UPDATE_REQUESTED

L'UpdateSipMediaApplicationCallAPI a été invoquée. ActionDataCela inclut des informations sur la demande de mise à jour :

    "ActionData": {
        "Type": "CallUpdateRequest", 
        "Parameters": {
            "Arguments": {
                "leg": "LEG-A"
                }
            }
        },
    }

RINGING

Une jambe d'appel sonne