initializeNewConversation

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

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

1. Μπορείτε να επιλέξετε να απενεργοποιήσετε ή να ενεργοποιήσετε τη μετάφραση για μια συγκεκριμένη συνομιλία χρησιμοποιώντας ορισμένες συνθήκες. Για παράδειγμα, θα θέλατε να ενεργοποιήσετε τη μετάφραση εάν οι γλώσσες του αντιπροσώπου και του πελάτη είναι διαφορετικές.
2. Μπορείτε επίσης να παρακάμψετε τη γλώσσα του πράκτορα που θα χρησιμοποιηθεί στη μετάφραση για τη συνομιλία.
3. Σας παρέχει πληροφορίες σχετικά με τη συνομιλία για να λάβετε ορισμένες αποφάσεις, για παράδειγμα, τη μηχανή API μετάφρασης που πρέπει να χρησιμοποιηθεί για μια συνομιλία.

Σημαντικό

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

Σύνταξη

function (conversationConfig): Object

Παράμετροι

Ονομασία	Απαραίτητο	Type	Περιγραφή
conversationConfig	Όχι	Αντικείμενο JavaScript	Παρέχει λεπτομέρειες σχετικά με τη συνομιλία. Όπως αναγνωριστικό συνομιλίας, προεπιλεγμένη γλώσσα εισόδου παράγοντα (Από διαμόρφωση διαχειριστή μετάφρασης σε πραγματικό χρόνο) κ.λπ. Περισσότερες λεπτομέρειες είναι διαθέσιμες στις ακόλουθες παραγράφους.

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

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  
}

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

Η channelType παράμετρος στη InviteParams διασύνδεση αντιπροσωπεύει ένα υποστηριζόμενο κανάλι στο Πανκαναλικό για Customer Service. Τα κανάλια παρατίθενται ως εξής.

Ονομασία	Περιγραφή
"lcw"	Για κανάλι Live Chat Widget
"sms"	Για κανάλι SMS
"facebook"	Για το κανάλι Facebook
"twitter"	Για το κανάλι Twitter
"custom"	Για προσαρμοσμένο κανάλι
"wechat"	Για το κανάλι WeChat
"whatsapp"	Για το κανάλι WhatsApp
"msteams"	Για το κανάλι Microsoft Teams
"line"	Για κανάλι γραμμής
"phonecall"	Για κανάλι τηλεφωνικών κλήσεων

Ένα δείγμα της conversationConfig παραμέτρου έχει ως εξής.

conversationConfig = {
  "conversationId": "2f67af9e-c05a-4784-aaea-916d6938fcea",
  "c1Language": "1033",
  "inviteParams": {
    "inviteLocale": "3082",
    "channelType": "lcw"
  }
}

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

Επιστρέφει μια υπόσχεση που επιλύεται στο ακόλουθο αντικείμενο JavaScript.

{
        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
}

Η c1Language παράμετρος στο αντικείμενο JavaScript που έχει επιλυθεί αντιπροσωπεύει ένα αναγνωριστικό τοπικών ρυθμίσεων μόνο από την ακόλουθη λίστα.

Αναγνωριστικό τοπικών ρυθμίσεων	Γλώσσα
"1033"	Αγγλικά
"1025"	Αραβικά
"1069"	Βασκικά
"1027"	Καταλανικά
"1026"	Βουλγαρικά
"1050"	Κροατικά
"1029"	Τσέχικα
"1030"	Δανικά
"1043"	Ολλανδικά
"1061"	Εσθονικά
"1035"	Φινλανδικά
"1036"	Γαλλικά
"1110"	Γαλικιακά
"1031"	Γερμανικά
"1032"	Ελληνικά
"1037"	Εβραϊκά
"1081"	Χίντι
"1038"	Ουγγρικά
"1040"	Ιταλικά
"1057"	Ινδονησιακά
"1041"	Ιαπωνικά
"1087"	Καζαχστανικά
"1042"	Κορεατικά
"1062"	Λετονικά
"1063"	Λιθουανικά
"1086"	Μαλαϊκά
"1044"	Νορβηγικά Bokmal
"1045"	Πολωνικά
"1046"	Πορτογαλικά-Βραζιλία
"2070"	Πορτογαλικά-Πορτογαλία
"1048"	Ρουμανικά
"1049"	Ρωσικά
"3098"	Σερβικά (Κυριλλικά)
"2074"	Σερβικά (Λατινικά)
"1051"	Σλοβακικά
"1060"	Σλοβενικά
"3082"	Ισπανικά
"1053"	Σουηδικά
"1054"	Ταϊλανδικά
"1055"	Τουρκικά
"1058"	Ουκρανικά
"1066"	Βιετναμικά
"2052"	Κινέζικα - Κίνα
"3076"	Κινέζικα - Χονγκ Κονγκ

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

{

  "keepTranslationOn": true,
  "c1Language": "1033"

}

Πρόσθετες πληροφορίες

• Με εξαίρεση σε αυτήν τη μέθοδο ή μη έγκυρες τιμές επιστροφής, το Πανκαναλικό για Customer Service θα διατηρήσει τη μετάφραση απενεργοποιημένη για τη συνομιλία. Για παράδειγμα: εάν το επιλυμένο αντικείμενο JavaScript από την υπόσχεση που επιστρέφεται δεν περιέχει keepTranslationOn πεδίο ή c1Language το πεδίο περιέχει μια τιμή που δεν προέρχεται από τη λίστα αναγνωριστικών τοπικών ρυθμίσεων, η συνομιλία θα ξεκινήσει με τη μετάφραση απενεργοποιημένη.

• Εξετάστε το ενδεχόμενο να συμπεριλάβετε ελάχιστη επεξεργασία σε αυτήν τη λειτουργία, επειδή κάνει το περιβάλλον εργασίας χρήστη να περιμένει πριν από την απόδοση. Εάν ο χρόνος εκτέλεσης αυτής της λειτουργίας υπερβαίνει τα 30 δευτερόλεπτα, η συνομιλία θα ξεκινήσει με τη μετάφραση απενεργοποιημένη, ανεξάρτητα από τις τιμές της υπόσχεσης που επιστρέφεται.

• Εάν αυτή η μέθοδος δεν εφαρμοστεί, θα εμφανιστεί το ακόλουθο σφάλμα στον παράγοντα.

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

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