Dela via


initializeNewConversation

Flerkanal för Customer Service ger en svit med funktioner som utökar kraften i Dynamics 365 Customer Service Enterprise så att organisationer omedelbart kan interagera med sina kunder i olika digitala kommunikationskanaler. Ytterligare en licens krävs för åtkomst till Flerkanal för Customer Service. För mer information, se Översikt över Dynamics 365 Customer Service prissättning and Dynamics 365 Customer Service prissättningsplan.

Den här metoden måste implementeras i webbresursen. Den anropas en gång, så snart en ny konversationsinbjudan har accepterats eller en befintlig konversation har öppnats från agentens instrumentpanel.

  1. Du kan välja att stänga av eller slå på översättningen för en viss konversation under vissa förutsättningar. Du vill till exempel aktivera översättningen om handläggaren och kundens språk är olika.
  2. Du kan också åsidosätta handläggarens språk som ska användas i översättningen för konversationen.
  3. Den ger dig information om konversationen för att fatta vissa beslut, till exempel översättnings-API-motorn som ska användas för en konversation.

Viktigt!

Se den här exempelwebbresursen för mer information om hur du implementerar API:et initializeNewConversation .

Syntax

function (conversationConfig): Object

Parameterar

Namn Krävs Typ Description
conversationConfig Yes JavaScript-objekt Ger information om konversationen. Till exempel konversations-ID, standardspråk för agentinmatning (från administratörskonfiguration för översättning i realtid) osv.
Mer information finns i följande stycken.

Här är strukturen för parametern 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  
}

Parametern inviteLocale i InviteParams gränssnittet representerar ett språk-ID. Mer information: Språk-ID.

Parametern channelType i InviteParams gränssnittet representerar en kanal som stöds i Flerkanal för Customer Service. Kanalerna listas enligt följande.

Namn Description
"lcw" För widgetkanal för livechatt
"sms" För SMS-kanal
"facebook" För Facebook-kanal
"twitter" För Twitter-kanal
"custom" För skräddarsydd kanal
"wechat" För WeChat-kanal
"whatsapp" För WhatsApp-kanal
"msteams" För Microsoft Teams-kanal
"line" För linjekanal
"phonecall" För telefonsamtalskanal

Ett exempel på parametern conversationConfig är följande.

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

Returvärde

Returnerar ett löfte som matchar följande JavaScript-objekt.

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

Parametern c1Language i det lösta JavaScript-objektet representerar endast ett språk-ID från följande lista.

Lokal-ID Language
"1033" Engelska
"1025" Arabiska
"1069" Baskiska
"1027" Katalanska
"1026" Bulgariska
"1050" Kroatiska
"1029" Tjeckiska
"1030" Danska
"1043" Nederländska
"1061" Estniska
"1035" Finska
"1036" Franska
"1110" Galiciska
"1031" Tyska
"1032" Grekiska
"1037" Hebreiska
"1081" Hindi
"1038" Ungerska
"1040" Italienska
"1057" Indonesiska
"1041" Japanska
"1087" Kazakiska
"1042" Koreanska
"1062" Lettiska
"1063" Litauiska
"1086" Malajiska
"1044" Norskt bokmål
"1045" Polska
"1046" Portugisiska i Brasilien
"2070" Portugisiska – Portugal
"1048" Rumänska
"1049" Ryska
"3098" Serbiska (kyrillisk)
"2074" Serbiska (latin)
"1051" Slovakiska
"1060" Slovenien
"3082" Spanska
"1053" Svenska
"1054" Thailändska
"1055" Turkiska
"1058" ukrainska
"1066" Vietnamesiska
"2052" Kinesiska – Kina
"3076" Kinesiska – Hongkong SAR

Exempel på förväntat svar

{

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

}

Ytterligare information

  • Vid undantag i den här metoden eller ogiltiga returvärden kommer Flerkanal för Customer Service att hålla översättningen avstängd för konversationen. Till exempel: om det lösta JavaScript-objektet från det returnerade löftet inte innehåller keepTranslationOn något fält eller c1Language om fältet innehåller ett värde som inte kommer från listan över språk-ID:n, börjar konversationen med översättning inaktiverat.

  • Överväg att inkludera minimal bearbetning i den här funktionen eftersom det gör att användargränssnittet väntar innan det återges. Om körningstiden för den här funktionen överskrider 30 sekunder startar konversationen med översättningen inaktiverad, oavsett värdena för det returnerade löftet.

  • Om den här metoden inte implementeras visas följande fel för agenten.

initializeNewConversation felmeddelande.

Lägga till en webbresurs för översättning i realtid