---
title: "Σύνδεση από το Genesys Cloud"
description: "Στείλτε κλήσεις Genesys Cloud σε έναν πράκτορα ThunderPhone μέσω ενός κορμού BYOC Cloud με το αναγνωριστικό συνομιλίας και το UUI, και λάβετε τις πίσω με τη μεταβίβαση στο UUI."
---

Η ροή Architect στέλνει τον καλούντα στον πράκτορα μέσω ενός κορμού BYOC Cloud, με το αναγνωριστικό συνομιλίας και οποιοδήποτε UUI ορίσετε. Όταν ο καλών χρειάζεται κάποιον άνθρωπο, ο πράκτορας στέλνει ένα SIP `REFER`, το Genesys ανακτά την κλήση και το αναγνωριστικό παράδοσης φτάνει στο UUI της κλήσης.

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

- Έναν πράκτορα ThunderPhone και ένα [κλειδί API](/el/guides/api-keys) οργανισμού.
- Genesys Cloud με BYOC Cloud και έναν εξωτερικό κορμό (τύπου BYOC Carrier ή
  PBX) με ενεργοποιημένες αυτές τις ρυθμίσεις
  ([ρυθμίσεις εξωτερικού κορμού](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Κεφαλίδες συνομιλίας**, ώστε το Genesys να στέλνει το αναγνωριστικό συνομιλίας του στο
    `x-inin-cnv`. Είναι απενεργοποιημένο από προεπιλογή.
  - **Διέλευση UUI**, με τύπο κεφαλίδας `User-To-User` και κωδικοποίηση Hex.
  - **Ανάκτηση και μεταφορά**, ώστε το Genesys να δέχεται το `REFER` του πράκτορα.

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

Το Genesys ανταποκρίνεται σε μια πρόκληση digest, επομένως χρησιμοποιήστε ένα τυπικό τελικό σημείο:

```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": "Genesys Cloud"}'
```

Αποθηκεύστε αμέσως το `password` από την απόκριση· εμφανίζεται μόνο μία φορά. Στον
κορμό:

| Ρύθμιση | Τιμή |
|---|---|
| Διακομιστής SIP | `sip.thunderphone.com`, θύρα `5061` |
| Πρωτόκολλο | TLS |
| Έλεγχος ταυτότητας digest | το `username` και το `password` του τελικού σημείου |
| Κωδικοποιητές | PCMU, PCMA ή G.722 |

Τοποθετήστε τον κορμό σε μια εξερχόμενη διαδρομή του ιστότοπού σας, της οποίας το σχέδιο αρίθμησης καλύπτει τη διεύθυνση που καλεί η ροή.

## 2. Στείλτε κλήσεις με περιβάλλον

Στη ροή Architect:

1. Προαιρετικά, προσθέστε μια ενέργεια **Ορισμός δεδομένων UUI** με περιβάλλον για τον πράκτορα, όπως
   `account=12345`. Το Genesys συνιστά 128 χαρακτήρες ή λιγότερους.
2. Προσθέστε μια ενέργεια **Μεταφορά σε αριθμό** με το `sip_uri` του τελικού σημείου, για
   παράδειγμα `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Το Genesys στέλνει το αναγνωριστικό συνομιλίας στο `x-inin-cnv`. Το ThunderPhone το αποθηκεύει ως
το `external_call_id` της κλήσης. Το UUI φτάνει στην προτροπή αποκωδικοποιημένο, ως
`{{sip_uui}}`.

Οι προσαρμοσμένες κεφαλίδες κορμού είναι στατικές στο Genesys, επομένως τοποθετήστε τις τιμές ανά κλήση στο UUI.
Το Genesys δεσμεύει για δική του χρήση τα προθέματα κεφαλίδων `x-inin`, `x-genesys`, `x-pcv` και `x-gcv`.

## 3. Ανακτήστε την κλήση

Ο πράκτορας μεταφέρει με ένα `REFER` σε μια διεύθυνση στο Genesys, με το αναγνωριστικό παράδοσης ως δεκαεξαδικό UUI μέσα σε αυτή τη διεύθυνση. Προσθέστε αυτόν τον αριθμό μεταφοράς (δείτε
[Προσθέστε τον αριθμό μεταφοράς](/el/guides/contact-centers/overview)
και [Κεφαλίδες μέσα στη διεύθυνση μεταφοράς](/el/guides/call-transfers)):

```json
{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

Αντικαταστήστε τη διεύθυνση με μία που δρομολογεί ξανά στην ουρά ή τη ροή που πρέπει
να αναλάβει τον καλούντα· επιβεβαιώστε τη μορφή της με το Genesys. Το `REFER` μοιάζει ως εξής:

```
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
```

Με ενεργοποιημένη την **Ανάκτηση και μεταφορά**, το Genesys ανακτά την κλήση από τον κορμό
και τη δρομολογεί σε αυτή τη διεύθυνση. Η τεκμηρίωση του Genesys αναφέρει ότι το εισερχόμενο UUI καταλήγει στο
`Call.UUIData`· δεν το τεκμηριώνει αυτό για ανάκτηση, επομένως επιβεβαιώστε με το
Genesys ή σε μια δοκιμαστική κλήση ότι η ροή που λαμβάνει τον καλούντα βρίσκει εκεί το
αναγνωριστικό παράδοσης. Για να λάβετε τη σύνοψη και την πρόθεση, καλέστε την αναζήτηση παράδοσης με
μια **Ενέργεια δεδομένων κλήσης** σε μια ενσωμάτωση Ενεργειών δεδομένων υπηρεσιών web:

- Αίτημα: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  ακολουθούμενο από το αναγνωριστικό από το `Call.UUIData`.
- Διαπιστευτήρια: το κλειδί API σας, αποσταλμένο ως `Authorization: Bearer sk_live_…`.
- Έξοδος: αντιστοιχίστε τα `handoff.summary` και `handoff.intent` σε μεταβλητές ροής.

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

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

Καλέστε έναν αριθμό που φτάνει στη ροή, ζητήστε από τον πράκτορα ένα άτομο και ελέγξτε ότι το
Genesys προωθεί την κλήση στη διεύθυνση που ορίσατε. Σε αυτή τη ροή, ελέγξτε ότι το
`Call.UUIData` περιέχει το αναγνωριστικό παράδοσης ως κείμενο (αν εμφανίζει δεκαεξαδικά ψηφία, ελέγξτε ότι η κωδικοποίηση UUI του trunk είναι Hex). Στη συνέχεια, ανοίξτε την κλήση με `GET /v1/calls/{call_id}`:
το `external_call_id` θα πρέπει να είναι το αναγνωριστικό συνομιλίας.

## Περιορισμοί

- Η ενέργεια **Λήψη κεφαλίδων SIP** διαβάζει μόνο το αρχικό `INVITE`, επομένως δεν μπορεί
  να διαβάσει τίποτα από το `REFER` του πράκτορα. Η παράδοση φτάνει στο Genesys μόνο
  μέσω UUI.
- Το Genesys απορρίπτει όλα τα UUI όταν μια κλήση περιέχει περισσότερες από μία κεφαλίδες UUI.
- Η διεύθυνση μεταφοράς περιορίζεται στους 254 χαρακτήρες, επομένως ένα μεγάλο UUI περικόπτεται για να χωρέσει.
  Ένα αναγνωριστικό παράδοσης χωράει πάντα.
