As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
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
ouDisconnected
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