Sdílet prostřednictvím


initializeNewConversation

Omnikanál pro Customer Service nabízí sadu funkcí, které rozšiřují výkon Dynamics 365 Customer Service Enterprise, což umožňuje organizacím okamžitě se spojit a komunikovat se svými zákazníky prostřednictvím kanálů digitálního zasílání zpráv. Pro přístup k Omnikanálu pro Customer Service je vyžadována další licence. Více informací naleznete na stránkách Přehled cen Dynamics 365 Customer ServiceCenový plán Dynamics 365 Customer Service.

Tato metoda musí být implementována ve webovém prostředku. Volá se jednou, jakmile je přijata nová pozvánka ke konverzaci nebo je otevřena existující konverzace z Panelu agenta.

  1. Můžete se rozhodnout vypnout nebo zapnout překlad pro konkrétní konverzaci za určitých podmínek; Překlad byste například chtěli zapnout, pokud se jazyk agenta a zákazníka liší.
  2. Můžete také přepsat jazyk agenta, který se má použít při překladu konverzace.
  3. Poskytuje vám informace o konverzaci, abyste mohli přijmout určitá rozhodnutí, například modul API pro překlad, který by měl být použit pro konverzaci.

Důležité

Další informace o tom, jak implementovat rozhraní API, najdete v tomto ukázkovém initializeNewConversation.

Syntaxe

function (conversationConfig): Object

Parametry

Název Povinné Typ Description
conversationConfig Ano Objekt JavaScript Poskytuje podrobnosti o konverzaci. Například ID konverzace, výchozí vstupní jazyk agenta (z konfigurace správce překladu v reálném čase) atd.
Další podrobnosti jsou k dispozici v následujících odstavcích.

Zde je struktura parametru conversationConfig .

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  
}

Parametr inviteLocale v InviteParams interface představuje ID národního prostředí. Další informace: ID národního prostředí.

Parametr channelType v InviteParams rozhraní představuje podporovaný kanál v Omnikanálu pro Customer Service. Kanály jsou uvedeny následovně.

Název Description
"lcw" Pro kanál widgetu živého chatu
"sms" Pro SMS kanál
"facebook" Pro Facebook kanál
"twitter" Pro Twitter kanál
"custom" Pro kanál na míru
"wechat" Pro WeChat kanál
"whatsapp" Pro kanál WhatsApp
"msteams" Pro kanál Microsoft Teams
"line" Pro liniový kanál
"phonecall" Pro kanál telefonního hovoru

Ukázka parametru conversationConfig je následující.

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

Návratová hodnota

Vrátí příslib, který se přeloží na následující objekt jazyka JavaScript.

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

Parametr c1Language v vyřešeném objektu jazyka JavaScript představuje ID národního prostředí pouze z následujícího seznamu.

ID místního nastavení Jazyk
"1033" Angličtina
"1025" Arabština
"1069" Baskičtina
"1027" Katalánština
"1026" Bulharština
"1050" Chorvatština
"1029" Čeština
"1030" Dánština
"1043" Nizozemština
"1061" Estonština
"1035" Finština
"1036" francouzský
"1110" Galicijština
"1031" Němčina
"1032" Řečtina
"1037" Hebrejština
"1081" Hindština
"1038" Maďarština
"1040" Italština
"1057" Indonéština
"1041" Japonština
"1087" Kazaština
"1042" Korejština
"1062" Lotyština
"1063" Litevština
"1086" Malajština
"1044" Norský bokmal
"1045" Polština
"1046" Portugalština – Brazílie
"2070" Portugalština - Portugalsko
"1048" Rumunština
"1049" Ruština
"3098" Srbština (cyrilice)
"2074" Srbština (latinka)
"1051" Slovenština
"1060" Slovinština
"3082" Španělština
"1053" Švédština
"1054" Thajština
"1055" Turečtina
"1058" Ukrajinština
"1066" Vietnamština
"2052" Čínština - Čína
"3076" Čínština - Hongkong – zvláštní správní oblast

Ukázka očekávané odezvy

{

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

}

Další informace

  • Při výjimce v této metodě nebo neplatných návratových hodnotách Omnikanál pro Customer Service ponechá překlad pro konverzaci vypnutý. Příklad: pokud vyřešený objekt JavaScript z vráceného příslibu neobsahuje keepTranslationOn pole nebo c1Language pole obsahuje hodnotu, která není ze seznamu ID národního prostředí, konverzace začne s vypnutým překladem.

  • Zvažte zahrnutí minimálního zpracování do této funkce, protože uživatelské rozhraní bude před vykreslováním čekat. Pokud doba trvání této funkce přesáhne 30 sekund, konverzace začne s vypnutým překladem, bez ohledu na hodnoty vráceného příslibu.

  • Pokud tato metoda není implementována, zobrazí se agentovi následující chyba.

Chybová zpráva initializeNewConversation.

Přidání webového zdroje pro překlad v reálném čase