translateMessage

Omnikanal til Customer Service tilbyder en række funktioner, der kan udvide styrken i Dynamics 365 Customer Service Enterprise til at gøre det muligt for organisationer at oprette umiddelbar forbindelse og kommunikere med deres kunder på tværs af digitale meddelelseskanaler. Der skal bruges en ekstra licens for at få adgang til Omnikanal til Customer Service. Du kan finde flere oplysninger på siderne Dynamics 365 Customer Service-prisoversigt og Dynamics 365 Customer Service-prissætningsplan.

Denne metode skal implementeres i webressourcen. Denne metode kaldes for hver samtalemeddelelse, der udveksles mellem kunden og helpdesk-medarbejderen, hvis oversættelse er aktiveret, og hvis meddelelsen ikke er blevet oversat tidligere i samtalen til destinationssproget.

Vigtigt

Se dette eksempel på webressource for at få flere oplysninger om, hvordan du implementerer API'en translateMessage .

Syntaks

function (conversationId, translationConfig): Object

Parametre

Navn	Type	Description
translationConfig	JavaScript-objekt	Består af conversationId, messagePayload og translateToC1orC2 nøgleværdipar.

Her er strukturen af translationConfig parameteren.

export class UserType { 
        public static readonly C1 = "Agent"; //Used if the sender of the message is agent
        public static readonly C2 = "Customer"; //Used if the sender of the message is customer
        public static readonly CONSULT = "Consult Agent"; //Used if the sender of the message is other than agent or customer
} 
 
export class TranslateTo { 
        public static readonly C1 = "Agent"; //Used if message is translated for agent
        public static readonly C2 = "Customer"; //Used if message is translated for customer
} 
 
export class MessageContentType { 
        public static readonly Text = "Text"; //Used if the content type is text
} 
     
interface Sender { 
        userType: UserType;  //Points to any static field in UserType type,Represents the type of the user who is sending this message
} 

interface MessagePayload { 
        content: string;                 //Contains the content to be translated
        contentType: MessageContentType;  //Points to any static field in MessageContentType type,Represents the type of message content. For example: "Text" etc.
        sender: Sender; //Implements Sender interface, Represents the sender of the message
} 

interface translationConfig { 
        conversationId: string;   //Unique Id for conversation in Omnichannel for Customer Service
        messagePayload: MessagePayload;  //Implements MessagePayload interface, Represents the payload for the message to be translated
        translateToC1orC2: TranslateTo;   //Points to any static field in TranslateTo type,Represents for whom the message has to be translated 
 } 

Her er et eksempel på parameteren conversationConfig .

translationConfig = {
  "conversationId": "2b330c52-6844-4d36-8e05-03c78c9681dc",
  "messagePayload": {
    "content": "Hello",
    "contentType": "Text",
    "sender": {
      "userType": "Agent"
    }
  },
  "translateToC1orC2": "Customer"
}

Returværdi

Returnerer et løfte, der fortolkes til en grænseflade til implementering TranslatedMessageResponse af JavaScript-objekter.

Objekt for grænseflade

export interface ErrorObject{ 
        isError: boolean; //mandatory field, represents true for error while executing this function else no
        errorCode: ErrorCodes; //mandatory field, represents the type of error based on errorCode
} 

export interface TranslatedMessageResponse { 
        translatedMessage: string;  //mandatory field, Contains the translated message
        sourceLanguage: string;       //mandatory field, represents the language locale of the original content 
        destinationLanguage: string;  //mandatory field, represents the language locale of the translated content
        errorObject?: ErrorObject;  //optional field, represents the error object for any error scenarios
}

Parameteren errorCode i ErrorObject repræsenterer kun fejlene fra følgende liste.

Fejlmeddelelse	Fejlkode	Description
MESSAGE_TOO_LONG	100	Fejlkode for meget lang besked, som oversættelsestjenesten ikke kan oversætte
LANGUAGE_NOT_SUPPORTED	101	Fejlkode for sprog, der ikke understøttes af oversættelsestjenesten
MESSAGE_NOT_TRANSLATED	102	Fejlkode for meddelelse, der ikke er oversat af oversættelsestjenesten
TRANSLATION_SERVICE_LIMIT_EXCEEDED	103	Fejlkode, hvis kvotegrænsen er overskredet for oversættelsestjenesten
TRANSLATION_FAILED	104	Fejlkode, hvis oversættelsestjenesten ikke kunne oversætte en meddelelse
UNRECOGNIZED_TEXT	105	Fejlkode, hvis teksten ikke genkendes af oversættelsestjenesten
UNRECOGNIZED_ERROR	200	Fejlkode, hvis der er en anden fejl end den anførte.

Parameteren sourceLanguage og destinationLanguage i TranslatedMessageResponse grænsefladen repræsenterer et landestandard-id. Flere oplysninger: Landestandard-id.

Eksempel på svar

{
  "translatedMessage": "Hola",
  "destinationLanguage": "3082",
  "errorObject": {
    "isError": false,                             
    "errorCode": null
  },
  "sourceLanguage": "3082"
}

Notat

• I tilfælde af en undtagelse under udførelsen af denne metode forsøger Omnikanal til Customer Service ikke igen, men viser i stedet en fejlmeddelelse om oversættelse mislykkedes.
• Fejl under udførelse af denne metode kan meddeles via errorObject. I tilfælde af en fejl forsøger Omnikanal til Customer Service ikke igen, men viser i stedet fejlmeddelelsen baseret på de angivne fejlkoder.
• Hvis det returnerede svar er ugyldigt eller ufuldstændigt, vises der en fejlmeddelelse på oversættelsesbanneret i samtalekontrolelementet.
• Hvis denne metode ikke implementeres, vil meddelelsen ikke blive oversat, og følgende fejlmeddelelse vil blive vist for agenten.

Relaterede oplysninger

Tilføj en webressource til oversættelse i realtid