Κοινοποίηση μέσω

getAgentAvailability

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

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

Σημείωμα

  • Ακούστε το συμβάν lcw:ready που προκύπτει από μια ζωντανή συνομιλία προτού καλέσετε τις μεθόδους SDK ζωντανής συνομιλίας. Οι μέθοδοι ζωντανής συνομιλίας μπορούν να ενεργοποιηθούν μετά την αύξηση του συμβάντος lcw:ready . Μπορείτε να ακούσετε αυτό το συμβάν προσθέτοντας το δικό σας πρόγραμμα ακρόασης συμβάντων στο αντικείμενο παραθύρου.
  • Αυτή η μέθοδος μπορεί να κληθεί πολλές φορές από την πλευρά του υπολογιστή-πελάτη όταν αλλάζει η είσοδος του πελάτη. Η μνήμη cache του υπολογιστή-πελάτη ανανεώνεται κάθε 2 λεπτά ή όταν αλλάζουν οι παράμετροι περιβάλλοντος πελάτη.
  • Αυτή η μέθοδος μπορεί να ονομαστεί 100 φορές ανά λεπτό ανά οργανισμό μόνο. Εάν υπερβείτε το όριο, εμφανίζεται ο κωδικός κατάστασης απόκρισης http 429 που υποδεικνύει ότι στείλατε πάρα πολλές αιτήσεις σε ένα καθορισμένο χρονικό διάστημα.

Σύνταξη

Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();

Παράμετροι

None

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

Ονομασία Type Περιγραφή
queueId Συμβλοσειρά Η ουρά προορισμού όπου δρομολογείται το αίτημα με βάση τη διαμόρφωση του κανόνα δρομολόγησης και τα δεδομένα εισόδου (παρέχονται η τιμή της οντότητας και του περιβάλλοντος που αποτελούν μέρος του κανόνα δρομολόγησης).
isQueueAvailable Δυαδική τιμή Εμφανίζει:
- TRUE εάν η ουρά είναι εντός των ωρών λειτουργίας.
- ΛΑΘΟΣ εάν η ουρά είναι εκτός ωρών λειτουργίας.
StartTimeOfNextOperatingHour Ημερομηνία/ώρα Η ώρα έναρξης (UTC) των ωρών λειτουργίας για την ουρά, εάν είναι εκτός ωρών λειτουργίας. Κατά τις ώρες λειτουργίας, επιστρέφεται η τιμή 01-01-0001.
EndTimeOfNextOperatingHour Ημερομηνία/ώρα Η ώρα (UTC) κατά τις ώρες λειτουργίας λήγει για την ουρά εάν είναι εκτός ωρών λειτουργίας. Κατά τις ώρες λειτουργίας, επιστρέφεται η τιμή 01-01-0001.
nexttransitiontime Ημερομηνία/ώρα Η ώρα (UTC) κατά την οποία η ουρά λειτουργεί ξανά, εάν είναι εκτός ωρών λειτουργίας. Η ώρα που η ουρά δεν λειτουργεί εμφανίζεται κατά τις ώρες λειτουργίας.
positionInQueue Αριθμός Η θέση στην ουρά για έναν πελάτη που περιμένει πίσω από άλλους πελάτες στην ίδια ουρά.
isAgentAvailable Δυαδική τιμή Εμφανίζει:
- TRUE εάν οι πράκτορες στην ουρά είναι διαθέσιμοι αυτήν τη στιγμή για τη λήψη αιτήσεων βάσει ρυθμισμένων κανόνων δρομολόγησης και ανάθεσης για ροή εργασίας. Το API επιστρέφει επίσης true εάν ένα bot είναι συνδεδεμένο στη ροή εργασίας ή σε μια ουρά. Συνιστούμε αυτό το API να μην χρησιμοποιείται όταν υπάρχει bot.
- ΛΑΘΟΣ εάν οι πράκτορες δεν είναι διαθέσιμοι για να λάβουν αιτήματα.
averageWaitTime Αριθμός Μέσος χρόνος αναμονής σε λεπτά για πελάτες στην ουρά προορισμού με βάση δεδομένα προηγούμενων 48 ωρών.

Παράδειγμα

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
               // Gets the agent availability
               Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();
});

Μεταβίβαση προσαρμοσμένων τιμών περιβάλλοντος για τη συνάρτηση για να βεβαιωθείτε ότι λαμβάνεται το περιβάλλον

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

Σημείωμα

Δεν χρειάζεται να καλέσετε τη μέθοδο setContextProvider πριν καλέσετε το getAgentAvailability.

Ακολουθεί ένα δείγμα κώδικα που δείχνει τον τρόπο χρήσης της setContextProvider μεθόδου.

// To set the custom context, pass the custom context object as input parameter to agent availability

    // provider as part of the logic, so there is no need to set custom context before this call.

    Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability({

        customContext : {

                'jwtToken': {'value':'token','isDisplayable':true},

                'Email': {'value':'test@test.com','isDisplayable':true},

                'client': {'value':'true','isDisplayable':true},

                'Emailing': {'value':'true','isDisplayable':true}

        }

    }

    );

έναρξηΣυνομιλία
setContextProvider
Αναφορά SDK ζωντανής συνομιλίας

  • Last updated on