Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Multicanale per Customer Service offre una suite di funzionalità che estendono le funzionalità avanzate di Dynamics 365 Customer Service Enterprise per consentire alle organizzazioni di connettersi e interagire immediatamente con i clienti attraverso i canali di messaggistica digitale. È necessaria una licenza aggiuntiva per accedere a Multicanale per Customer Service. Per altre informazioni, vedere le pagine Panoramica dei prezzi di Dynamics 365 Customer Service e Piano tariffario di Dynamics 365 Customer Service.
Questo metodo deve essere implementato nella risorsa web. Viene chiamato una sola volta, non appena viene accettato un nuovo invito a una conversazione o viene aperta una conversazione esistente dalla Dashboard agente.
- È possibile scegliere di disattivare o attivare la traduzione per una determinata conversazione in base a determinate condizioni; Ad esempio, si desidera attivare la traduzione se le lingue dell'agente e del cliente sono diverse.
- È inoltre possibile sovrascrivere la lingua dell'agente da utilizzare nella traduzione per la conversazione.
- Fornisce informazioni sulla conversazione per prendere determinate decisioni, ad esempio il motore API di traduzione che deve essere utilizzato per una conversazione.
Importante
Per altre informazioni su come implementare l'API, vedere questa initializeNewConversation.
Sintassi
function (conversationConfig): Object
Parametri
| Nome | Obbligatorio | TIPO | Description |
|---|---|---|---|
conversationConfig |
Yes | Oggetto JavaScript | Fornisce dettagli sulla conversazione. Ad esempio, ID conversazione, lingua di input dell'agente predefinita (dalla configurazione dell'amministratore di traduzione in tempo reale) e così via. Maggiori dettagli sono disponibili nei paragrafi seguenti. |
Ecco la struttura del conversationConfig parametro.
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
}
Il parametro nell'interfaccia inviteLocaleInviteParams rappresenta un ID delle impostazioni locali. Ulteriori informazioni: ID delle impostazioni locali.
Il parametro nell'interfaccia channelTypeInviteParams rappresenta un canale supportato in Multicanale per Customer Service. I canali sono elencati come segue.
| Nome | Description |
|---|---|
"lcw" |
Per il canale Widget Live Chat |
"sms" |
Per il canale SMS |
"facebook" |
Per il canale Facebook |
"twitter" |
Per il canale Twitter |
"custom" |
Per canale su misura |
"wechat" |
Per il canale WeChat |
"whatsapp" |
Per il canale WhatsApp |
"msteams" |
Per il canale Microsoft Teams |
"line" |
Per canale Line |
"phonecall" |
Per il canale di chiamata telefonica |
Di seguito è riportato un esempio del conversationConfig parametro.
conversationConfig = {
"conversationId": "2f67af9e-c05a-4784-aaea-916d6938fcea",
"c1Language": "1033",
"inviteParams": {
"inviteLocale": "3082",
"channelType": "lcw"
}
}
Valore restituito
Restituisce una promessa che si risolve nell'oggetto JavaScript seguente.
{
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
}
Il c1Language parametro nell'oggetto JavaScript risolto rappresenta un ID delle impostazioni locali solo dall'elenco seguente.
| ID locale | Language |
|---|---|
"1033" |
English |
"1025" |
Arabo |
"1069" |
Basco |
"1027" |
Catalano |
"1026" |
Bulgaro |
"1050" |
Croato |
"1029" |
Ceco |
"1030" |
Danese |
"1043" |
Olandese |
"1061" |
Estone |
"1035" |
Finlandese |
"1036" |
Francese |
"1110" |
Galiziano |
"1031" |
Tedesco |
"1032" |
Greco |
"1037" |
Ebraico |
"1081" |
hindi |
"1038" |
Ungherese |
"1040" |
Italiano |
"1057" |
Indonesiano |
"1041" |
Giapponese |
"1087" |
Kazako |
"1042" |
Coreano |
"1062" |
Lettone |
"1063" |
Lituano |
"1086" |
Malese |
"1044" |
Bokmal norvegese |
"1045" |
Polacco |
"1046" |
Portoghese - Brasile |
"2070" |
Portoghese - Portogallo |
"1048" |
Rumeno |
"1049" |
Russo |
"3098" |
Serbo (alfabeto cirillico) |
"2074" |
Serbo (alfabeto latino) |
"1051" |
Slovacco |
"1060" |
Sloveno |
"3082" |
Spagnolo |
"1053" |
Svedese |
"1054" |
Tailandese |
"1055" |
Turco |
"1058" |
Ucraino |
"1066" |
Vietnamita |
"2052" |
Cinese - Cina |
"3076" |
Cinese - Hong Kong |
Esempio di risposta prevista
{
"keepTranslationOn": true,
"c1Language": "1033"
}
Informazioni aggiuntive
In caso di eccezione in questo metodo o di valori restituiti non validi, Multicanale per Customer Service manterrà la traduzione disattivata per la conversazione. Ad esempio: se l'oggetto JavaScript risolto dalla promessa restituita non contiene
keepTranslationOncampo oc1Languageil campo contiene un valore che non proviene dall'elenco degli ID locali, la conversazione inizierà con la traduzione disattivata.Prendi in considerazione l'inclusione di un'elaborazione minima in questa funzione perché fa attendere l'interfaccia utente prima del rendering. Se il tempo di esecuzione di questa funzione supera i 30 secondi, la conversazione inizierà con la traduzione disattivata, indipendentemente dai valori della promessa restituita.
Se questo metodo non viene implementato, all'agente verrà visualizzato il seguente errore.
