Telefonieereignisse

Der PSTN Audio-Dienst ruft IhreAWS AWS LambdaFunktion, wenn bestimmte Ereignisse während eines Aufrufs auftreten. Das folgende Beispiel zeigt die Ereignisse und Text nach dem Beispiel erklärt jedes Ereignis.

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

Die Version des Schemas, die zum Erstellen dieses Ereignisobjekts verwendet wurde.

Sequence

Die Abfolge von Ereignissen, die Ihre aufrufenAWS LambdaFunktion. Jedes Mal, wenn Ihre Funktion während eines Aufrufs aufgerufen wird, wird die Sequenz erhöht.

invocationEventType

Die Art des Ereignisses, das einAWS LambdaAufruf. Weitere Informationen finden Sie unter Event types (Ereignistypen) an späterer Stelle in diesem Thema.

CallDetails

Informationen über den Anruf im Zusammenhang mit demAWS LambdaAufruf.

TransactionId

Die ID eines Anrufs, der mit einemAWS LambdaAufruf.

AwsAccountId

DieAWSKonto-ID, die mit der SIP-Medienanwendung verknüpft ist, die zum Anruf-Routing führte.

SipMediaApplicationId

Die ID der SIP-Medienanwendung, die mit dem Anruf verknüpft ist.

Teilnehmer

Informationen über die Teilnehmer des Anrufs, der einAWS AWS LambdaFunktion.

CalLid

Eine eindeutige ID, die jedem Teilnehmer zugewiesen ist.

ParticipantTag

Jeder Anrufteilnehmer erhält ein Tag,LEG-AoderLEG-Baus.

Bis

Telefonnummer des Teilnehmers im E.164-Format.

Aus

Telefonnummer des Teilnehmers im E.164-Format.

Richtung

Die Richtung, aus der ein Anruf-Leg kommt.Inboundstellt einen Anruf an den PSTN Audio-Dienst dar.Outboundstellt einen Anruf dar, der vom PSTN Audiodienst getätigt wird.

StartTimeinMilliseConds

Die Epochenzeit in Millisekunden, beginnend mit dem Beitritt eines Teilnehmers an einem Anruf.

Status

Ob ein TeilnehmerConnectedoderDisconnected

Event types (Ereignistypen)

Der PSTN Audio-Dienst ruft die Lambda-Funktion mit folgenden Ereignistypen auf:

NEW_INBOUND_CALL

Ein neuer Anruf wurde durch eine Telefonnummer eingeleitet, die mit Ihrer SIP-Medienanwendung verknüpft ist.

NEW_OUTBOUND_CALL

Ein neuer ausgehender Anruf wurde über dieCreateSipMediaApplicationCallAPI.

ACTION_ERFOLGREICH

Eine Aktion, die von Ihrem zurückgegeben wurdeAWS LambdaFunktion war erfolgreich. Erfolgreiche Aktionen umfassenActionDatadas entspricht der erfolgreichen Aktion.

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

ACTION_FEHLGESCHLAGEN

Eine Aktion, die von Ihrem zurückgegeben wurdeAWS LambdaFunktion war nicht erfolgreich. Zu den erfolglosen Aktionen gehörenActionDatadie mit der fehlgeschlagenen Aktion, einem Fehlertyp und einer Fehlermeldung übereinstimmt, die den Fehler beschreibt:

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

ACTION_UNTERBROCHEN

Eine Aktion während des Laufens wurde durch einupdateSipMediaApplicationCallAPI-Aufruf. DieActionDatabeinhaltet die unterbrochenen Aktionen:

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

AUFHÄNGEN

Ein Benutzer oder die Anwendung legte eine Anrufstrecke auf. DieActionDataenthält diese Details über die Veranstaltung:

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

Typ

Hangup.

Parameter

Die Informationen über dieHANGUPEreignis:

• SipreSponseCode— Der Antwortcode, der mit dem Ereignis verknüpft ist. Die häufigsten Codes sind:

  • 0- Normal Clearing

  • 480- Keine Antwort

  • 486- Benutzer ausgelastet

• CalLidDie ID des Teilnehmers, der aufgelegt hat.

• ParticipantTagDas Tag des Teilnehmers, der aufgelegt hat.

CALL_BEANTWORTET

Der PSTN Audio-Dienst beantwortete ein eingehender Anruf wurde beantwortet. Dieses Ereignis wird bei einem DFÜ-Anruf zurückgegeben, es sei denn, der Anruf wird überbrückt.

INVALID_LAMBDA_RESPONSE

Die Antwort auf die letzteAWS Lambdader Aufruf verursachte ein Problem. DieActionDataenthält diese zusätzlichen Felder:

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

DIGITS_ERHALTEN

Der Antrag erhielt DTMF-Ziffern nach Abschluss einesReceiveDigitsAktion DieActionDataenthält die empfangenen Ziffern.

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

CALL_UPDATE_QUESTED

DieupdateSipMediaApplicationCallDie API wurde aufgerufen. DieActionDataenthält Informationen über die Update-Anfrage:

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

KLINGELN

Ein Anruf-Leg klingelt