Το ThunderPhone v3 είναι πλέον διαθέσιμο.Ξεκινήστε μόνοι σας, από 2¢/λεπτό.Διαβάστε την ανακοίνωση

Contact centers

Σύνδεση από το 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. Στείλτε κλήσεις με περιβάλλον

  1. Επιλέξτε έναν αριθμό τηλεφώνου για τον πράκτορα στον SBC σας, όπως +14155550188.
  2. Στον SBC, δρομολογήστε κλήσεις προς αυτόν τον αριθμό στο sip_uri του τελικού σημείου, για παράδειγμα sip:agent-12-jhxmginwjx@sip.thunderphone.com, μέσω TLS στη θύρα 5061. Το ThunderPhone εντοπίζει το τελικό σημείο από το τμήμα χρήστη (agent-12-jhxmginwjx), το οποίο πρέπει να υπάρχει τόσο στο URI αιτήματος όσο και στην κεφαλίδα To. Μεταβιβάστε τα X-header χωρίς αλλαγές.
  3. Στο 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, επομένως η μεταβίβαση επιστρέφει μόνο μέσω της αναζήτησης.