Descripción de los eventos de telefonía

El servicio de audio invoca su AWS AWS Lambda función cuando se producen determinados eventos durante una llamada. El siguiente ejemplo muestra los eventos y el texto que sigue al ejemplo explica cada evento.

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

La versión del esquema utilizada para crear este objeto de evento.

Sequence

La secuencia de eventos que invocan su función. AWS Lambda Cada vez que se invoca la función durante una llamada, la secuencia se incrementa.

InvocationEventType

El tipo de evento que desencadena una AWS Lambda invocación. Para obtener más información, consulte Tipos de eventos más adelante en este tema.

CallDetails

Información sobre la llamada asociada a la AWS Lambda invocación.

TransactionId

El ID de una llamada asociada a una AWS Lambda invocación.

AwsAccountId

El ID de AWS cuenta asociado a la aplicación multimedia SIP que dio lugar al enrutamiento de la llamada.

SipMediaApplicationId

El ID de la aplicación multimedia SIP asociada a la llamada.

Participants

Información sobre los participantes de la llamada que invoca una AWS AWS Lambda función.

CallId

Un ID único asignado a cada participante.

ParticipantTag

Cada participante de la llamada recibe una etiqueta, LEG-A o LEG-B.

To

El número de teléfono «para» del participante en formato E.164.

From

El número de teléfono del participante en formato E.164.

Direction

La dirección de la que proviene el tramo de una llamada. Inbound representa una llamada realizada al servicio de audio. Outbound representa una llamada realizada desde el servicio de audio.

StartTimeInMilliseconds

El tiempo de la época en milisegundos, que comienza cuando un participante se une a una llamada.

Status

Si un participante está Connected o Disconnected

Tipos de eventos

El servicio de audio invoca la función de Lambda con los siguientes tipos de eventos:

NEW_INBOUND_CALL

Se ha iniciado una nueva llamada mediante un número de teléfono asociado a su aplicación multimedia SIP.

NEW_OUTBOUND_CALL

Se ha realizado una nueva llamada saliente a través de la CreateSipMediaApplicationCallAPI.

ACTION_SUCCESSFUL

Se ha realizado correctamente una acción devuelta por tu AWS Lambda función. Las acciones finalizadas satisfactoriamente incluyen aquellos ActionData que coincidan con la acción.

    "ActionData": {
        // The previous successful action 
    }, 

ACTION_FAILED

Una acción devuelta por tu AWS Lambda función no se ha realizado correctamente. Entre las acciones fallidas se incluyen ActionData que coinciden con la acción fallida, un tipo de error y un mensaje de error que describe el error:

    "ActionData": {
        // The previous unsuccessful action
        "ErrorType": "error-type",
        "ErrorMessage": "error message"
    },

ACTION_INTERRUPTED

Una invocación a la UpdateSipMediaApplicationCallAPI interrumpió una acción en proceso de ejecución. Los ActionData incluyen las acciones interrumpidas:

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

HANGUP

Un usuario o la aplicación colgaron el tramo de una llamada. Los ActionData incluyen los siguientes detalles sobre el evento:

   "ActionData": {
        "Type": "Hangup",
        "Parameters": {
            "SipResponseCode": 486,
            "CallId": "c70f341a-adde-4406-9dea-1e01d34d033d",
            "ParticipantTag": "LEG-A"
        }
    },

Type

Colgar.

Parameters

Información sobre el evento HANGUP:

• SipResponseCode— El código de respuesta asociado al evento. Los códigos más comunes son:

  • 0 — Borrado normal

  • 480 — Sin respuesta

  • 486 — Usuario ocupado

• CallIdEl identificador del participante que colgó el teléfono.

• ParticipantTagLa etiqueta del participante que colgó.

CALL_ANSWERED

El servicio de audio respondió a una llamada entrante. Este evento se devuelve en una llamada telefónica externa, a menos que la llamada sea transitoria.

INVALID_LAMBDA_RESPONSE

La respuesta proporcionada a la última AWS Lambda invocación causó un problema. Los ActionData incluyen los siguientes campos adicionales:

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

DIGITS_RECEIVED

La aplicación recibió los dígitos del DTMF después de completar una acción de ReceiveDigits. Los ActionData incluyen los dígitos recibidos.

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

CALL_UPDATE_REQUESTED

Se ha invocado la UpdateSipMediaApplicationCallAPI. Los ActionData incluyen información sobre la solicitud de actualización:

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

RINGING

Está sonando un tramo de llamada