Open in
Σύνδεση από το NICE CXone
Στείλτε κλήσεις NICE CXone σε έναν πράκτορα ThunderPhone από ένα σενάριο Studio με το ContactID σε κεφαλίδα SIP και αναζητήστε την παράδοση του πράκτορα όταν το σενάριο συνεχίζεται.
Το σενάριο CXone Studio πραγματοποιεί μια κλήση προς τον πράκτορα με κεφαλίδες SIP που μεταφέρουν το αναγνωριστικό επαφής και οποιοδήποτε άλλο περιεχόμενο. Όταν ο πράκτορας ολοκληρώσει, τερματίζει την κλήση και μια ενέργεια REST API στο σενάριο ανακτά τη μεταβίβαση.
Πριν ξεκινήσετε
- Έναν πράκτορα ThunderPhone και ένα κλειδί API οργανισμού.
- Μια ομάδα SIP trunk του CXone που δέχεται προσαρμοσμένες κεφαλίδες. Ο υπεύθυνος λογαριασμού NICE πρέπει να ενεργοποιήσει αυτή τη ρύθμιση προτού το CXone τις αποστείλει.
1. Δημιουργήστε το τελικό σημείο SIP
Το Placecall καλεί έναν αριθμό τηλεφώνου μέσω μιας ομάδας trunk του CXone, όχι μια διεύθυνση SIP. Η NICE δεν τεκμηριώνει διαπιστευτήρια SIP για αυτό και η ενσωμάτωση CXone άλλου παρόχου AI χρησιμοποιεί TLS με λίστα επιτρεπόμενων διευθύνσεων IP. Επομένως, δημιουργήστε ένα τελικό σημείο ip_allowlist με τον αριθμό που θα καλέσει το σενάριο ως αριθμό εισερχόμενης κλήσης (δείτε Πλατφόρμες που καλούν έναν αριθμό τηλεφώνου):
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:
- Προσθέστε μια ενέργεια Sipputheader με κεφαλίδα
X-Call-IDκαι την τιμή τουContactID. Το CXone δεν στέλνει δική του κεφαλίδα αναγνωριστικού κλήσης· το ThunderPhone αποθηκεύει αυτήν ωςexternal_call_idτης κλήσης. - Προσθέστε μια ενέργεια 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 και στην τελική απόκρισή του, επομένως ο πράκτορας επιστρέφει την κλήση: αποχαιρετά και τερματίζει την κλήση και το σενάριό σας αναλαμβάνει ξανά τον καλούντα. Προσθέστε αυτόν τον αριθμό μεταφοράς (δείτε Προσθέστε τον αριθμό μεταφοράς):
{"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από την απόκριση για να δρομολογήσετε την επαφή.
Δείτε Αναζήτηση μιας μεταβιβασμένης κλήσης.
Δοκιμάστε το
Καλέστε έναν αριθμό που εκτελεί το 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.