Open in
Σύνδεση από το Microsoft Dynamics 365
Δρομολογήστε κλήσεις από το Dynamics 365 Contact Center και το Copilot Studio σε έναν πράκτορα ThunderPhone μέσω του SBC σας με κεφαλίδες X και αναζητήστε την παράδοση του πράκτορα μέσω HTTP.
Το Contact Center του Dynamics 365 στέλνει τον καλούντα στον πράκτορα μέσω του ελεγκτή ορίων συνεδρίας (SBC), με έως πέντε X-header που περιλαμβάνουν το αναγνωριστικό συνομιλίας. Όταν ο πράκτορας ολοκληρώσει, τερματίζει την κλήση, ο SBC σας επαναφέρει τον καλούντα στο Dynamics 365 και ένας κόμβος Αιτήματος HTTP ανακτά την παράδοση.
Πριν ξεκινήσετε
- Έναν πράκτορα ThunderPhone και ένα κλειδί API οργανισμού.
- Το κανάλι φωνής του Contact Center του Dynamics 365, συνδεδεμένο μέσω του Azure Communication Services Direct Routing με έναν SBC που διαχειρίζεστε (απαιτήσεις SBC): έναν υποστηριζόμενο SBC με δημόσιο πιστοποιητικό, TLS 1.2 στη θύρα 5061 και SRTP προς τη Microsoft.
- Υποστήριξη SIP X-header στον κόμβο Μεταφορά συνομιλίας (Copilot Studio). Επιβεβαιώστε ότι είναι διαθέσιμη στο περιβάλλον σας.
Το Dynamics 365 μεταφέρει μόνο σε έναν αριθμό τηλεφώνου και η Microsoft πραγματοποιεί έλεγχο ταυτότητας του Direct Routing με πιστοποιητικό, όχι με κωδικό πρόσβασης. Ο SBC σας βρίσκεται μεταξύ της Microsoft και του ThunderPhone και μετατρέπει αυτόν τον αριθμό στη διεύθυνση SIP του πράκτορα.
1. Δημιουργήστε το τελικό σημείο SIP
Η κλήση φτάνει στο ThunderPhone από τον SBC σας, επομένως δημιουργήστε ένα τυπικό τελικό σημείο για να χρησιμοποιεί ο SBC:
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"agent_id": 12, "name": "Dynamics 365 SBC"}'Αποθηκεύστε αμέσως το password από την απόκριση· εμφανίζεται μία φορά και ο SBC σας
απαντά στην πρόκληση του ThunderPhone με αυτό. Αν ο SBC σας δεν υποστηρίζει έλεγχο
ταυτότητας digest, δημιουργήστε αντί για αυτό το τελικό σημείο με το auth ορισμένο σε
ip_allowlist και τη δημόσια διεύθυνση του SBC σας· ανατρέξτε στις
Πλατφόρμες που πραγματοποιούν έλεγχο ταυτότητας βάσει IP προέλευσης.
2. Στείλτε κλήσεις με περιβάλλον
- Επιλέξτε έναν αριθμό τηλεφώνου για τον πράκτορα στον SBC σας, όπως
+14155550188. - Στον SBC, δρομολογήστε κλήσεις προς αυτόν τον αριθμό στο
sip_uriτου τελικού σημείου, για παράδειγμαsip:agent-12-jhxmginwjx@sip.thunderphone.com, μέσω TLS στη θύρα5061. Το ThunderPhone εντοπίζει το τελικό σημείο από το τμήμα χρήστη (agent-12-jhxmginwjx), το οποίο πρέπει να υπάρχει τόσο στο URI αιτήματος όσο και στην κεφαλίδαTo. Μεταβιβάστε τα X-header χωρίς αλλαγές. - Στο Copilot Studio, προσθέστε έναν κόμβο Μεταφορά συνομιλίας με
Μεταφορά σε εξωτερικό αριθμό τηλεφώνου προς αυτόν τον αριθμό και προσθέστε τα X-header:
X-Call-ID: το αναγνωριστικό συνομιλίας του Dynamics 365. Καμία κεφαλίδα της Microsoft δεν το μεταφέρει, επομένως προσθέστε το εδώ· το ThunderPhone το αποθηκεύει ως τοexternal_call_idτης κλήσης. Επιβεβαιώστε στο Copilot Studio ποια μεταβλητή περιέχει το αναγνωριστικό συνομιλίας.- Έως τέσσερα ακόμη, όπως
X-Customer-Tier.
Η Microsoft στέλνει το πολύ πέντε X-header, με ονόματα έως 64 χαρακτήρες και
τιμές έως 256, χρησιμοποιώντας γράμματα, ψηφία και = ; . ! % * _ + ~ -. Γράφει
το πρόθεμα με πεζά ως x-· το ThunderPhone αντιστοιχίζει ονόματα κεφαλίδων χωρίς διάκριση
πεζών-κεφαλαίων, επομένως το x-customer-tier φτάνει στην προτροπή ως {{sip_x_customer_tier}}.
Αν δημιουργείτε την κλήση με το Azure Communication Services Call Automation
αντί για αυτό, το AddSipX γράφει από προεπιλογή ονόματα X-MS-Custom-. Μεταβιβάστε
το SipHeaderPrefix.X ώστε το X-Call-ID να διατηρεί το όνομά του
(προσαρμοσμένο περιβάλλον).
3. Λάβετε πίσω την κλήση
Ο πράκτορας επιστρέφει την κλήση: αποχαιρετά και τερματίζει την κλήση. Προσθέστε αυτόν τον αριθμό μεταφοράς (δείτε Προσθέστε τον αριθμό μεταφοράς):
{"name": "Dynamics 365", "action": "return"}Η επαναφορά του καλούντος στο Dynamics 365 είναι αρμοδιότητα του SBC σας. Η Microsoft
τεκμηριώνει έναν τρόπο εισόδου για κλήση με περιεχόμενο: μια νέα κλήση μέσω του SBC προς έναν
αριθμό καταχωρισμένο στο Dynamics 365, με UUI του οποίου τα κλειδιά αντιστοιχούν στις μεταβλητές
περιεχομένου που ρυθμίσατε στις Ροές εργασίας → Ρυθμίσεις για προχωρημένους
(μεταφορά IVR τρίτου μέρους).
Συμφωνήστε με τον προμηθευτή του SBC σας πώς ο καλών φτάνει σε αυτόν τον αριθμό όταν το
ThunderPhone τερματίζει την κλήση και μεταφέρετε το αναγνωριστικό συνομιλίας που στείλατε στο X-Call-ID,
ώστε η ροή να μπορεί να εντοπίσει την κλήση.
Στη συνέχεια, ανακτήστε τη μεταβίβαση με έναν κόμβο Αίτημα HTTP του Copilot Studio:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ακολουθούμενο από το αναγνωριστικό συνομιλίας.- Κεφαλίδα
Authorization: Bearer sk_live_…. - Αναλύστε την απόκριση σε μια μεταβλητή και χρησιμοποιήστε τα
handoff.summaryκαιhandoff.intent.
Δείτε Αναζητήστε μια μεταβιβασμένη κλήση.
Δοκιμάστε το
Καλέστε έναν αριθμό Dynamics 365 που φτάνει στον κόμβο μεταφοράς, ζητήστε από τον πράκτορα να σας
συνδέσει με έναν άνθρωπο και ελέγξτε ότι ο καλών επιστρέφει στο Dynamics 365. Στη συνέχεια, ανοίξτε την
κλήση με GET /v1/calls/{call_id}: το sip_headers θα πρέπει να περιλαμβάνει το x-call-id και το
external_call_id θα πρέπει να είναι το αναγνωριστικό συνομιλίας. Αν η κλήση δεν φτάνει ποτέ στον
πράκτορα και τα αρχεία καταγραφής του SBC εμφανίζουν SIP 404, το URI αιτήματός του ή η κεφαλίδα To
δεν περιέχει το τμήμα χρήστη του τελικού σημείου.
Περιορισμοί
- Απαιτείται SBC. Η Microsoft δεν μπορεί να καλέσει μια διεύθυνση SIP ούτε να απαντήσει σε μια πρόκληση σύνοψης.
- Η Microsoft στέλνει το πολύ πέντε κεφαλίδες X και διατηρεί μόνο τις πρώτες πέντε σε μια εισερχόμενη κλήση. Το Dynamics 365 δέχεται το πολύ 128 χαρακτήρες UUI.
- Η Microsoft δεν τεκμηριώνει την ανάγνωση κεφαλίδων σε ένα
BYE, επομένως η μεταβίβαση επιστρέφει μόνο μέσω της αναζήτησης.