텔레포니 이벤트 이해

오디오 서비스는 통화 중에 특정 이벤트가 발생하면AWSAWS Lambda 함수를 호출합니다. 다음 예에서는 이벤트를 보여 주고 예제 뒤의 텍스트는 각 이벤트를 설명합니다.

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

이 이벤트 객체를 만드는 데 사용된 스키마 버전입니다.

Sequence(시퀀스)

AWS Lambda함수를 호출하는 이벤트 시퀀스입니다. 호출 중에 함수가 호출될 때마다 시퀀스가 증가합니다.

InvocationEventType

AWS Lambda호출을 트리거하는 이벤트 유형입니다. 자세한 내용은 이 주제의 후반부에서 이벤트 유형 섹션을 참조하세요.

CallDetails

호출과 관련된 통화에 대한 정보입니다.AWS Lambda

TransactionId

호출과 관련된 통화의AWS Lambda ID입니다.

AwsAccountId

통화 라우팅을 생성한 SIP 미디어 애플리케이션과 연결된AWS 계정 ID입니다.

SipMediaApplicationId

통화와 연결된 SIP 미디어 애플리케이션의 ID입니다.

참여자

AWSAWS Lambda함수를 호출하는 호출 참여자에 대한 정보입니다.

CallId

각 참가자에게 할당된 고유 ID.

ParticipantTag

각 통화 참가자는 태그를LEG-A 받거나LEG-B

To

E.164 형식의 참가자의 전화번호입니다.

From

E.164 형식의 전화번호입니다.

Direction

콜 레그가 오는 방향. Inbound는 오디오 서비스에 걸려온 호출을 나타냅니다. Outbound는 오디오 서비스에서 걸려온 호출을 나타냅니다.

StartTimeInMilliseconds

참가자가 통화에 참여할 때 시작되는 에포크 시간 (밀리초) 입니다.

상태

참가자가 누구인지Connected 여부Disconnected

이벤트 유형

오디오 서비스는 다음과 같은 이벤트 유형을 사용하여 Lambda 함수를 호출합니다.

신규_인바운드_콜

SIP 미디어 애플리케이션과 연결된 전화번호로 새 통화가 시작되었습니다.

신규_아웃바운드_콜

CreateSipMediaApplicationCallAPI를 통해 새 아웃바운드 통화가 이루어졌습니다.

작업 성공

AWS Lambda함수에서 반환된 작업이 성공했습니다. 성공적인 작업에는 성공적인 작업과ActionData 일치하는 작업이 포함됩니다.

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

작업 실패

AWS Lambda함수에서 반환된 작업이 성공하지 못했습니다. 실패한 작업에는 실패한 작업과ActionData 일치하는 항목, 오류 유형 및 실패를 설명하는 오류 메시지가 포함됩니다.

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

액션_인터럽티드

실행 중인 작업이 UpdateSipMediaApplicationCallAPI 호출로 인해 중단되었습니다. 에는 중단된 작업이ActionData 포함됩니다.

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

전화를 끊다

사용자 또는 애플리케이션이 콜 레그를 끊었습니다. 에는 이벤트에 대한ActionData 다음과 같은 세부 정보가 포함됩니다.

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

유형

전화 끊기.

파라미터

HANGUP이벤트에 대한 정보:

• SipResponseCode— 이벤트와 관련된 응답 코드입니다. 가장 일반적인 코드는 다음과 같습니다.

  • 0 — 일반 클리어링

  • 480 — 답변 없음

  • 486 — 사용자 사용 중

• CallId전화를 끊은 참가자의 ID.

• ParticipantTag전화를 끊은 참가자의 태그입니다.

전화_답변 완료

오디오 서비스가 응답했습니다. 걸려오는 전화에 응답했습니다. 이 이벤트는 통화가 브리징되지 않는 한 다이얼아웃 통화 시 반환됩니다.

잘못된 람다_응답

마지막AWS Lambda 호출에 제공된 응답으로 인해 문제가 발생했습니다. 에는ActionData 다음과 같은 추가 필드가 포함됩니다.

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

수신된 자릿수

응용 프로그램은ReceiveDigits 작업 완료 후 DTMF 숫자를 받았습니다. 에는 받은 숫자가ActionData 포함됩니다.

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

통화_업데이트_요청됨

UpdateSipMediaApplicationCallAPI가 호출되었습니다. 에는 업데이트 요청에 대한 정보가ActionData 포함됩니다.

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

울리는

콜 레그가 울린다