Pemecahan masalah di Azure Communication Services
Dokumen ini membantu Anda memecahkan masalah yang mungkin Anda alami dalam solusi Communication Services Anda. Jika anda memecahkan masalah SMS, anda dapat mengaktifkan pelaporan pengiriman dengan Event Grid untuk menangkap detail pengiriman SMS.
Mendapatkan bantuan
Kami mendorong pengembang untuk mengirimkan pertanyaan, menyarankan fitur, dan melaporkan masalah. Untuk informasi selengkapnya, lihat halaman opsi dukungan dan bantuan khusus.
Untuk membantu Anda memecahkan masalah tertentu, Anda mungkin memerlukan satu atau beberapa informasi berikut:
- ID MS-CV: Memecahkan masalah panggilan dan pesan.
- ID Panggilan: Identifikasi panggilan Communication Services.
- ID pesan SMS: Identifikasi pesan SMS.
- ID Singkat Program Kode Pendek: Identifikasi aplikasi singkat program kode pendek.
- ID singkat kampanye verifikasi bebas telunjuk: Identifikasi aplikasi singkat kampanye verifikasi bebas telunjuk.
- ID pesan email: Identifikasi permintaan Kirim Email.
- ID Korelasi: Identifikasi permintaan yang dibuat menggunakan Automasi Panggilan.
- Log panggilan: Berisi informasi terperinci dapat digunakan untuk memecahkan masalah panggilan dan jaringan.
Untuk informasi selengkapnya tentang pembatasan dan batasan, lihat Batas layanan.
Akses ID MS-CV Anda
Anda dapat mengakses ID MS-CV dengan mengonfigurasi diagnostik dalam clientOptions
instans objek saat menginisialisasi SDK Anda. Anda dapat mengonfigurasi diagnostik untuk Azure SDK apa pun termasuk Obrolan, Identitas, dan panggilan VoIP.
Contoh opsi klien
Cuplikan kode berikut menunjukkan konfigurasi diagnostik. Saat Anda mengaktifkan diagnostik untuk SDK, detail diagnostik dapat dipancarkan ke pendengar peristiwa yang dikonfigurasi:
// 1. Import Azure.Core.Diagnostics
using Azure.Core.Diagnostics;
// 2. Initialize an event source listener instance
using var listener = AzureEventSourceListener.CreateConsoleLogger();
Uri endpoint = new Uri("https://<RESOURCE-NAME>.communication.azure.net");
var (token, communicationUser) = await GetCommunicationUserAndToken();
CommunicationUserCredential communicationUserCredential = new CommunicationUserCredential(token);
// 3. Setup diagnostic settings
var clientOptions = new ChatClientOptions()
{
Diagnostics =
{
LoggedHeaderNames = { "*" },
LoggedQueryParameters = { "*" },
IsLoggingContentEnabled = true,
}
};
// 4. Initialize the ChatClient instance with the clientOptions
ChatClient chatClient = new ChatClient(endpoint, communicationUserCredential, clientOptions);
ChatThreadClient chatThreadClient = await chatClient.CreateChatThreadAsync("Thread Topic", new[] { new ChatThreadMember(communicationUser) });
ID Akses yang diperlukan untuk Automasi Panggilan
Saat memecahkan masalah dengan SDK Automasi Panggilan, seperti manajemen panggilan atau masalah perekaman, Anda perlu mengumpulkan ID yang membantu mengidentifikasi panggilan atau operasi yang gagal. Anda dapat memberikan salah satu dari dua ID berikut.
Dari header respons API, temukan bidang
X-Ms-Skype-Chain-Id
.Dari peristiwa panggilan balik, aplikasi Anda menerima setelah menjalankan tindakan. Misalnya
CallConnected
atauPlayFailed
, temukan correlationID.
Selain salah satu ID ini, Anda perlu memberikan detail tentang kasus penggunaan yang gagal dan tanda waktu ketika kegagalan terjadi.
Akses ID panggilan klien Anda
Saat memecahkan masalah panggilan suara atau video, Anda mungkin perlu menyediakan call ID
. Akses nilai ini melalui id
properti call
objek:
// `call` is an instance of a call created by `callAgent.startCall` or `callAgent.join` methods
console.log(call.id)
Akses ID pesan SMS Anda
Untuk masalah SMS, Anda dapat mengambil ID pesan dari objek respons.
// Instantiate the SMS client
const smsClient = new SmsClient(connectionString);
async function main() {
const result = await smsClient.send({
from: "+18445792722",
to: ["+1972xxxxxxx"],
message: "Hello World 👋🏻 via Sms"
}, {
enableDeliveryReport: true // Optional parameter
});
console.log(result); // your message ID is in the result
}
Akses ID singkat program kode pendek Anda
Temukan ID singkat program di portal Azure di bagian Kode Pendek.
Akses ID singkat kampanye verifikasi bebas telunjuk Anda
Temukan ID singkat program pada portal Azure di bagian Dokumen Peraturan.
Mengakses ID operasi email Anda
Saat memecahkan masalah permintaan status kirim email atau pesan email, Anda mungkin perlu memberikan operation ID
. Anda dapat mengakses nilai ini dalam respons:
var emailSendOperation = await emailClient.SendAsync(
wait: WaitUntil.Completed,
senderAddress: sender,
recipientAddress: recipient,
subject: subject,
htmlContent: htmlContent);
/// Get the OperationId so that it can be used for tracking the message for troubleshooting
Console.WriteLine($"Email operation id = {emailSendOperation.Id}");
Mengakses File Dukungan di SDK Panggilan
Memanggil SDK menyediakan metode yang nyaman untuk mengakses File Log. File-file ini dapat berfungsi berharga untuk spesialis dan insinyur dukungan Microsoft. Kami menyarankan agar Anda mengumpulkan log ini saat mendeteksi masalah.
Mengaktifkan dan Mengakses Log Panggilan
[JavaScript]
SDK Panggilan Azure Communication Services bergantung secara internal pada pustaka @azure/pencatat untuk mengontrol pengelogan.
setLogLevel
Gunakan metode dari @azure/logger
paket untuk mengonfigurasi tingkat output log. Buat pencatat dan teruskan ke CallClient
konstruktor sebagai berikut:
import { setLogLevel, createClientLogger, AzureLogger } from '@azure/logger';
setLogLevel('verbose');
let logger = createClientLogger('ACS');
const callClient = new CallClient({ logger });
Anda dapat menggunakan AzureLogger untuk mengalihkan output pengelogan dari Azure SDK dengan mengesampingkan AzureLogger.log
metode :
Anda dapat masuk ke konsol browser, file, buffer, mengirim ke layanan kami sendiri, dan sebagainya. Jika Anda akan mengirim log melalui jaringan ke layanan Anda sendiri, jangan mengirim permintaan per baris log karena ini berdampak buruk pada performa browser. Sebagai gantinya, akumulasi baris log dan kirim dalam batch.
// Redirect log output
AzureLogger.log = (...args) => {
// To console, file, buffer, REST API, etc...
console.log(...args);
};
SDK Asli (Android/iOS)
Untuk Android, iOS, dan Windows, Azure Communication Services Calling SDK menawarkan akses ke file log.
Untuk Memanggil SDK Asli, lihat tutorial Akses file log
Pustaka UI (Android, iOS)
Jika Anda menggunakan Pustaka UI Azure Communication Services untuk Android atau iOS, Anda dapat meminta umpan balik pengguna melalui formulir dukungan bawaan.
Untuk informasi selengkapnya tentang fungsi dukungan formulir Dukungan Antarmuka Pengguna Panggilan, lihat tutorial integrasi Formulir Dukungan. Dokumen ini memandu Anda menambahkan penanganan aktivitas yang diperlukan, dan membuat implementasi klien/server dasar untuk penyimpanan informasi dukungan terpusat. Panduan ini menjelaskan jalur untuk mengintegrasikan dengan layanan dukungan yang digunakan oleh organisasi Anda.
Membangun Alur Dukungan menyeluruh dalam Integrasi ACS Anda
Baik Anda menggunakan SDK Panggilan atau Memanggil UI SDK, memberikan dukungan kepada pelanggan Anda adalah komponen utama dari integrasi yang kuat. Dokumen berikut menyoroti pertimbangan utama di setiap titik perulangan umpan balik Dukungan, dan menyediakan titik lompat untuk mempelajari lebih lanjut.
Menemukan informasi Microsoft Entra
- Mendapatkan ID Direktori
- Mendapatkan ID Aplikasi
- Mendapatkan ID Pengguna
Mendapatkan ID Direktori
Untuk menemukan ID Direktori (penyewa) Anda, ikuti langkah-langkah berikut:
Navigasi ke portal Azure dan masuk ke portal Azure menggunakan kredensial.
Dari panel kiri, pilih ID Microsoft Entra.
Dari halaman Gambaran Umum di ID Microsoft Entra, salin ID Direktori (penyewa) dan simpan di kode aplikasi Anda.
Mendapatkan ID Aplikasi
Untuk menemukan ID Aplikasi Anda, ikuti langkah-langkah berikut:
Navigasi ke portal Azure dan masuk ke portal Azure menggunakan kredensial.
Dari panel kiri, pilih ID Microsoft Entra.
Dari Pendaftaran aplikasi di ID Microsoft Entra, pilih aplikasi Anda.
Salin ID Aplikasi dan simpan di kode aplikasi Anda.
ID direktori (penyewa) juga dapat ditemukan di halaman gambaran umum aplikasi.
Mendapatkan ID Pengguna
Untuk menemukan ID Pengguna Anda, ikuti langkah-langkah berikut:
Navigasi ke portal Azure dan masuk ke portal Azure menggunakan kredensial.
Dari panel kiri, pilih ID Microsoft Entra.
Dari Pengguna di ID Microsoft Entra, pilih pengguna Anda.
Dari halaman Profil di pengguna Microsoft Entra, salin ID Objek dan simpan di kode aplikasi Anda.
Mendapatkan ID sumber daya yang tidak dapat diubah
Terkadang Anda juga perlu memberikan ID sumber daya yang tidak dapat diubah dari sumber daya Communication Service Anda. Untuk menemukannya, ikuti langkah-langkah berikut:
- Navigasi ke portal Azure dan masuk ke portal Azure menggunakan kredensial.
- Buka sumber daya Communication Service Anda.
- Dari panel kiri, pilih Gambaran Umum, dan beralih ke tampilan JSON
- Dari halaman Resource JSON , salin
immutableResourceId
nilai, dan berikan ke tim dukungan Anda.
Verifikasi kelayakan lisensi Teams untuk menggunakan dukungan Azure Communication Services untuk pengguna Teams
Ada dua cara untuk memverifikasi kelayakan Lisensi Teams Anda untuk menggunakan dukungan Azure Communication Services untuk pengguna Teams:
- Verifikasi melalui klien web Teams
- Memeriksa lisensi Teams Anda saat ini melalui Microsoft Graph API
Verifikasi melalui klien web Teams
Untuk memverifikasi kelayakan Lisensi Teams Anda melalui klien web Teams, ikuti langkah-langkah berikut:
- Buka browser Anda dan navigasi ke klien web Teams.
- Masuk dengan kredensial yang memiliki lisensi Teams yang valid.
- Jika autentikasi berhasil dan Anda tetap berada https://teams.microsoft.com/ di domain, maka Lisensi Teams Anda memenuhi syarat. Jika autentikasi gagal atau Anda dialihkan ke https://teams.live.com/v2/ domain, maka Lisensi Teams Anda tidak memenuhi syarat untuk menggunakan dukungan Azure Communication Services untuk pengguna Teams.
Memeriksa lisensi Teams Anda saat ini melalui Microsoft Graph API
Anda dapat menemukan lisensi Teams Anda saat ini menggunakan licenseDetails Microsoft Graph API yang mengembalikan lisensi yang ditetapkan untuk pengguna. Ikuti langkah-langkah ini untuk menggunakan alat Graph Explorer untuk melihat lisensi yang ditetapkan kepada pengguna:
Buka browser Anda dan navigasi ke Graph Explorer
Masuk ke Graph Explorer menggunakan kredensial.
Dalam kotak kueri, masukkan API berikut dan klik Jalankan Kueri :
https://graph.microsoft.com/v1.0/me/licenseDetails
Atau Anda dapat mengkueri pengguna tertentu dengan memberikan ID pengguna menggunakan API berikut:
https://graph.microsoft.com/v1.0/users/{id}/licenseDetails
Panel Pratinjau respons menampilkan output sebagai berikut:
Objek respons yang ditunjukkan di sini mungkin dipersingkat untuk kemudahan pembacaan.
{ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('071cc716-8147-4397-a5ba-b2105951cc0b')/assignedLicenses", "value": [ { "skuId": "b05e124f-c7cc-45a0-a6aa-8cf78c946968", "servicePlans":[ { "servicePlanId":"57ff2da0-773e-42df-b2af-ffb7a2317929", "servicePlanName":"TEAMS1", "provisioningStatus":"Success", "appliesTo":"User" } ] } ] }
Temukan detail lisensi di mana properti
servicePlanName
memiliki salah satu nilai dalam tabel Lisensi Teams yang Memenuhi Syarat
Artikel terkait
- Pemecahan masalah kegagalan panggilan PSTN Azure Communication Services.
- Pemecahan masalah kode respons akhir panggilan untuk Memanggil SDK, Call Automation SDK, PSTN, Chat SDK, dan SMS SDK.
- Akses log untuk suara dan video, obrolan, email, traversal jaringan, perekaman, SMS dan otomatisasi panggilan.
- Metrik.
- Batas layanan.