Dela via

översättMeddelande

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 här metoden anropas för varje konversationsmeddelande som utväxlas mellan kunden och handläggaren, om översättning är på och om meddelandet inte har översatts tidigare i konversationen för målspråket.

Viktigt!

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

Syntax

function (conversationId, translationConfig): Object

Parameterar

Namn Typ Description
translationConfig JavaScript-objekt Består av conversationId, messagePayload och translateToC1orC2 nyckel/värde-par.

Här är strukturen translationConfig för parametern.


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 
 }

Här är ett exempel på parametern conversationConfig .

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

Returvärde

Returnerar ett löfte som matchas till ett implementeringsgränssnitt TranslatedMessageResponse för JavaScript-objekt.

Gränssnittsobjekt

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
}

Parametern errorCode in ErrorObject representerar endast felen från följande lista.

Felmeddelande Felkod Description
MESSAGE_TOO_LONG 100 Felkod för mycket långt meddelande som översättningstjänsten inte kan översätta
LANGUAGE_NOT_SUPPORTED 101 Felkod för språk som inte stöds av översättningstjänsten
MESSAGE_NOT_TRANSLATED 102 Felkod för meddelande som inte översatts av översättningstjänsten
TRANSLATION_SERVICE_LIMIT_EXCEEDED 103 Felkod om kvotgränsen överskrids för översättningstjänsten
TRANSLATION_FAILED 104 Felkod om översättningstjänsten inte kunde översätta ett meddelande
UNRECOGNIZED_TEXT 105 Felkod om texten inte känns igen av översättningstjänsten
UNRECOGNIZED_ERROR 200 Felkod om det finns något annat fel än det som anges.

Parametern sourceLanguage and destinationLanguage i TranslatedMessageResponse gränssnittet representerar ett språk-ID. Mer information: Språk-ID.

Exempel på svar

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

Anmärkning

  • I händelse av ett undantag under körningen av den här metoden kommer Flerkanal för Customer Service inte att försöka igen och i stället visas ett felmeddelande om att översättningen misslyckades.
  • Fel vid körning av den här metoden kan meddelas via errorObject. I händelse av ett fel kommer Flerkanal för Customer Service inte att försöka igen och i stället visa felmeddelandet baserat på de angivna felkoderna.
  • Om det returnerade svaret är ogiltigt eller ofullständigt visas ett felmeddelande på översättningsbanderollen i konversationskontrollen.
  • Om den här metoden inte implementeras kommer meddelandet inte att översättas och följande felmeddelande kommer att visas för agenten.

felmeddelande för translateMessage.

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

  • Last updated on