Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memahami peristiwa telepon untuk layanan audio Amazon Chime SDK PSTN
<a name="pstn-invocations"></a>

Layanan Audio memanggil AWS AWS Lambda fungsi Anda ketika peristiwa tertentu terjadi selama panggilan. Contoh berikut menunjukkan peristiwa, dan teks setelah contoh menjelaskan setiap peristiwa.

```
{ 
    "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**  
Versi skema yang digunakan untuk membuat objek acara ini.

**Sequence**  
Urutan peristiwa yang memanggil AWS Lambda fungsi Anda. Setiap kali fungsi Anda dipanggil selama panggilan, urutannya bertambah.

**InvocationEventType**  
Jenis acara yang memicu AWS Lambda pemanggilan. Untuk informasi selengkapnya, lihat [Tipe peristiwa](#pstn-event-types) dalam topik ini.

**CallDetails**  
Informasi tentang panggilan yang terkait dengan AWS Lambda doa.

**TransactionId**  
ID panggilan yang terkait dengan AWS Lambda pemanggilan.

**AwsAccountId**  
ID AWS akun yang terkait dengan aplikasi media SIP yang menghasilkan routing panggilan.

**SipMediaApplicationId**  
ID aplikasi media SIP yang terkait dengan panggilan.

**Participants**  
Informasi tentang peserta pada panggilan yang memanggil AWS AWS Lambda fungsi.

**CallId**  
ID unik yang ditetapkan untuk setiap peserta.

**ParticipantTag**  
Setiap peserta panggilan mendapat tag, `LEG-A` atau`LEG-B`.

**To**  
Peserta “ke” nomor telepon, dalam E.164 format.

**From**  
Peserta “dari” nomor telepon, dalam E.164 format.

**Direction**  
Dari arah mana kaki panggilan berasal. `Inbound`merupakan panggilan yang dibuat ke Layanan Audio. `Outbound`merupakan panggilan yang dibuat dari Layanan Audio.

**StartTimeInMilliseconds**  
Waktu epoch dalam milidetik, dimulai saat peserta bergabung dengan panggilan.

**Status**  
Apakah peserta adalah `Connected` atau `Disconnected`

## Tipe peristiwa
<a name="pstn-event-types"></a>

Layanan Audio memanggil fungsi Lambda dengan jenis acara berikut:

**NEW\_INBOUND\_CALL**  
Panggilan baru telah dimulai oleh nomor telepon yang terkait dengan aplikasi media SIP Anda.

**NEW\_OUTBOUND\_CALL**  
Panggilan keluar baru telah dilakukan melalui [CreateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateSipMediaApplicationCall.html)API.

**ACTION\_SUCCESSFUL**  
Tindakan yang dikembalikan dari AWS Lambda fungsi Anda telah berhasil. Tindakan yang berhasil termasuk `ActionData` yang cocok dengan tindakan yang berhasil.   

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

**ACTION\_FAILED**  
Tindakan yang dikembalikan dari AWS Lambda fungsi Anda tidak berhasil. Tindakan yang tidak berhasil termasuk `ActionData` yang cocok dengan tindakan yang gagal, jenis kesalahan, dan pesan kesalahan yang menjelaskan kegagalan:  

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

**ACTION\_INTERRUPTED**  
Tindakan dalam proses menjalankan terganggu oleh pemanggilan [ UpdateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html)API. `ActionData`Termasuk tindakan yang terputus:   

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

**HANGUP**  
Seorang pengguna atau aplikasi menutup kaki panggilan. `ActionData`Termasuk rincian tentang acara ini:  

```
   "ActionData": {
        "Type": "Hangup",
        "Parameters": {
            "SipResponseCode": {{486}},
            "CallId": "{{c70f341a-adde-4406-9dea-1e01d34d033d}}",
            "ParticipantTag": "LEG-A"
        }
    },
```  
**Type**  
Mabuk.  
**Parameters**  
Informasi tentang `HANGUP` acara tersebut:   
+ **SipResponseCode**— Kode respons yang terkait dengan acara tersebut. Kode yang paling umum adalah:
  + **0** — Kliring normal
  + **480** — Tidak ada jawaban
  + **486** - Pengguna sibuk
+ **CallId**ID peserta yang menutup telepon.
+ **ParticipantTag**Tag peserta yang menutup telepon.

**CALL\_ANSWERED**  
Layanan Audio menjawab panggilan masuk dijawab. Acara ini dikembalikan pada panggilan keluar kecuali panggilan dijembatani.

**INVALID\_LAMBDA\_RESPONSE**  
Tanggapan yang diberikan pada AWS Lambda doa terakhir menyebabkan masalah. `ActionData`Termasuk bidang tambahan ini:  

```
    "ErrorType": "{{error-type-1}}", 
    "ErrorMessage": "{{error-msg-1}}"
```

**DIGITS\_RECEIVED**  
Aplikasi menerima digit DTMF setelah menyelesaikan suatu tindakan. `ReceiveDigits` `ActionData`Termasuk digit yang diterima.  

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

**CALL\_UPDATE\_REQUESTED**  
[UpdateSipMediaApplicationCall](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_UpdateSipMediaApplicationCall.html)API dipanggil. `ActionData`Termasuk informasi tentang permintaan pembaruan:  

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

**RINGING**  
Kaki panggilan berdering