translateMessage

Το Πανκαναλικό για Customer Service προσφέρει δυνατότητες που επεκτείνουν την ισχύ του Dynamics 365 Customer Service Enterprise για να έχουν οι οργανισμοί τη δυνατότητα να συνδεθούν και να επικοινωνήσουν άμεσα με τους πελάτες τους μέσω καναλιών όπως η Live Συνομιλία και το SMS. Απαιτείται μια πρόσθετη άδεια χρήσης για την πρόσβαση στο Πανκαναλικό για Customer Service. Για περισσότερες πληροφορίες δείτε τις σελίδες Επισκόπηση τιμολόγησης Dynamics 365 Customer Service και Πλάνο τιμολόγησης Dynamics 365 Customer Service.

Αυτή η μέθοδος απαιτείται να εφαρμοστεί σε πόρους ιστού. Αυτή η μέθοδος καλείται για κάθε μήνυμα συνομιλίας που ανταλλάσσεται μεταξύ του πελάτη και του πράκτορα, εάν η μετάφραση είναι ενεργοποιημένη και εάν το μήνυμα δεν έχει μεταφραστεί νωρίτερα στη συνομιλία για τη γλώσσα προορισμού.

Σημαντικό

Δείτε αυτό το δείγμα πόρου web για περισσότερες πληροφορίες σχετικά με τον τρόπο υλοποίησης του translateMessage API.

Σύνταξη

function (conversationId, translationConfig): Object

Παράμετροι

Ονομασία	Type	Περιγραφή
translationConfig	Αντικείμενο JavaScript	Αποτελείται από conversationId, messagePayload και translateToC1orC2 ζεύγη κλειδιού-τιμής.

Εδώ είναι η δομή της translationConfig παραμέτρου.

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 
 } 

Ακολουθεί ένα δείγμα της conversationConfig παραμέτρου.

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

Τιμή επιστροφής

Επιστρέφει μια υπόσχεση που επιλύεται σε ένα περιβάλλον εργασίας υλοποίησης TranslatedMessageResponse αντικειμένου JavaScript.

Αντικείμενο διασύνδεσης

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
}

Η errorCode παράμετρος in ErrorObject αντιπροσωπεύει τα σφάλματα μόνο από την ακόλουθη λίστα.

Μήνυμα σφάλματος	Κωδικός σφάλματος	Περιγραφή
MESSAGE_TOO_LONG	100	Κωδικός σφάλματος για πολύ μεγάλο μήνυμα που δεν μπορεί να μεταφράσει η μεταφραστική υπηρεσία
LANGUAGE_NOT_SUPPORTED	101	Κωδικός σφάλματος για γλώσσα που δεν υποστηρίζεται από τη μεταφραστική υπηρεσία
MESSAGE_NOT_TRANSLATED	102	Κωδικός σφάλματος για μήνυμα που δεν μεταφράστηκε από τη μεταφραστική υπηρεσία
TRANSLATION_SERVICE_LIMIT_EXCEEDED	103	Κωδικός σφάλματος σε περίπτωση υπέρβασης του ορίου ορίου για τη μεταφραστική υπηρεσία
TRANSLATION_FAILED	104	Κωδικός σφάλματος εάν η μεταφραστική υπηρεσία απέτυχε να μεταφράσει ένα μήνυμα
UNRECOGNIZED_TEXT	105	Κωδικός σφάλματος εάν το κείμενο δεν αναγνωρίζεται από τη μεταφραστική υπηρεσία
UNRECOGNIZED_ERROR	200	Κωδικός σφάλματος εάν υπάρχει κάποιο σφάλμα εκτός από το αναφερόμενο.

Η sourceLanguage παράμετρος and destinationLanguage στη TranslatedMessageResponse διεπαφή αντιπροσωπεύει ένα αναγνωριστικό τοπικών ρυθμίσεων. Περισσότερες πληροφορίες: Αναγνωριστικό τοπικών ρυθμίσεων.

Δείγμα απόκρισης

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

Σημείωμα

• Σε περίπτωση εξαίρεσης κατά την εκτέλεση αυτής της μεθόδου, το Πανκαναλικό για Customer Service δεν θα προσπαθήσει ξανά και αντίθετα θα εμφανίσει ένα μήνυμα σφάλματος αποτυχίας μετάφρασης.
• Σφάλμα κατά την εκτέλεση αυτής της μεθόδου μπορεί να ειδοποιηθεί μέσω errorObject. Σε περίπτωση σφάλματος, το Πανκαναλικό για Customer Service δεν θα προσπαθήσει ξανά και αντ 'αυτού θα εμφανίσει το μήνυμα σφάλματος με βάση τους παρεχόμενους κωδικούς σφάλματος.
• Σε περίπτωση που η απάντηση που επιστράφηκε δεν είναι έγκυρη ή ελλιπής, θα εμφανιστεί ένα μήνυμα σφάλματος στο πλαίσιο μετάφρασης στο στοιχείο ελέγχου συνομιλίας.
• Εάν αυτή η μέθοδος δεν εφαρμοστεί, τότε το μήνυμα δεν θα μεταφραστεί και το ακόλουθο μήνυμα λάθους θα εμφανιστεί στον παράγοντα.

Σχετικές πληροφορίες

Προσθήκη πόρου web για μετάφραση σε πραγματικό χρόνο