translateMessage

Omnikanal for Customer Service har en rekke funksjoner som utvider kraften i Dynamics 365 Customer Service Enterprise, slik at organisasjoner kan koble seg til og komme i kontakt med kundene på tvers av digitale meldingskanaler. En tilleggslisens kreves for å få tilgang til Omnikanal for Customer Service. Hvis du vil ha mer informasjon, kan du se sidene Prisoversikt for Dynamics 365 Customer Service og Prisplan for Dynamics 365 Customer Service.

Denne metoden må implementeres i webressursen. Denne metoden kalles for hver samtalemelding som utveksles mellom kunden og agenten, hvis oversettelse er aktivert og hvis meldingen ikke er oversatt tidligere i samtalen for målspråket.

Viktig!

Se denne eksempelnettressursen hvis du vil ha mer informasjon om hvordan du implementerer API-en translateMessage .

Syntaks

function (conversationId, translationConfig): Object

Parametere

Navn	Type	Beskrivelse
translationConfig	JavaScript-objekt	Består av conversationId, messagePayload og translateToC1orC2 nøkkelverdipar.

Her er strukturen til 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"
}

Returverdi

Returnerer et løfte som løses til et grensesnitt for implementering TranslatedMessageResponse av JavaScript-objekter.

Grensesnitt objekt

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 representerer feilene bare fra følgende liste.

Feilmelding	Feilkode	Beskrivelse
MESSAGE_TOO_LONG	100	Feilkode for veldig lang melding som oversettelsestjenesten ikke kan oversette
LANGUAGE_NOT_SUPPORTED	101	Feilkode for språk som ikke støttes av oversettelsestjenesten
MESSAGE_NOT_TRANSLATED	102	Feilkode for melding som ikke er oversatt av oversettelsestjenesten
TRANSLATION_SERVICE_LIMIT_EXCEEDED	103	Feilkode hvis kvotegrensen er overskredet for oversettelsestjenesten
TRANSLATION_FAILED	104	Feilkode hvis oversettelsestjenesten ikke kunne oversette en melding
UNRECOGNIZED_TEXT	105	Feilkode hvis teksten ikke gjenkjennes av oversettelsestjenesten
UNRECOGNIZED_ERROR	200	Feilkode hvis det er noen annen feil enn den oppførte.

Parameteren sourceLanguage og destinationLanguage i TranslatedMessageResponse grensesnittet representerer en nasjonal ID. Mer informasjon: ID for nasjonal innstilling.

Eksempel på svar

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

Note

• Hvis det oppstår et unntak under kjøring av denne metoden, vil ikke Omnikanal for Customer Service prøve på nytt, men vil i stedet vise en feilmelding om oversettelse mislyktes.
• Feil under utførelse av denne metoden kan varsles via errorObject. Hvis det oppstår en feil, vil ikke Omnikanal for Customer Service prøve på nytt, men vil i stedet vise feilmeldingen basert på de angitte feilkodene.
• Hvis det returnerte svaret er ugyldig eller ufullstendig, vises en feilmelding på oversettelsesbanneret i diskusjonskontrollen.
• Hvis denne metoden ikke implementeres, vil ikke meldingen bli oversatt, og følgende feilmelding vil vises til agenten.

Relatert informasjon

Legg til en nettressurs for oversettelse i sanntid