---
title: "Σύνδεση από το NICE CXone"
description: "Στείλτε κλήσεις NICE CXone σε έναν πράκτορα ThunderPhone από ένα σενάριο Studio με το ContactID σε κεφαλίδα SIP και αναζητήστε την παράδοση του πράκτορα όταν το σενάριο συνεχίζεται."
---

Το σενάριο CXone Studio πραγματοποιεί μια κλήση προς τον πράκτορα με κεφαλίδες SIP που μεταφέρουν το αναγνωριστικό επαφής και οποιοδήποτε άλλο περιεχόμενο. Όταν ο πράκτορας ολοκληρώσει, τερματίζει την κλήση και μια ενέργεια REST API στο σενάριο ανακτά τη μεταβίβαση.

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

- Έναν πράκτορα ThunderPhone και ένα [κλειδί API](/el/guides/api-keys) οργανισμού.
- Μια ομάδα SIP trunk του CXone που δέχεται προσαρμοσμένες κεφαλίδες. Ο υπεύθυνος λογαριασμού NICE πρέπει να ενεργοποιήσει αυτή τη ρύθμιση προτού το CXone τις αποστείλει.

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

Το Placecall καλεί έναν αριθμό τηλεφώνου μέσω μιας ομάδας trunk του CXone, όχι μια διεύθυνση SIP. Η NICE δεν τεκμηριώνει διαπιστευτήρια SIP για αυτό και η ενσωμάτωση CXone άλλου παρόχου AI χρησιμοποιεί TLS με λίστα επιτρεπόμενων διευθύνσεων IP. Επομένως, δημιουργήστε ένα τελικό σημείο `ip_allowlist` με τον αριθμό που θα καλέσει το σενάριο ως αριθμό εισερχόμενης κλήσης (δείτε [Πλατφόρμες που καλούν έναν αριθμό τηλεφώνου](/el/guides/sip-addresses)):

```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": "NICE CXone",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: τα εύρη σηματοδότησης SIP του συμπλέγματος CXone σας, από τη NICE. Κάθε εύρος πρέπει να είναι δημόσιο εύρος IPv4 `/16` ή στενότερο (IPv6 `/48` ή στενότερο).
- `dial_in_numbers`: ο αριθμός που θα καλέσει το Placecall, γραμμένος με τον τρόπο που τον αποστέλλει το CXone. Δεν χρειάζεται να είναι πραγματικός αριθμός τηλεφώνου. Δεν μπορεί να χρησιμοποιείται ήδη στο ThunderPhone, είτε ως αριθμός τηλεφώνου είτε σε άλλο τελικό σημείο: αυτό επιστρέφει `409`.

Οι διευθύνσεις του CXone είναι κοινόχρηστες για όλους τους πελάτες του, επομένως οποιοσδήποτε άλλος πελάτης CXone καλέσει τον αριθμό φτάνει στον πράκτορά σας. Όπου επιλέγετε τον αριθμό, επιλέξτε έναν μεγάλο αριθμό που δεν θα μάντευε κανείς (έως 15 ψηφία), βεβαιωθείτε ότι το CXone τον αποστέλλει στο ThunderPhone αντί να τον προωθεί στο τηλεφωνικό δίκτυο και μην τον δημοσιεύσετε.

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

Στο σενάριο Studio σας, πριν από το **Placecall**:

1. Προσθέστε μια ενέργεια **Sipputheader** με κεφαλίδα `X-Call-ID` και την τιμή του `ContactID`. Το CXone δεν στέλνει δική του κεφαλίδα αναγνωριστικού κλήσης· το ThunderPhone αποθηκεύει αυτήν ως `external_call_id` της κλήσης.
2. Προσθέστε μια ενέργεια **Sipputheader** για κάθε άλλη τιμή που πρέπει να γνωρίζει ο πράκτορας, όπως `X-Skill` με τιμή `support`. Φτάνει στην προτροπή ως `{{sip_x_skill}}`. Το Sipputheader δέχεται `User-to-User`, οποιαδήποτε κεφαλίδα `X-` και τις περισσότερες κεφαλίδες `P-`· η NICE συνιστά τιμές έως 256 χαρακτήρες.

Έπειτα, χρησιμοποιήστε **Placecall** προς αυτόν τον αριθμό, μέσω μιας ομάδας trunk που τον στέλνει στο `sip.thunderphone.com` με τον αριθμό τόσο στο URI αιτήματος όσο και στην κεφαλίδα `To`. Το τελικό σημείο δέχεται TLS (θύρα 5061) ή TCP (θύρα 5060) και απορρίπτει UDP· η NICE δεν τεκμηριώνει τη μεταφορά του trunk, επομένως βεβαιωθείτε ότι δεν είναι UDP.

## 3. Επαναφέρετε την κλήση

Το CXone διαβάζει κεφαλίδες SIP μόνο στο `INVITE` και στην τελική απόκρισή του, επομένως ο πράκτορας επιστρέφει την κλήση: αποχαιρετά και τερματίζει την κλήση και το σενάριό σας αναλαμβάνει ξανά τον καλούντα. Προσθέστε αυτόν τον αριθμό μεταφοράς (δείτε [Προσθέστε τον αριθμό μεταφοράς](/el/guides/contact-centers/overview)):

```json
{"name": "NICE CXone", "action": "return"}
```

Η NICE δεν τεκμηριώνει ότι ένα σενάριο συνεχίζει μετά το Placecall όταν ολοκληρώνεται η πραγματοποιημένη κλήση. Οι ενσωματώσεις CXone άλλων παρόχων AI σηματοδοτούν αντίθετα το σενάριο μέσω του Signal API του CXone (`POST /interactions/{contactId}/signal`) προτού τερματίσουν την κλήση· το ThunderPhone δεν το καλεί. Επιβεβαιώστε με τη NICE πώς το σενάριό σας ανακτά τον καλούντα και, στη συνέχεια, ανακτήστε τη μεταβίβαση με μια ενέργεια **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ακολουθούμενο από το `ContactID`.
- Κεφαλίδα `Authorization: Bearer sk_live_…`.
- Διαβάστε τα `handoff.summary` και `handoff.intent` από την απόκριση για να δρομολογήσετε την επαφή.

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

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

Καλέστε έναν αριθμό που εκτελεί το script, ζητήστε από τον πράκτορα ένα άτομο και ελέγξτε ότι
το script συνεχίζεται και η ενέργεια REST API επιστρέφει την προώθηση. Αν η κλήση
δεν φτάνει ποτέ στον πράκτορα, ελέγξτε τον αριθμό που στέλνει το CXone, ότι η διεύθυνση προέλευσής του
βρίσκεται στο `allowed_source_cidrs` και ότι η κλήση πραγματοποιήθηκε μέσω TCP ή TLS. Στη συνέχεια, ανοίξτε την
κλήση με `GET /v1/calls/{call_id}`: το `sip_headers` πρέπει να περιλαμβάνει το `x-call-id` και
το `external_call_id` πρέπει να ισούται με το `ContactID`.

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

- Το CXone στέλνει και διαβάζει κεφαλίδες μόνο στο `INVITE` και στο τελικό `2xx` του, επομένως
  τίποτα από το `BYE` του πράκτορα δεν φτάνει στο script.
- Η NICE δεν τεκμηριώνει την αποδοχή ενός `REFER` από τον πράκτορα.
- Η ενέργεια REST API λήγει χρονικά μετά από 10 δευτερόλεπτα από προεπιλογή (το πολύ κάτω από 90)
  και διαβάζει αποκρίσεις έως 32 KB.
