Como entender os eventos de telefonia

O serviço de áudio invoca sua AWS AWS Lambda função quando certos eventos ocorrem durante uma chamada. O exemplo a seguir mostra os eventos e o texto após o exemplo 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

A versão do esquema usada para criar esse objeto de evento.

Sequence

A sequência de eventos que invocam sua AWS Lambda função. Sempre que sua função é invocada durante uma chamada, a sequência é incrementada.

InvocationEventType

O tipo de evento que aciona uma AWS Lambda invocação. Para obter mais informações, consulte Tipos de eventos mais adiante neste tópico.

CallDetails

Informações sobre a chamada associada à AWS Lambda invocação.

TransactionId

O ID de uma chamada associada a uma AWS Lambda invocação.

AwsAccountId

O ID da AWS conta associado ao aplicativo de mídia SIP que resultou no roteamento de chamadas.

SipMediaApplicationId

O ID do aplicativo de mídia SIP associado à chamada.

Participants

Informações sobre os participantes da chamada que invoca uma AWS AWS Lambda função.

CallId

Um ID exclusivo atribuído a cada participante.

ParticipantTag

Cada participante da chamada recebe uma etiqueta, LEG-A ouLEG-B.

To

O número de telefone "para" do participante, no formato E.164.

From

O número de telefone “de” do participante, no formato E.164.

Direction

A direção de onde vem um trecho de chamada. Inbound representa uma chamada feita para o serviço de áudio. Outbound representa uma chamada feita a partir do serviço de áudio.

StartTimeInMilliseconds

O tempo de espera em milissegundos, começando quando um participante entra em uma chamada.

Status

Se um participante está Connected ou Disconnected

Tipos de eventos

O serviço de áudio invoca a função do Lambda com esses tipos de eventos:

NEW_INBOUND_CALL

Uma nova chamada foi iniciada por um número de telefone associado ao seu aplicativo de mídia SIP.

NEW_OUTBOUND_CALL

Uma nova chamada externa foi feita por meio da CreateSipMediaApplicationCallAPI.

ACTION_SUCCESSFUL

Uma ação retornada de sua AWS Lambda função foi bem-sucedida. Ações bem-sucedidas incluem ActionData que correspondem à ação bem-sucedida.

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

ACTION_FAILED

Uma ação retornada de sua AWS Lambda função não foi bem-sucedida. As ações malsucedidas incluem ActionData que correspondem à ação com falha, um tipo de erro e uma mensagem de erro que descreve a falha:

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

ACTION_INTERRUPTED

Uma ação no processo de execução foi interrompida por uma invocação UpdateSipMediaApplicationCallda API. ActionData inclui as ações interrompidas:

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

HANGUP

Um usuário ou o aplicativo desligou um trecho de chamada. ActionData inclui os seguintes detalhes sobre o evento:

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

Type

Hangup.

Parameters

As informações sobre o evento HANGUP:

• SipResponseCode— O código de resposta associado ao evento. Os códigos mais comuns são:

  • 0 – Limpeza normal

  • 480 – Sem resposta

  • 486 – Usuário ocupado

• CallIdO ID do participante que desligou.

• ParticipantTagA etiqueta do participante que desligou.

CALL_ANSWERED

O serviço de áudio atendeu e uma chamada de entrada foi atendida. Esse evento é retornado em uma chamada discada, a menos que a chamada seja interliga seja ancorada.

INVALID_LAMBDA_RESPONSE

A resposta fornecida à última AWS Lambda invocação causou um problema. ActionData inclui esses campos adicionais:

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

DIGITS_RECEIVED

O aplicativo recebeu dígitos do DTMF após a conclusão de uma ação ReceiveDigits. ActionData inclui os dígitos recebidos.

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

CALL_UPDATE_REQUESTED

A UpdateSipMediaApplicationCallAPI foi invocada. ActionData inclui informações sobre a solicitação de atualização:

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

RINGING

Um trecho de chamada está tocando