---
title: "Σύνδεση από το Microsoft Dynamics 365"
description: "Δρομολογήστε κλήσεις από το Dynamics 365 Contact Center και το Copilot Studio σε έναν πράκτορα ThunderPhone μέσω του SBC σας με κεφαλίδες X και αναζητήστε την παράδοση του πράκτορα μέσω HTTP."
---

Το Contact Center του Dynamics 365 στέλνει τον καλούντα στον πράκτορα μέσω του
ελεγκτή ορίων συνεδρίας (SBC), με έως πέντε X-header που περιλαμβάνουν το αναγνωριστικό
συνομιλίας. Όταν ο πράκτορας ολοκληρώσει, τερματίζει την κλήση, ο SBC σας επαναφέρει τον
καλούντα στο Dynamics 365 και ένας κόμβος Αιτήματος HTTP ανακτά την παράδοση.

## Πριν ξεκινήσετε

- Έναν πράκτορα ThunderPhone και ένα [κλειδί API](/el/guides/api-keys) οργανισμού.
- Το κανάλι φωνής του Contact Center του Dynamics 365, συνδεδεμένο μέσω του Azure
  Communication Services **Direct Routing** με έναν SBC που διαχειρίζεστε
  ([απαιτήσεις SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  έναν υποστηριζόμενο SBC με δημόσιο πιστοποιητικό, TLS 1.2 στη θύρα 5061 και SRTP
  προς τη Microsoft.
- **Υποστήριξη SIP X-header** στον κόμβο **Μεταφορά συνομιλίας**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Επιβεβαιώστε ότι είναι διαθέσιμη στο περιβάλλον σας.

Το Dynamics 365 μεταφέρει μόνο σε έναν αριθμό τηλεφώνου και η Microsoft πραγματοποιεί
έλεγχο ταυτότητας του Direct Routing με πιστοποιητικό, όχι με κωδικό πρόσβασης. Ο SBC σας
βρίσκεται μεταξύ της Microsoft και του ThunderPhone και μετατρέπει αυτόν τον αριθμό στη
διεύθυνση SIP του πράκτορα.

## 1. Δημιουργήστε το τελικό σημείο SIP

Η κλήση φτάνει στο ThunderPhone από τον SBC σας, επομένως δημιουργήστε ένα τυπικό τελικό
σημείο για να χρησιμοποιεί ο SBC:

```bash
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 προέλευσης](/el/guides/sip-addresses).

## 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` να διατηρεί το όνομά του
([προσαρμοσμένο περιβάλλον](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Λάβετε πίσω την κλήση

Ο πράκτορας επιστρέφει την κλήση: αποχαιρετά και τερματίζει την κλήση. Προσθέστε αυτόν τον αριθμό
μεταφοράς (δείτε
[Προσθέστε τον αριθμό μεταφοράς](/el/guides/contact-centers/overview)):

```json
{"name": "Dynamics 365", "action": "return"}
```

Η επαναφορά του καλούντος στο Dynamics 365 είναι αρμοδιότητα του SBC σας. Η Microsoft
τεκμηριώνει έναν τρόπο εισόδου για κλήση με περιεχόμενο: μια νέα κλήση μέσω του SBC προς έναν
αριθμό καταχωρισμένο στο Dynamics 365, με UUI του οποίου τα κλειδιά αντιστοιχούν στις μεταβλητές
περιεχομένου που ρυθμίσατε στις **Ροές εργασίας → Ρυθμίσεις για προχωρημένους**
([μεταφορά IVR τρίτου μέρους](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-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`.

Δείτε [Αναζητήστε μια μεταβιβασμένη κλήση](/api-reference/calls#look-up-a-handed-off-call).

## Δοκιμάστε το

Καλέστε έναν αριθμό 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`, επομένως η μεταβίβαση επιστρέφει
  μόνο μέσω της αναζήτησης.
