Noções básicas sobre eventos de telefonia do serviço de áudio PSTN do SDK do Amazon Chime - SDK do Amazon Chime
Tipos de eventos

Noções básicas sobre eventos de telefonia do serviço de áudio PSTN do SDK do Amazon Chime

O serviço de áudio invoca sua função AWS AWS Lambda 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 função AWS Lambda. Sempre que sua função é invocada durante uma chamada, a sequência é incrementada.

InvocationEventType

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

CallDetails

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

TransactionId

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

AwsAccountId

O ID da conta da AWS 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 função AWS AWS Lambda.

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 de saída foi feita por meio da API CreateSipMediaApplicationCall.

ACTION_SUCCESSFUL

Uma ação retornada de sua função AWS Lambda 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 função AWS Lambda 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 da API UpdateSipMediaApplicationCall. 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

  • CallID O ID do participante que desligou.

  • ParticipantTag A 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 invocação AWS Lambda 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 API UpdateSipMediaApplicationCall 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