Kongsi melalui


mulakanPerbualan Baru

Saluran Omni untuk Customer Service menawarkan rangkaian keupayaan yang melanjutkan kuasa Dynamics 365 Customer Service Enterprise untuk mendayakan organisasi berhubung dengan segera dan terlibat dengan pelanggan mereka melalui saluran pemesejan digital. Lesen tambahan diperlukan untuk mengakses Saluran Omni untuk Customer Service. Untuk mendapatkan maklumat lanjut, lihat gambaran keseluruhan harga Dynamics 365 Customer Service dan halaman pelan harga Dynamics 365 Customer Service .

Kaedah ini perlu dilaksanakan dalam sumber web. Ia dipanggil sekali, sebaik sahaja jemputan perbualan baharu diterima atau perbualan sedia ada dibuka daripada Papan Pemuka Ejen.

  1. Anda boleh memilih untuk mematikan atau menghidupkan terjemahan untuk perbualan tertentu menggunakan syarat tertentu; Sebagai contoh, anda ingin menghidupkan terjemahan jika bahasa ejen dan pelanggan berbeza.
  2. Anda juga boleh menggantikan bahasa ejen untuk digunakan dalam terjemahan untuk perbualan.
  3. Ia memberi anda maklumat tentang perbualan untuk mengambil keputusan tertentu, contohnya, enjin API terjemahan yang harus digunakan untuk perbualan.

Penting

Lihat contoh sumber web ini untuk mendapatkan maklumat lanjut tentang cara melaksanakan initializeNewConversation API.

Sintaks

function (conversationConfig): Object

Parameter

Nama Diperlukan Jenis Penerangan
conversationConfig Ya Objek JavaScript Memberikan butiran tentang perbualan. Seperti id perbualan, bahasa input ejen lalai (Daripada konfigurasi pentadbir terjemahan masa nyata) dsb.
Butiran lanjut boleh didapati dalam perenggan berikut.

Berikut ialah struktur conversationConfig parameter.

interface InviteParams {// Parameters received on a conversation invite 
        inviteLocale: string;  //Language locale of the channel from where conversation is received. This contains locale ID, example- "1033" for english.
        channelType: string;   //The type of the channel, example- "lcw" for chat widget, "facebook" for facebook.
} 


interface conversationConfig { 
        conversationId: string,  // Unique Id for conversation in Omnichannel for Customer Service
        c1Language: string;      // Default agent input language (From Real time translation administrator configuration)
        inviteParams: InviteParams;  // Implements InviteParams interface, Represents the parameters received on a conversation invite  
}

inviteLocale Parameter dalam InviteParams antara muka mewakili ID Tempatan. Maklumat lanjut: ID Tempatan.

channelType Parameter dalam InviteParams antara muka mewakili saluran yang disokong dalam Omnichannel untuk Perkhidmatan Pelanggan. Saluran disenaraikan seperti berikut.

Nama Penerangan
"lcw" Untuk saluran Widget Sembang Langsung
"sms" Untuk saluran SMS
"facebook" Untuk saluran Facebook
"twitter" Untuk saluran Twitter
"custom" Untuk saluran buatan tersuai
"wechat" Untuk saluran WeChat
"whatsapp" Untuk saluran WhatsApp
"msteams" Untuk saluran Microsoft Teams
"line" Untuk saluran Talian
"phonecall" Untuk saluran panggilan telefon

Contoh conversationConfig parameter adalah seperti berikut.

conversationConfig = {
  "conversationId": "2f67af9e-c05a-4784-aaea-916d6938fcea",
  "c1Language": "1033",
  "inviteParams": {
    "inviteLocale": "3082",
    "channelType": "lcw"
  }
}

Nilai Pulangan

Mengembalikan janji yang diselesaikan kepada objek JavaScript berikut.

{
        keepTranslationOn: boolean;// mandatory field, if true the translation would be turned on for the conversation and vice-versa
        c1Language?: string;// optional field, return the agent's language if input param conversationConfig.c1Language needs to be overriden for the conversation
}

c1Language Parameter dalam objek JavaScript yang diselesaikan mewakili ID Tempatan hanya daripada senarai berikut.

ID Tempatan Bahasa
"1033" Inggeris
"1025" Bahasa Arab
"1069" Bahasa Basque
"1027" Bahasa Catalan
"1026" Bahasa Bulgaria
"1050" Bahasa Croatia
"1029" Bahasa Czech
"1030" Bahasa Denmark
"1043" Bahasa Belanda
"1061" Bahasa Estonia
"1035" Bahasa Finland
"1036" Perancis
"1110" Orang Galicia
"1031" Jerman
"1032" Bahasa Greek
"1037" Bahasa Ibrani
"1081" Bahasa Hindi
"1038" Bahasa Hungary
"1040" Itali
"1057" Bahasa Indonesia
"1041" Jepun
"1087" Bahasa Kazakh
"1042" Bahasa Korea
"1062" Bahasa Latvia
"1063" Bahasa Lithuania
"1086" Bahasa Melayu
"1044" Bahasa Bokmal Norway
"1045" Bahasa Poland
"1046" Portugis - Brazil
"2070" Portugis - Portugal
"1048" Bahasa Romania
"1049" Bahasa Rusia
"3098" Bahasa Serbia (Cyrillic)
"2074" Bahasa Serbia (Latin)
"1051" Bahasa Slovakia
"1060" Bahasa Slovenia
"3082" Sepanyol
"1053" Bahasa Sweden
"1054" Bahasa Thai
"1055" Bahasa Turki
"1058" Bahasa Ukraine
"1066" Bahasa Vietnam
"2052" Cina - China
"3076" Cina - Hong Kong SAR

Contoh tindak balas yang dijangkakan

{

  "keepTranslationOn": true,
  "c1Language": "1033"

}

Maklumat Tambahan

  • Pengecualian dalam kaedah ini atau nilai pulangan yang tidak sah, Omnichannel untuk Perkhidmatan Pelanggan akan mematikan terjemahan untuk perbualan. Contohnya: jika objek JavaScript yang diselesaikan daripada janji yang dikembalikan tidak mengandungi keepTranslationOn medan atau c1Language medan mengandungi nilai yang bukan daripada senarai ID Tempatan, perbualan akan bermula dengan terjemahan dimatikan.

  • Pertimbangkan untuk memasukkan pemprosesan minimum dalam fungsi ini kerana ia menjadikan UI menunggu sebelum dipaparkan. Jika masa jalanan fungsi ini melebihi 30 saat, perbualan akan bermula dengan terjemahan dimatikan, tanpa mengira nilai janji yang dikembalikan.

  • Jika kaedah ini tidak dilaksanakan, ralat berikut akan dipaparkan kepada ejen.

mesej ralat permulaanNewConversation.memulakan memulakan

Tambah sumber web untuk terjemahan masa nyata