Pemecahan masalah kode respons akhir panggilan untuk Memanggil SDK, Call Automation SDK, PSTN, Chat SDK, dan SMS SDK
Artikel ini menjelaskan pemecahan masalah kode respons akhir panggilan untuk Memanggil SDK, Otomatisasi Panggilan, dan panggilan PSTN.
Kiat pemecahan masalah
Pertimbangkan tips berikut saat memecahkan masalah:
- Aplikasi Anda tidak menerima
IncomingCall Event Gridperistiwa: Pastikan titik akhir aplikasi divalidasi dengan Event Grid saat membuat langganan peristiwa. Status provisi untuk langganan peristiwa Anda ditandai sebagai berhasil jika validasi berhasil. - Untuk kesalahan
The field CallbackUri is invalid: Automasi Panggilan tidak mendukung titik akhir HTTP. Pastikan URL panggilan balik yang Anda berikan mendukung HTTPS. - Tindakan
PlayAudiotidak memutar apa pun: Saat ini hanya format File gelombang (.wav) yang didukung untuk file audio. Konten audio dalam file gelombang harus mono (saluran tunggal), sampel 16-bit dengan laju pengambilan sampel 16.000 (16 KHz). - Tindakan pada titik akhir PSTN tidak berfungsi: Untuk
CreateCall, ,TransferAddParticipant, danRedirectke nomor telepon, Anda perlu mengaturSourceCallerIddalam permintaan tindakan. Kecuali Anda menggunakan perutean langsung, ID pemanggil sumber harus berupa nomor telepon yang dimiliki oleh sumber daya Communication Services Anda agar tindakan berhasil.
Untuk informasi selengkapnya tentang masalah yang dilacak oleh tim produk, lihat Masalah yang diketahui.
Catatan
Kategori Pesan dan Hasil yang tercantum dalam tabel berikut ini berada dalam pratinjau publik. Untuk mengetahui informasi selengkapnya, lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.
Memahami kesalahan kode panggilan dan subkode
Kode kesalahan, subkode, dan kategori hasil yang sesuai membantu pengembang mengidentifikasi dan mendiagnosis kesalahan. Kode kesalahan ini diekspos melalui properti call.callEndReason setelah panggilan berakhir.
Detail kode kesalahan meliputi:
Kode - adalah bilangan bulat 3 digit yang mewakili status respons klien atau server. Kategori kode:
- Respons yang berhasil (200-299)
- Kesalahan klien (400-499)
- Kesalahan server (500-599)
- Kesalahan global (600-699)
Subkode - Didefinisikan sebagai bilangan bulat, di mana setiap angka menunjukkan alasan unik, khusus untuk sekelompok skenario atau hasil skenario tertentu.
Pesan - Menjelaskan hasilnya, dan memberikan petunjuk cara mengurangi masalah jika hasilnya gagal.
ResultCategory - Menunjukkan jenis kesalahan. Tergantung pada konteksnya, nilainya bisa , Success, ExpectedError, UnexpectedClientErroratau UnexpectedServerError.
Kode kesalahan dan subkode klien Azure Communication Services Calling SDK
Untuk kesalahan klien, jika properti resultCategories adalah ExpectedError, kesalahan diharapkan dari perspektif SDK. Kesalahan tersebut biasanya terjadi dalam kegagalan prasyarat, seperti argumen yang salah yang diteruskan oleh aplikasi, atau ketika status sistem saat ini tidak mengizinkan panggilan API. Aplikasi harus memeriksa alasan kesalahan dan logika untuk memanggil API.
| Subcode | Kode | Pesan | Kategori hasil | Saran |
|---|---|---|---|---|
| 40101 | 408 | Gagal membuat CallAgent. Coba lagi, jika masalah berlanjut, kumpulkan log konsol browser, .HAR file, dan hubungi dukungan Azure Communication Services. |
UnexpectedClientError | |
| 40104 | 408 | Gagal membuat CallAgent. Coba lagi, jika masalah berlanjut, kumpulkan log konsol browser, .HAR file, dan hubungi dukungan Azure Communication Services. |
UnexpectedClientError | |
| 40114 | 408 | Gagal menyambungkan ke infrastruktur Azure Communication Services. Coba lagi dan periksa permintaan jaringan browser. Jika permintaan terus gagal, kumpulkan log konsol browser, .HAR file, dan hubungi dukungan Azure Communication Services. |
UnexpectedClientError | Untuk informasi selengkapnya, lihat persyaratan jaringan. |
| 40115 | 412 | Gagal membuat CallAgent, tidak dapat menginisialisasi koneksi ke infrastruktur Azure Communication Services. Coba lagi dan periksa permintaan jaringan browser. Jika permintaan terus gagal, kumpulkan log konsol browser, .HAR file, dan hubungi dukungan Azure Communication Services. |
UnexpectedClientError | Untuk informasi selengkapnya, lihat persyaratan jaringan. |
| 40216 | 500 | Gagal membuat CallAgent. Coba lagi, jika masalah berlanjut, kumpulkan log konsol browser dan hubungi dukungan Azure Communication Services. | UnexpectedClientError | |
| 40228 | 409 | Gagal membuat CallAgent, contoh CallAgent yang terkait dengan identitas ini sudah ada. Buang CallAgent yang ada, atau buat yang baru dengan identitas yang berbeda. | ExpectedError | |
| 40230 | 409 | Gagal membuat TeamsCallAgent, instans TeamsCallAgent yang terkait dengan identitas ini sudah ada. Buang TeamsCallAgent yang ada sebelum membuat yang baru. | ExpectedError | |
| 40606 | 405 | Gagal menghitung speaker, tidak didukung untuk menghitung/memilih speaker di Android Chrome, iOS Safari, atau macOS Safari. | ExpectedError | Enumerasi/pilihan pembicara tidak didukung di Android Chrome, iOS Safari, atau macOS Safari. Sistem operasi secara otomatis memilih speaker (perangkat output). Pelajari selengkapnya tentang manajemen perangkat dan cara terbaik mengurangi masalah ini. |
| 40613 | 400 | Gagal mendapatkan izin untuk penggunaan mikrofon dan/atau kamera, itu ditolak atau gagal. Pastikan untuk mengizinkan izin di browser dan di pengaturan OS. | ExpectedError | Pelajari selengkapnya tentang cara terbaik menangani izin perangkat. |
| 40614 | 500 | Gagal meminta izin perangkat Pastikan untuk mengizinkan izin di pengaturan browser dan di pengaturan OS, lalu coba lagi. Jika masalah berlanjut, kumpulkan log konsol browser dan hubungi dukungan Azure Communication Services. | UnexpectedClientError | Pelajari selengkapnya tentang cara terbaik menangani izin perangkat. |
| 41006 | 400 | Gagal menerima panggilan masuk, panggilan tidak dalam status Dering. Berlangganan ke acara CallAgent incomingCall untuk menerima panggilan masuk. |
ExpectedError | Lihat artikel berikut untuk mengidentifikasi akar penyebab masalah - Menerima panggilan masuk - Berlangganan peristiwa SDK |
| 41007 | 400 | Gagal menolak panggilan masuk, panggilan tidak dalam status Dering. Berlangganan peristiwa CallAgent incomingCall untuk menolak panggilan masuk. |
ExpectedError | Lihat artikel berikut untuk mengidentifikasi akar penyebab masalah - Menerima panggilan masuk - Berlangganan peristiwa SDK |
| 41015 | 500 | Gagal mematikan suara mikrofon. Coba lagi, jika masalah berlanjut, kumpulkan log konsol browser dan hubungi dukungan Azure Communication Services. | UnexpectedClientError | |
| 41016 | 400 | Gagal menyalakan suara mikrofon. Coba lagi, jika masalah berlanjut, kumpulkan log konsol browser dan hubungi dukungan Azure Communication Services. | UnexpectedClientError | |
| 41025 | 400 | Gagal memulai video, instans LocalVideoStream tidak valid atau kosong. Berikan instans LocalVideoStream. | ExpectedError | Pastikan objek yang diteruskan untuk memulai video adalah instans LocalVideoStream. Buat LocalVideoStream menggunakan VideoDeviceInfo objek atau MediaStream objek. Lihat artikel berikut untuk mengidentifikasi akar penyebab masalah: - Melakukan panggilan dengan kamera video - Mulai dan berhenti mengirim video lokal saat melakukan panggilan - Mengakses video mentah |
| 41027 | 400 | Gagal memulai video, video sudah dimulai. | ExpectedError | Tautan bermanfaat: - Melakukan panggilan dengan kamera video - Mulai dan berhenti mengirim video lokal saat melakukan panggilan |
| 41030 | 400 | Gagal menghentikan video, video sudah dihentikan. | ExpectedError | Tautan bermanfaat: - Melakukan panggilan dengan kamera video - Mulai dan berhenti mengirim video lokal saat melakukan panggilan |
| 41032 | 400 | Gagal menghentikan video, argumen tidak valid. LocalVideoStream yang digunakan sebagai input saat ini tidak dikirim. | ExpectedError | LocalVideoStream yang dikirim dalam panggilan, disimpan dalam array Call.localVideoStreams[], dan berjenis Video atau RawMedia. Lihat artikel berikut untuk mengidentifikasi akar penyebab masalah: - Melakukan panggilan dengan kamera video - Mulai dan berhenti mengirim video lokal saat melakukan panggilan - Mengakses video mentah |
| 41033 | 500 | Gagal menahan panggilan. Coba lagi, jika masalah berlanjut, kumpulkan log konsol browser dan hubungi dukungan Azure Communication Services. | UnexpectedClientError | |
| 41034 | 500 | Gagal melanjutkan panggilan. Coba lagi, jika masalah berlanjut, kumpulkan log konsol browser dan hubungi dukungan Azure Communication Services. | UnexpectedClientError | |
| 41035 | 400 | Gagal memulai berbagi layar, berbagi layar sudah dimulai. | ExpectedError | Pelajari selengkapnya tentang cara memulai dan menghentikan berbagi layar saat melakukan panggilan |
| 41041 | 400 | Gagal menghentikan berbagi layar, berbagi layar sudah dihentikan. | ExpectedError | Pelajari selengkapnya tentang cara memulai dan menghentikan berbagi layar saat melakukan panggilan |
| 41048 | 410 | Gagal memulai video selama proses penyetelan panggilan. Pastikan untuk mengizinkan izin video di pengaturan browser dan di pengaturan OS, dan pastikan perangkat kamera tidak digunakan oleh proses lain. | UnexpectedClientError | - Perangkat kamera mungkin dinonaktifkan dalam sistem. - Kamera sedang digunakan oleh proses lain. |
| 41056 | 412 | Gagal memulai atau bergabung ke panggilan, kebijakan suara Teams Enterprise tidak diaktifkan untuk sumber daya Azure Communication Services ini. Ikuti tutorial online untuk mengaktifkannya. | ExpectedError | Lihat tentang cara mengaktifkan pengguna untuk Enterprise Voice online dan Sistem Telepon Voicemail untuk mengaktifkan kebijakan suara Teams Enterprise |
| 41071 | 412 | Gagal memulai berbagi layar, panggilan tidak dalam status Tersambung. Berlangganan ke peristiwa Panggilan statteChanged untuk mengetahui kapan panggilan tersambung. |
ExpectedError | Tautan bermanfaat: - Periksa properti panggilan - Berlangganan peristiwa SDK |
| 41073 | 412 | Gagal mendapatkan atau mengatur MediaStream kustom, fungsionalitas ini saat ini dinonaktifkan oleh Azure Communication Services. | ExpectedError | |
| 43000 | 412 | Gagal memulai video, perangkat video sedang digunakan oleh proses/aplikasi lain. Hentikan kamera Anda agar tidak digunakan dalam proses/aplikasi lain, lalu coba lagi. | ExpectedError | Pahami selengkapnya tentang cara terbaik menangani kamera yang digunakan oleh proses lain |
| 43001 | 403 | Gagal memulai video, izin tidak diberikan untuk menggunakan perangkat video yang dipilih. Pastikan izin perangkat video diizinkan di pengaturan browser dan di pengaturan sistem. | ExpectedError | Pastikan izin kamera diizinkan di pengaturan browser dan pengaturan sistem perangkat. Pastikan kamera tidak dinonaktifkan di pengaturan sistem perangkat. Di macOS, pastikan perekaman layar diizinkan dari pengaturan sistem. Tautan bermanfaat: - Meminta izin perangkat- Izin berbagi layar di macOS - Menghitung atau mengakses perangkat untuk Safari di macOS dan iOS |
| 43002 | 500 | Gagal memulai video, kesalahan tidak diketahui. Coba lagi. Jika masalah berlanjut, hubungi dukungan Azure Communication Services. | UnexpectedClientError | |
| 43004 | 400 | Gagal beralih perangkat video, input tidak valid. Input harus berjenis VideoDeviceInfo. | ExpectedError | Gunakan manajer perangkat untuk mendapatkan daftar objek VideoDeviceInfo, lalu gunakan objek VideoDeviceInfo untuk mengalihkan sumber. Pelajari selengkapnya tentang cara memulai dan berhenti mengirim video lokal saat dalam panggilan |
| 43005 | 400 | Gagal beralih perangkat video, tidak dapat beralih ke perangkat video yang sama, perangkat video tersebut sudah dipilih. | ExpectedError | |
| 43013 | 412 | Gagal memulai video, tidak ada perangkat video yang ditemukan. Pastikan perangkat video dicolokkan dan diaktifkan di pengaturan sistem. | ExpectedError | Pastikan Anda memiliki kamera yang terhubung dan terinstal di perangkat Anda. |
| 43014 | 412 | Gagal memulai video, kesalahan saat meminta aliran media. Coba lagi, jika masalah berlanjut, hubungi dukungan Azure Communication Services. | UnexpectedClientError | |
| 43015 | 412 | Gagal memulai video, waktu permintaan streaming media habis. Izinkan izin pada perintah browser untuk mengakses kamera dan coba lagi. | ExpectedError | Kesalahan ini dapat terjadi jika pengguna tidak mengambil tindakan pada permintaan izin browser untuk mengizinkan akses ke kamera. |
| 43016 | 412 | Gagal memulai video, izin ditolak oleh sistem. Pastikan izin perangkat video diizinkan di pengaturan browser dan di pengaturan sistem. | ExpectedError | - Pastikan izin kamera diizinkan di pengaturan browser dan pengaturan sistem perangkat. - Pastikan kamera tidak dinonaktifkan di pengaturan sistem perangkat. - Di macOS, pastikan perekaman layar diizinkan dari pengaturan sistem. Tautan bermanfaat: - Meminta izin perangkat -Izin berbagi layar di macOS - Menghitung atau mengakses perangkat untuk Safari di macOS dan iOS |
| 43017 | 412 | Gagal memulai video, aliran yang tidak didukung. Coba lagi, jika masalah berlanjut, hubungi dukungan Azure Communication Services. | UnexpectedClientError | |
| 43018 | 412 | Gagal memulai video, gagal mengatur batasan. Coba lagi, jika masalah berlanjut, hubungi dukungan Azure Communication Services. | UnexpectedClientError | Pelajari selengkapnya tentang cara mengatur batasan video |
| 43019 | 412 | Gagal memulai video, tidak ada perangkat yang dipilih. Pastikan untuk melewati LocalVideoStream yang dibangun dengan VideoDeviceInfo dan coba lagi. Jika masalah berlanjut, hubungi dukungan Azure Communication Services. | UnexpectedClientError | Tautan bermanfaat: - Melakukan panggilan dengan kamera video - Mulai dan berhenti mengirim video lokal saat melakukan panggilan |
| 43200 | 412 | Gagal merender aliran video, aliran ini tidak tersedia. Berlangganan ke properti streaming yang dapat tersedia untuk mendapatkan pemberitahuan ketika peserta jarak jauh mengaktifkan video mereka dan streaming tersedia untuk penyajian. | ExpectedError | Tautan bermanfaat: - Merender streaming video/screensharing peserta jarak jauh - Menambahkan panggilan video 1:1 ke aplikasi Anda - Berlangganan peristiwa SDK |
| 43202 | 404 | Gagal merender aliran video, aliran ini tidak lagi tersedia. Peserta jarak jauh menonaktifkan video mereka. | ExpectedError | Peserta jarak jauh menonaktifkan video mereka saat mencoba membuat tampilan untuk video tersebut. |
| 43203 | 408 | Gagal merender streaming video, waktu rendering habis saat menunggu bingkai video. Coba lagi, jika masalah berlanjut, hubungi dukungan Azure Communication Services. | UnexpectedClientError | |
| 43204 | 500 | Gagal merender streaming video, gagal berlangganan video pada infrastruktur Azure Communication Services. Coba lagi, jika masalah berlanjut, hubungi dukungan Azure Communication Services. | UnexpectedClientError | |
| 43209 | 405 | Gagal merender aliran video, VideoStreamRenderer dibuang selama proses inisialisasi. | ExpectedError | |
| 43210 | 400 | Gagal membuang VideoStreamRenderer karena sudah dibuang. | ExpectedError | |
| 43220 | 400 | Gagal membuat tampilan, jumlah maksimum tampilan aktif RemoteVideoStream sudah tercapai. Anda dapat membuang yang sebelumnya untuk membuat yang baru. |
ExpectedError | Pelajari selengkapnya tentang cara mendukung jumlah streaming video masuk terbaik dengan benar |
| 480 | Titik akhir jarak jauh klien tidak terdaftar. | Pastikan bahwa titik akhir jarak jauh tersedia. | ||
| 481 | Gagal menangani panggilan masuk. | Ajukan permintaan dukungan melalui portal Azure. | ||
| 487 | Panggilan dibatalkan, ditolak secara lokal, berakhir karena masalah ketidakcocokan titik akhir, atau gagal menghasilkan penawaran media. | Perilaku yang diharapkan. | ||
| 490, 491, 496, 497, 498 | Masalah jaringan titik akhir lokal. | Periksa jaringan Anda. | ||
| 503, 504 | Kesalahan infrastruktur Communication Services. | Ajukan permintaan dukungan melalui portal Azure. | ||
| 600 | Sibuk di mana-mana. Peserta berhasil dihubungi tetapi mengembalikan sinyal sibuk. | Perilaku yang diharapkan. | ||
| 603 | Panggilan ditolak secara global oleh peserta Communication Services jarak jauh. | Perilaku yang diharapkan. | ||
| 604 | Tidak ada di mana saja. URI yang diminta tidak ada. | Perilaku yang diharapkan. | ||
| 606 | Tidak dapat diterima. Peserta berhasil dihubungi tetapi tidak dapat mendukung sesi yang dijelaskan. | Perilaku yang diharapkan. |
Memahami kesalahan kode panggilan dan subkode
Kode kesalahan, subkode, dan kategori hasil yang sesuai membantu pengembang mengidentifikasi dan mendiagnosis kesalahan. Kode kesalahan ini diekspos melalui properti call.callEndReason setelah panggilan berakhir.
Detail kode kesalahan meliputi:
Kode - adalah bilangan bulat 3 digit yang mewakili status respons klien atau server. Kategori kode:
- Respons yang berhasil (200-299)
- Kesalahan klien (400-499)
- Kesalahan server (500-599)
- Kesalahan global (600-699)
Subkode - Didefinisikan sebagai bilangan bulat, di mana setiap angka menunjukkan alasan unik, khusus untuk sekelompok skenario atau hasil skenario tertentu.
Pesan - Menjelaskan hasilnya, dan memberikan petunjuk cara mengurangi masalah jika hasilnya gagal.
ResultCategory - Menunjukkan jenis kesalahan. Tergantung pada konteksnya, nilainya bisa , Success, ExpectedError, UnexpectedClientErroratau UnexpectedServerError.
Memanggil Kode panggilan akhir dan subkode
Ada penjelasan berbeda mengapa panggilan berakhir. Berikut adalah arti akhir kode panggilan dan subkode yang menunjukkan bagaimana panggilan dapat berakhir.
| Subcode | Kode | Pesan | Kategori Hasil | Saran |
|---|---|---|---|---|
| 0 | 0 | Panggilan berakhir dengan sukses oleh peserta lokal. | Berhasil | |
| 0 | 487 | Panggilan berhasil berakhir karena penelepon membatalkan panggilan. | Berhasil | |
| 0 | 603 | Panggilan berhasil berakhir karena ditolak dari penerima panggilan. | Berhasil | |
| 3100 | 410 | Penyetelan panggilan gagal karena masalah jaringan yang tidak terduga pada klien, silakan periksa jaringan klien dan coba lagi. | UnxpectedClientError | - Pastikan Anda menggunakan SDK terbaru di lingkungan yang didukung. |
| 3101 | 410 | Panggilan dihentikan karena masalah jaringan yang tidak terduga pada klien, silakan periksa jaringan klien dan coba lagi. | UnxpectedClientError | |
| 3112 | 410 | Penyetelan panggilan gagal karena masalah konfigurasi jaringan di sisi klien, silakan periksa konfigurasi jaringan klien, dan coba lagi. | ExpectedError | |
| 4097 | 0 | Panggilan berakhir untuk semua pengguna oleh penyelenggara rapat. | Berhasil | |
| 4507 | 495 | Panggilan berakhir karena aplikasi tidak menyediakan token Azure Communication Services yang valid. | UnexpectedClientError | Pastikan aplikasi Anda menerapkan mekanisme refresh token dengan benar. |
| 4521 | 0 | Panggilan berakhir karena pengguna terputus dari panggilan secara tiba-tiba. Ini mungkin disebabkan oleh pengguna yang menutup aplikasi yang menghosting panggilan, seperti pengguna menghentikan aplikasi dengan menutup tab browser tanpa menutup telepon yang tepat. | ExpectedError | |
| 5000 | 0 | Panggilan berakhir untuk peserta ini. Peserta dihapus dari percakapan oleh peserta lain. | Berhasil | |
| 5003 | 0 | Panggilan berhasil berakhir, karena semua titik akhir penerima panggilan menolak panggilan. | Berhasil | |
| 5300 | 0 | Panggilan berakhir untuk peserta ini. Peserta dihapus dari percakapan oleh peserta lain. | Berhasil | |
| 5317 | 0 | Peserta target dihapus karena pembaruan peran peserta. | ExpectedError | |
| 5828 | 403 | Gabungan tidak berwenang untuk rapat Ruang karena pengguna bukan bagian dari daftar undangan. | UnexpectedClientError | |
| 5829 | 403 | Gabungan tidak diperbolehkan untuk rapat Ruang di luar waktu akhir atau sebelum waktu mulai rapat. | UnexpectedClientError | |
| 5830 | 403 | Hanya pengguna Communication Services yang diizinkan untuk bergabung dalam rapat Ruang. | ExpectedError | |
| 7000 | 0 | Panggilan diakhir oleh platform Azure Communication Services. | Berhasil | |
| 10003 | 487 | Panggilan diterima di tempat lain, oleh titik akhir lain pengguna ini. | Berhasil | |
| 10004 | 487 | Panggilan dibatalkan pada waktu habis, tidak ada titik akhir penerima panggilan yang diterima tepat waktu. Pastikan pengguna melihat pemberitahuan dan mencoba memulai panggilan itu lagi. | ExpectedError | |
| 10024 | 487 | Panggilan berhasil berakhir. Panggilan ditolak oleh semua titik akhir callee. | Berhasil | - Cobalah untuk melakukan panggilan lagi. |
| 10057 | 408 | Panggilan gagal, callee gagal menyelesaikan penyiapan panggilan, kemungkinan besar callee kehilangan jaringan atau menghentikan aplikasi secara tiba-tiba. Pastikan klien terhubung dan tersedia. | ExpectedError | |
| 301005 | 410 | Peserta dihapus dari panggilan oleh infrastruktur Azure Communication Services karena hilangnya konektivitas media dengan infrastruktur yang sama. Ini biasanya terjadi jika peserta meninggalkan panggilan secara tiba-tiba atau kehilangan konektivitas jaringan. Jika peserta ingin melanjutkan panggilan, mereka dapat tersambung kembali. | UnexpectedClientError | Pastikan Anda menggunakan SDK terbaru di lingkungan yang didukung. |
| 510403 | 403 | Panggilan berakhir, sebelumnya ditandai sebagai spam dan sekarang diblokir. | ExpectedError | - Pastikan token Communication Services Anda valid dan tidak kedaluwarsa. - Pastikan untuk meneruskan AlternateId dalam opsi panggilan. |
| 540487 | 487 | Panggilan berhasil berakhir karena penelepon membatalkan panggilan. | Berhasil | |
| 560000 | 0 | Panggilan berakhir dengan sukses oleh peserta PSTN jarak jauh. | Berhasil | Kemungkinan penyebabnya: - Pengguna mengakhiri panggilan. - Panggilan diakhir oleh agen media. |
| 560486 | 486 | Panggilan berakhir karena peserta PSTN jarak jauh sibuk. Nomor yang dipanggil sudah dalam panggilan atau mengalami masalah teknis. | ||
| 404 | Panggilan tidak ditemukan. | Pastikan bahwa nomor yang Anda hubungi (atau panggilan yang Anda ikuti) ada. | ||
| 408 | Kontroler panggilan kehabisan waktu. | Kontroler Panggilan kehabisan waktu menunggu pesan protokol dari titik akhir pengguna. Pastikan klien terhubung dan tersedia. | ||
| 410 | Tumpukan media lokal atau galat infrastruktur media. | Pastikan Anda menggunakan SDK terbaru di lingkungan yang didukung. | ||
| 430 | Tak bisa menyampaikan pesan ke aplikasi klien. | Pastikan aplikasi klien berjalan dan tersedia. | ||
| 480 | Titik akhir jarak jauh klien tidak terdaftar. | Pastikan bahwa titik akhir jarak jauh tersedia. | ||
| 481 | Gagal menangani panggilan masuk. | Ajukan permintaan dukungan melalui portal Azure. | ||
| 490, 491, 496, 497, 498 | Masalah jaringan titik akhir lokal. | Periksa jaringan Anda. | ||
| 500, 503, 504 | Kesalahan infrastruktur Communication Services. | Ajukan permintaan dukungan melalui portal Azure. |
Kode kesalahan SDK Automation Panggilan
Kode kesalahan berikut diekspos oleh Call Automation SDK.
| SubCode | Kode | Pesan | Kategori Hasil | Saran |
|---|---|---|---|---|
| 400 | Permintaan Buruk | Permintaan input tidak valid. Lihat pesan kesalahan untuk menentukan input mana yang salah. | ||
| 400 | Gagal Main | Pastikan file audio Anda adalah WAV, 16 KHz, atau Mono, dan pastikan URL file dapat diakses secara publik. | ||
| 400 | Mengenali Gagal | Periksa pesan kesalahan. Pesan menyoroti apakah kegagalan ini disebabkan oleh batas waktu tercapai atau jika operasi dibatalkan. Untuk informasi selengkapnya tentang kode kesalahan dan pesan, lihat mengumpulkan input pengguna. | ||
| 401 | Tidak diizinkan | Autentikasi HMAC gagal. Verifikasi apakah string koneksi yang digunakan untuk membuat CallAutomationClient sudah benar. | ||
| 403 | Terlarang | Permintaan dilarang. Pastikan Anda dapat memiliki akses ke sumber daya yang coba Anda akses. | ||
| 404 | Sumber daya tidak ditemukan | Panggilan yang anda coba tindakkan tidak ada. Misalnya, mentransfer panggilan yang sebelumnya terputus. | ||
| 429 | Terlalu banyak permintaan | Coba lagi setelah penundaan yang disarankan di header Coba Lagi-Setelah, lalu backoff eksponensial. | ||
| 500 | Kesalahan server internal | Coba lagi setelah penundaan. Jika berlanjut, ajukan tiket dukungan. | ||
| 500 | Gagal Main | Ajukan permintaan dukungan melalui portal Azure. | ||
| 500 | Mengenali Gagal | Periksa pesan kesalahan dan konfirmasikan format file audio valid (WAV, 16 KHz, Mono). Jika format file valid, ajukan permintaan dukungan melalui portal Azure. | ||
| 502 | Gateway buruk | Coba lagi setelah penundaan dengan klien http baru. | ||
| 503,504 | Kesalahan infrastruktur Communication Services. | Ajukan permintaan dukungan melalui portal Azure. |
Kode respons panggilan PSTN dengan ParticipantEndReason
Bagian ini menyediakan informasi pemecahan masalah untuk berbagai kombinasi ParticipantEndReason kode respons dan ParticipantEndSubCode . Untuk tabel di bagian ini, ParticipantEndReason = Kode danParticipantEndSubCode = SubKode.
PesertaEndReason 0
Respons ParticipantEndReason dengan nilai 0 biasanya berarti penghapusan panggilan normal dan menandai panggilan yang selesai tanpa kesalahan.
| SubCode | Kode | Pesan | Kategori Hasil | Saran |
|---|---|---|---|---|
| 0 | 0 | Panggilan berakhir dengan sukses oleh peserta lokal. | Berhasil | |
| 560000 | 0 | Akhir panggilan PSTN normal: - Pengguna mengakhiri panggilan. - Panggilan diakhir oleh agen media. |
Berhasil | |
| 540000 | 0 | Akhir panggilan PSTN normal: - Pengguna mengakhiri panggilan. - Panggilan diakhir oleh agen media. |
Berhasil |
PesertaEndReason 4xx
Respons ParticipantEndReason dengan nilai 4xx berarti bahwa panggilan tidak tersambung.
| SubCode | Kode | Pesan | Kategori Hasil | Saran |
|---|---|---|---|---|
| 510403 | 403 | Panggilan diblokir: - ID alternatif tidak disediakan untuk panggilan. - Nomor telepon tidak diizinkan oleh pengguna Pengontrol Batas Sesi (SBC). |
- Untuk informasi selengkapnya tentang ID Alternatif, lihat Mengelola panggilan. - Pastikan Anda menentukan ID Alternatif yang valid. Ini harus berupa nomor telepon milik Sumber Daya yang Anda gunakan. - Verifikasi bahwa Anda memiliki Sumber Daya yang Anda gunakan untuk melakukan panggilan. - Untuk panggilan perutean langsung, verifikasi mengapa Pengontrol Batas Sesi Anda melarang panggilan. |
|
| 560403 | 403 | - Panggilan terlarang. - Panggilan dibatalkan. - Panggilan ditolak. |
Pastikan Anda memanggil nomor telepon yang valid dalam format yang benar. Untuk informasi selengkapnya tentang format angka yang didukung, lihat https://en.wikipedia.org/wiki/E.164. | |
| 511532 | 403 | Konfigurasi batang SIP sumber daya tidak ditemukan. | Periksa penyiapan perutean langsung Anda di portal Azure. Untuk informasi selengkapnya, lihat Provisi perutean langsung. | |
| 560404 | 404 | - Nomor telepon tidak ditemukan. - Nomor telepon tidak ditetapkan ke target apa pun. - Nomor telepon tidak diizinkan oleh Pengontrol Batas Sesi. |
- Pastikan nomor telepon milik Sumber Daya yang Anda gunakan dan bahwa Anda memiliki Sumber Daya. - Verifikasi bahwa nomor yang Anda panggil ada, dan ditetapkan ke target yang valid. |
|
| 511404 | 404 | - Nomor telepon tidak ditemukan. - Sumber daya yang digunakan dalam panggilan tidak ditemukan. |
- Pastikan Anda menggunakan nomor telepon milik Sumber Daya yang Anda gunakan dan bahwa Anda memiliki Sumber Daya. - Verifikasi bahwa nomor yang Anda panggil ada, dan ditetapkan ke target yang valid. - Pastikan bahwa Sumber Daya yang Anda gunakan untuk panggilan tidak dihapus atau dinonaktifkan. - Pastikan langganan Azure Anda tidak dihapus atau dinonaktifkan. |
|
| 560408 | 408 | Pihak yang dipanggil tidak menanggapi pesan pembentukan panggilan dalam periode waktu yang ditentukan. | - Periksa kembali mengapa pihak yang dipanggil tidak merespons. - Untuk panggilan perutean langsung, periksa log dan konfigurasi pengaturan dan batas waktu Session Border Control (SBC) Anda. |
|
| 500001 | 408 | Batas waktu gateway pengguna Azure Communication Services tidak menerima respons dari klien dalam batas waktu tertentu dan mengakhiri permintaan. |
- Periksa kembali mengapa pihak yang dipanggil tidak merespons. - Untuk panggilan perutean langsung, periksa konfigurasi log dan pengaturan dan batas waktu SBC Anda. |
|
| 531004 | 410 | Pemeriksaan Pembentukan Konektivitas Interaktif (ICE) gagal. | - Jalur media tidak dapat dibuat. Dapat disebabkan oleh konfigurasi jaringan yang salah. Verifikasi konfigurasi jaringan Anda untuk memastikan bahwa alamat IP dan port yang diperlukan tidak diblokir. Baca panduan di https://www.rfc-editor.org/rfc/rfc5245#section-7. - Untuk panggilan perutean langsung, periksa log dan pengaturan SBC Anda untuk konfigurasi dan profil ICE. Hubungi vendor SBC Anda untuk bantuan konfigurasi. Untuk informasi selengkapnya, lihat Daftar Pengontrol Batas Sesi yang disertifikasi untuk perutean langsung Azure Communication Services. |
|
| 560480 | 480 | - Tidak ada jawaban dari pengguna yang dipanggil. - Disebut pengguna sementara tidak tersedia. |
- Periksa kembali mengapa pihak yang dipanggil tidak merespons. - Coba lagi panggilan nanti jika pihak yang dipanggil sementara tidak tersedia. - Untuk panggilan perutean langsung, periksa konfigurasi log dan pengaturan dan batas waktu SBC Anda. |
|
| 560484 | 484 | - Alamat penerima panggilan tidak lengkap atau tidak valid. - Format nomor penerima panggilan tidak lengkap atau tidak valid. |
- Dalam beberapa kasus, Anda dapat mengabaikan kegagalan ini karena pengguna memutar nomor yang tidak valid. - Pastikan nomor telepon diformat dengan benar. Untuk informasi selengkapnya, lihat https://en.wikipedia.org/wiki/E.164 . - Untuk perutean langsung, SBC dapat menyebabkan kegagalan ini karena konfigurasi yang hilang dalam skenario transfer panggilan. |
|
| 60486 | 486 | Nomor yang dipanggil sibuk | - Nomor yang dipanggil mungkin terhubung ke panggilan yang ada, atau mengalami masalah teknis. - Untuk panggilan perutean langsung, periksa konfigurasi log dan pengaturan dan batas waktu SBC Anda. |
|
| 540487 | 487 | Penelepon menghentikan permintaan panggilan. | Coba lagi panggilannya. | |
| 560487 | 497 | - Penelepon menghentikan permintaan panggilan. - Permintaan dihentikan dengan kliring panggilan normal. |
Coba lagi panggilannya. |
PesertaEndReason 5xx
Respons ParticipantEndReason dengan nilai 5xx berarti bahwa panggilan gagal karena masalah dengan komponen perangkat lunak atau perangkat keras yang diperlukan untuk menyelesaikan koneksi.
| SubCode | Kode | Pesan | Kategori Hasil | Saran |
|---|---|---|---|---|
| 560500 | 500 | Terjadi kesalahan server internal di salah satu layanan yang terlibat dalam panggilan. | - Coba lagi panggilannya. Jika masalah berlanjut, hubungi penyedia telco atau dukungan Microsoft Anda. - Untuk panggilan perutean langsung, periksa konfigurasi log dan pengaturan dan batas waktu SBC Anda, untuk melihat apakah SBC Anda menyebabkan kegagalan. |
|
| 560503 | 503 | - Panggilan gagal karena kesalahan server internal di salah satu layanan yang terlibat dalam panggilan. - Jaringan yang digunakan untuk membuat panggilan tidak berurutan. - Kegagalan sementara di salah satu layanan yang terlibat dalam panggilan. |
- Periksa konfigurasi jaringan dan perutean Anda untuk kemungkinan masalah. Verifikasi bahwa aturan firewall jaringan Anda sudah benar. - Coba lagi panggilannya. Jika masalah berlanjut, hubungi penyedia telco atau dukungan Microsoft Anda. - Untuk panggilan perutean langsung, periksa konfigurasi log dan pengaturan dan batas waktu SBC Anda, untuk melihat apakah SBC Anda menyebabkan kegagalan. |
PesertaEndReason 603
Respons ParticipantEndReason dengan nilai 603 berarti bahwa panggilan ditolak tanpa menyambungkan.
| SubCode | Kode | Pesan | Kategori Hasil | Saran |
|---|---|---|---|---|
| 560603 | 603 | - Panggilan ditolak oleh penerima. - Panggilan ditolak karena deteksi penipuan. |
- Jika ditolak oleh penerima, coba lagi panggilan. - Pastikan Anda tidak melebihi jumlah maksimum panggilan bersamaan yang diizinkan untuk nomor telepon Azure Communication Services Anda. Untuk informasi selengkapnya, lihat Batasan panggilan PSTN. |
Kode galat SDK obrolan
Chat SDK menggunakan kode kesalahan berikut untuk membantu Anda memecahkan masalah obrolan. Kode galat diekspos melalui properti error.code dalam respons kesalahan.
| Kode | Pesan | Saran |
|---|---|---|
| 401 | Tidak diizinkan | Pastikan token Layanan Komunikasi Anda valid dan tidak kedaluwarsa. |
| 403 | Terlarang | Pastikan bahwa inisiator permintaan memiliki akses ke sumber daya. |
| 429 | Terlalu banyak permintaan | Pastikan aplikasi pihak klien Anda menangani skenario ini dengan cara yang mudah digunakan. Jika kesalahan berlanjut, ajukan permintaan dukungan. |
| 503 | Layanan Tidak Tersedia | Ajukan permintaan dukungan melalui portal Azure. |
Kode kesalahan SMS
SMS SDK menggunakan kode kesalahan berikut untuk membantu Anda memecahkan masalah SMS. Kode kesalahan diekspos melalui DeliveryStatusDetails bidang dalam laporan pengiriman SMS.
| Kode | Pesan | Saran |
|---|---|---|
| 2000 | Pesan Berhasil Dikirim. | |
| 4000 | Pesan ditolak karena deteksi penipuan. | Pastikan Anda tidak melebihi jumlah maksimum pesan yang diizinkan untuk nomor Anda. |
| 4001 | Pesan ditolak karena format angka Sumber/Dari tidak valid | Pastikan nomor Ke dalam format E.164 dan Format angka Dari dalam format E.164 atau Kode pendek. |
| 4002 | Pesan ditolak karena format Angka Tujuan/Ke tidak valid. | Pastikan nomor Ke dalam format E.164 |
| 4003 | Pesan gagal dikirim karena tujuan yang tidak didukung. | Periksa apakah tujuan yang coba Anda kirim didukung. |
| 4004 | Pesan gagal dikirim karena Nomor Tujuan/Ke tidak ada. | Pastikan nomor Ke yang Anda kirim valid. |
| 4005 | Pesan diblokir oleh Operator tujuan. | |
| 4006 | Nomor Tujuan/Ke tidak dapat dijangkau. | Coba kirim ulang pesan di lain waktu. |
| 4007 | Nomor Tujuan/Ke memilih untuk tidak menerima pesan dari Anda. | Tandai nomor Tujuan/Ke sebagai ditolak sehingga tidak ada upaya pesan lebih lanjut yang dilakukan ke nomor tersebut. |
| 4008 | Anda melebihi jumlah maksimum pesan yang diizinkan untuk profil Anda. | Pastikan Anda tidak melebihi jumlah maksimum pesan yang diizinkan untuk nomor Anda atau gunakan antrean untuk membuat batch pesan. |
| 4009 | Pesan ditolak oleh Microsoft Entitlement System. | Paling sering ini terjadi jika aktivitas penipuan terdeteksi. Hubungi dukungan untuk detail selengkapnya. |
| 4010 | Pesan diblokir karena nomor bebas ongkos tidak diverifikasi. | Tinjau batas pengiriman yang belum diverifikasi dan kirim verifikasi bebas telunjuk sesegera mungkin. |
| 5000 | Pesan gagal dikirim. Hubungi tim dukungan Microsoft untuk detail selengkapnya. | Ajukan permintaan dukungan melalui portal Azure. |
| 5001 | Pesan gagal dikirim karena tidak tersedianya aplikasi/sistem sementara. | |
| 5002 | Operator tidak mendukung laporan pengiriman | Paling sering ini terjadi jika operator tidak mendukung laporan pengiriman. Tidak ada tindakan yang diperlukan karena pesan mungkin telah dikirimkan. |
| 9999 | Pesan gagal dikirimkan karena kesalahan/kegagalan yang tidak diketahui. | Coba kirim ulang pesan. |