Διαμόρφωση κεφαλίδων SIP X για παράγοντες με δυνατότητα φωνής

Σημείωμα

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

Αυτό το άρθρο εξηγεί πώς μπορείτε να ρυθμίσετε τις παραμέτρους των κεφαλίδων X του Πρωτοκόλλου προετοιμασίας περιόδου λειτουργίας (SIP) για εισερχόμενες και εξερχόμενες κλήσεις σε παράγοντες με δυνατότητα φωνής του Copilot Studio για χρήση σε Dynamics 365 Contact Center.

Οι κεφαλίδες SIP X σάς δίνουν τη δυνατότητα να μεταβιβάζετε προσαρμοσμένα μεταδεδομένα μεταξύ των συστημάτων τηλεφωνίας και των πρακτόρων σας με δυνατότητα φωνής. Οι πράκτορες ενεργοποιημένοι με φωνή στο Κέντρο Επαφών Dynamics 365 υποστηρίζουν και εισερχόμενες και εξερχόμενες X-headers. Αυτή η διαμόρφωση επιτρέπει την απρόσκοπτη ανταλλαγή δεδομένων κατά τη μεταφορά και τη δρομολόγηση κλήσεων.

Προϋποθέσεις

• Dynamics 365 Contact Center με ενεργοποιημένους παράγοντες με δυνατότητα φωνής

• Πρόσβαση στο Copilot Studio με τα κατάλληλα δικαιώματα

• Direct Routing για παραμετροποίηση τηλεφωνίας

• Βασική κατανόηση του Copilot Studio δημιουργία θεμάτων και διαχείριση μεταβλητών

Σημαντικό

Τα ονόματα και οι τιμές κεφαλίδας SIP X πρέπει να περιέχουν μόνο υποστηριζόμενους χαρακτήρες. Μάθετε περισσότερα σχετικά με τους υποστηριζόμενους χαρακτήρες στο θέμα Διαβίβαση δεδομένων βάσει περιεχομένου μεταξύ κλήσεων.

Ρύθμιση εισερχόμενων X-headers

Οι εισερχόμενες κεφαλίδες X περιέχουν μεταδεδομένα που μεταβιβάζονται από εξωτερικά συστήματα τηλεφωνίας στον αντιπρόσωπό σας με δυνατότητα φωνής. Για να λάβετε και να χρησιμοποιήσετε αυτά τα δεδομένα, πρέπει να διαμορφώσετε έναν κόμβο Parse Value για να εξαγάγετε πληροφορίες κεφαλίδας X από τη μεταβλητή Conversation.SipXHeader συστήματος.

Απαιτήσεις εισερχόμενης κεφαλίδας X

• Μέγιστος αριθμός: Πέντε κεφαλίδες X ανά εισερχόμενη κλήση.

• Απαίτηση ονομασίας: Όλα τα ονόματα των κεφαλίδων X πρέπει να ξεκινούν με x-.

  Σημείωμα

  Στο Copilot Studio, όλες οι εισερχόμενες κεφαλίδες X πρέπει να ξεκινούν με πεζούς χαρακτήρες x-, ακόμα και αν το εξωτερικό σύστημα που αποστέλλει την κεφαλίδα X χρησιμοποιεί κεφαλαία γράμματα X-. Η εξερχόμενη κεφαλίδα X που ορίζεται στο Copilot Studio μπορεί να είναι πεζή ή κεφαλαία, ανάλογα με τη μορφή που αναμένει το εξωτερικό σύστημα.

• Μήκος ονόματος: Έως 64 χαρακτήρες.

• Μήκος τιμής: Έως 256 χαρακτήρες.

• Απαιτείται ένα σχήμα JSON για όλες τις αναμενόμενες κεφαλίδες X.

• Ενημερώστε το σχήμα JSON όταν αλλάζουν τα ονόματα των κεφαλίδων X.

• Εξάρτηση δεδομένων καναλιού: Οι κεφαλίδες X πρέπει να υπάρχουν στο Conversation.SipXHeader.

Προσθήκη κόμβου διαχείρισης μεταβλητών - Ανάλυση τιμής

1. Μεταβείτε στο θέμα του εκπροσώπου σας με δυνατότητα φωνής.

2. Προσθέστε έναν νέο κόμβο θέματος.

3. Επιλέξτε Διαχείριση μεταβλητών και επιλέξτε Ανάλυση τιμής.

   

Διαμορφώστε τον κόμβο "Τιμή ανάλυσης"

1. Από το μενού Σύστημα , ορίστε το πεδίο Ανάλυση τιμής σε Conversation.SipXHeader.

2. Ορίστε τον τύπο δεδομένων σε Από δείγμα δεδομένων.

3. Ορίστε την αναμενόμενη δομή κεφαλίδας X επιλέγοντας Λήψη σχήματος από δείγμα JSON.

   

Ορισμός σχήματος JSON για κεφαλίδες X

Στο παράθυρο διαλόγου Λήψη σχήματος από δείγμα JSON , δώστε τη δομή JSON που περιλαμβάνει τα ονόματα των κεφαλίδων X που περιμένετε να λάβετε. Για παράδειγμα, εάν αναμένετε κεφαλίδες όπως X-CallID και X-AAI-Incoming σε μια εισερχόμενη κλήση, προσθέστε τις στο σχήμα JSON.

Επιλέξτε Επιβεβαίωση για να εφαρμόσετε το σχήμα.

Σημαντικό

Η πλατφόρμα Dynamics 365 Contact Center εξομαλύνει πάντα τα ονόματα των X-header ώστε να έχουν το πρόθημα πεζών χαρακτήρων x-, ανεξάρτητα από τον τρόπο αποστολής τους από το εξωτερικό σύστημα. Αυτό σημαίνει:

• Εάν το εξωτερικό σύστημα στέλνει X-CallID, πρέπει να το ορίσετε όπως x-CallID στο σχήμα σας.

• Εάν το εξωτερικό σύστημα στέλνει X-AAI-Incoming, πρέπει να το ορίσετε όπως x-AAI-Incoming στο σχήμα σας.

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

Παράδειγμα JSON για κεφαλίδες X

{

"x-CallID": "",

"x-AAI-Incoming": ""  
}

Αποθηκεύστε τα αναλυμένα δεδομένα

1. Δημιουργήστε ή επιλέξτε μια μεταβλητή στο πεδίο Αποθήκευση ως (για παράδειγμα, IncomingSipXHeader).

   

2. Ορίστε το εύρος της μεταβλητής σε Καθολικό για να επιτρέψετε την πρόσβαση σε πολλά θέματα στο copilot σας.

Πρόσβαση σε τιμές κεφαλίδας X στα θέματά σας

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

• Global.IncomingSipXHeader.'x-AAI-Incoming'

• IncomingSIPXHeaders.sipXHeader.'X-CallID'

Συμπεριφορά χρόνου εκτέλεσης

• Copilot Studio λαμβάνει μόνο τις πρώτες πέντε κεφαλίδες X που αποστέλλονται από το εξωτερικό σύστημα.

• το Copilot Studio συμπληρώνει αυτόματα την εγγραφή με τιμές κεφαλίδας X όταν τα ονόματα συμφωνούν με το σχήμα.

• Οι κεφαλίδες X που λείπουν έχουν κενές τιμές συμβολοσειράς.

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

Διαμόρφωση εξερχόμενων κεφαλίδων X

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

Απαιτήσεις εξερχόμενης κεφαλίδας X

• Μέγιστος αριθμός: Πέντε X-headers ανά μεταφορά.

• Απαίτηση ονομασίας: Όλα τα ονόματα των κεφαλίδων X μπορούν να ξεκινούν με ή X-, ανάλογα με x- την περίπτωση που περιμένει το εξωτερικό σύστημα.

  Σημείωμα

  Στο Copilot Studio, όλες οι εισερχόμενες κεφαλίδες X πρέπει να ξεκινούν με πεζούς χαρακτήρες x-, ακόμα και αν το εξωτερικό σύστημα που αποστέλλει την κεφαλίδα X χρησιμοποιεί κεφαλαία γράμματα X-. Η εξερχόμενη κεφαλίδα X που ορίζεται στο Copilot Studio μπορεί να είναι πεζή ή κεφαλαία, ανάλογα με τη μορφή που αναμένει το εξωτερικό σύστημα.

• Μήκος ονόματος: Έως 64 χαρακτήρες.

• Μήκος τιμής: Έως 256 χαρακτήρες.

• Τύπος μεταφοράς: Διατίθεται μόνο για μεταφορά εξωτερικού αριθμού τηλεφώνου.

Ρύθμιση του κόμβου μεταφοράς συνομιλίας

1. Προσθέστε έναν κόμβο Μεταφορά συνομιλίας στη ροή του θέματος.

2. Στην περιοχή Τύπος μεταφοράς, επιλέξτε Μεταφορά εξωτερικού αριθμού τηλεφώνου και εισαγάγετε τον αριθμό μεταφοράς. Για παράδειγμα, +18005551212.

Ρύθμιση παραμέτρων κεφαλίδων X στη Μεταφορά ιδιοτήτων κόμβου συνομιλίας

1. Επιλέξτε το εικονίδιο Περισσότερα του κόμβου (…) και, στη συνέχεια, επιλέξτε Ιδιότητες.

2. Επιλέξτε + Προσθήκη για να προσθέσετε ζεύγη κλειδιού-τιμής κεφαλίδας X.

   

3. Ορίστε τις καταχωρήσεις X-header. Τα εξερχόμενα ονόματα κεφαλίδων X αποστέλλονται ακριβώς όπως τα ορίζετε στον κόμβο συνομιλίας Μεταφορά . Επιλέξτε την κατάλληλη περίπτωση με βάση το τι αναμένει το σύστημα λήψης.

   • Όνομα κλειδιού: Πρέπει να ξεκινά με X- ή x- (για παράδειγμα, X-AAI-Outgoing ή X-CallID)
   • Τιμή: Εισαγάγετε μια στατική τιμή ή αντιστοιχίστε μια μεταβλητή

   

Βέλτιστες πρακτικές

Ακολουθήστε αυτές τις οδηγίες για τη σχεδίαση σχήματος, τη διαχείριση μεταβλητών, τον χειρισμό σφαλμάτων και τις επιδόσεις κατά την εργασία με κεφαλίδες SIP X στους παράγοντες με δυνατότητα φωνής. Μάθετε περισσότερα στα θέματα Εργαλεία, γνώσεις, MCP και API.

Σχεδιασμός σχήματος

• Χρησιμοποιήστε περιγραφικά ονόματα X-header που υποδεικνύουν ξεκάθαρα τον σκοπό τους.

• Διατηρήστε το σχήμα JSON ενημερωμένο όταν αλλάζουν οι απαιτήσεις κεφαλίδας X.

• Τεκμηριώστε το σχήμα X-header για αναφορά ομάδας και αντιμετώπιση προβλημάτων.

Διαχείριση μεταβλητών

• Χρησιμοποιήστε καθολικές μεταβλητές για δεδομένα κεφαλίδας X που πρέπει να προσπελαστούν σε όλα τα θέματα.

• Επιλέξτε σημαντικά ονόματα μεταβλητών (για παράδειγμα, IncomingSIPXHeaders ή CustomerXHeaders).

• Αρχικοποιήστε τις μεταβλητές νωρίς στη ροή της συνομιλίας σας.

Χειρισμός σφαλμάτων

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

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

• Δοκιμάστε διεξοδικά με διάφορα σενάρια X-header.

Θέματα επιδόσεων

• Αναλύστε τις κεφαλίδες X νωρίς στη ροή της συνομιλίας σας.

• Αποθηκεύστε προσωρινά τις τιμές που χρησιμοποιούνται συχνά σε ξεχωριστές μεταβλητές, εάν χρειάζεται.

• Αποφύγετε την επαναλαμβανόμενη ανάλυση των δεδομένων του ίδιου καναλιού.

Συνήθη προβλήματα με τις εισερχόμενες κεφαλίδες X

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

Οι τιμές της κεφαλίδας X δεν ελήφθησαν

• Βεβαιωθείτε ότι το σχήμα JSON ταιριάζει ακριβώς με τα αναμενόμενα ονόματα κεφαλίδων X.

• Βεβαιωθείτε ότι ο κόμβος Ανάλυση τιμής έχει ρυθμιστεί με Conversation.SipXHeader.

• Βεβαιωθείτε ότι η μεταβλητή έχει οριστεί σε καθολική εμβέλεια εάν έχετε πρόσβαση σε αυτή από πολλά θέματα.

• Βεβαιωθείτε ότι δεν αναμένονται περισσότερες από πέντε κεφαλίδες X και ότι οι κεφαλίδες X είναι οι πέντε κορυφαίες κεφαλίδες X που αποστέλλονται από το εξωτερικό σύστημα.

Κενές ή μηδενικές τιμές κεφαλίδας X

• Επιβεβαιώστε ότι το εξωτερικό σύστημα στέλνει κεφαλίδες X με τα αναμενόμενα ονόματα.

• Βεβαιωθείτε ότι το σχήμα JSON περιλαμβάνει όλα τα απαιτούμενα ονόματα κεφαλίδων X με πεζό x- πρόθεμα.

Συνήθη προβλήματα με κεφαλίδες X στα εξερχόμενα μηνύματα

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

Οι κεφαλίδες X δεν αποστέλλονται κατά τη μεταφορά

• Βεβαιωθείτε ότι όλα τα ονόματα των κεφαλίδων X ξεκινούν με X- ή x-.

• Βεβαιωθείτε ότι ο Τύπος μεταφοράς έχει οριστεί σε Μεταφορά εξωτερικού αριθμού τηλεφώνου.

• Βεβαιωθείτε ότι οι τιμές της κεφαλίδας X έχουν εκχωρηθεί σωστά πριν από τον κόμβο συνομιλίας Μεταφορά .

Η μεταφορά αποτυγχάνει με κεφαλίδες X

• Επιβεβαιώστε ότι τα ονόματα και οι τιμές των κεφαλίδων X δεν υπερβαίνουν τα όρια μήκους.

• Βεβαιωθείτε ότι το σύστημα λήψης μπορεί να χειριστεί τις κεφαλίδες X που αποστέλλονται.

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

Διαχείριση σχήματος

Διατηρήστε το σχήμα κεφαλίδας X οργανωμένο και ενημερωμένο καθώς αλλάζουν οι απαιτήσεις σας.

Ενημέρωση σχήματος κεφαλίδας X

• Ενημερώστε το δείγμα JSON στο Ορισμός σχήματος JSON για κεφαλίδες X ώστε να λαμβάνει νέες κεφαλίδες X.

• Επιβεβαιώστε και αποθηκεύστε το ενημερωμένο σχήμα.

• Δοκιμάστε το σχήμα με τη νέα διαμόρφωση κεφαλίδας X.