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

Contact centers

Σύνδεση από το 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:

  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 και στην τελική απόκρισή του, επομένως ο πράκτορας επιστρέφει την κλήση: αποχαιρετά και τερματίζει την κλήση και το σενάριό σας αναλαμβάνει ξανά τον καλούντα. Προσθέστε αυτόν τον αριθμό μεταφοράς (δείτε Προσθέστε τον αριθμό μεταφοράς):

{"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.