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

Contact centers

Σύνδεση από το Zoom Contact Center

Στείλτε κλήσεις του Zoom Contact Center σε έναν πράκτορα ThunderPhone με έναν σύνδεσμο φωνητικού bot τρίτου μέρους και μεταφέρετέ τες ξανά σε ανθρώπινο πράκτορα με SIP REFER.

Ένα γραφικό στοιχείο ρομπότ στη ροή Zoom Contact Center στέλνει τον καλούντα στον πράκτορα με το αναγνωριστικό κλήσης του Zoom. Όταν ο καλών χρειάζεται άνθρωπο, ο πράκτορας στέλνει ένα SIP REFER στη διεύθυνση ανθρώπινου πράκτορα του Zoom και η ροή σας ανακτά την προώθηση με το αναγνωριστικό κλήσης.

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

  • Έναν πράκτορα ThunderPhone και ένα κλειδί API οργανισμού.
  • Μια Γενική εφαρμογή του Zoom Marketplace, που διαχειρίζεται ο διαχειριστής σας και είναι διαθέσιμη στο Contact Center, με έναν σύνδεσμο για το γραφικό στοιχείο ρομπότ (οδηγός φωνητικών bot τρίτων του Zoom).
  • Έναν κορμό SIP από το Zoom προς τον πάροχο bot. Η ομάδα ISV του Zoom τον δημιουργεί σταδιακά (διερεύνηση, κορμός προετοιμασίας και έπειτα παραγωγή), και το Όνομα εταιρείας της εφαρμογής πρέπει να αντιστοιχεί ακριβώς στην εγγραφή του κορμού. Αυτή η ρύθμιση ξεκινά με την υποστήριξη του ThunderPhone και το Zoom, όχι μόνο στον λογαριασμό σας στο Zoom.

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

Ο σύνδεσμος του Zoom καλεί έναν 15ψήφιο αριθμό που αρχίζει με 999, όχι μια διεύθυνση SIP. Η αποθήκευση του συνδέσμου δημιουργεί αυτόν τον αριθμό. Ο κορμός του Zoom χρησιμοποιεί TLS 1.2 στη θύρα 5061 με SRTP για ήχο και επιτρέπεται βάσει λίστας από τα υποδίκτυα του Zoom αντί για κωδικό πρόσβασης. Επομένως, δημιουργήστε ένα τελικό σημείο ip_allowlist με τον αριθμό του συνδέσμου ως αριθμό εισερχόμενης κλήσης και με υποχρεωτικό SRTP (βλ. Πλατφόρμες που καλούν έναν αριθμό τηλεφώνου):

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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
  • allowed_source_cidrs: τα υποδίκτυα σηματοδότησης SIP του Zoom, τα οποία παρέχει το Zoom. Κάθε ένα πρέπει να είναι δημόσιο εύρος IPv4 /16 ή στενότερο (IPv6 /48 ή στενότερο).
  • dial_in_numbers: ο αριθμός του συνδέσμου ακριβώς όπως τον στέλνει το Zoom, χωρίς +.
  • srtp: required, επειδή ο κορμός του Zoom χρησιμοποιεί πάντα SRTP.

Οι διευθύνσεις του Zoom είναι κοινές για όλους τους πελάτες του, επομένως οποιοσδήποτε άλλος πελάτης του Zoom που καλεί τον αριθμό φτάνει στον πράκτορά σας. Το Zoom εκχωρεί τον αριθμό· μην τον δημοσιεύετε.

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

Προσθέστε ένα γραφικό στοιχείο ρομπότ στη ροή σας και συσχετίστε το με τον σύνδεσμο. Ζητήστε από την ομάδα ISV του Zoom να κατευθύνει τον κορμό στο sip.thunderphone.com, με TLS στη θύρα 5061 και με τον αριθμό του συνδέσμου τόσο στο URI αιτήματος όσο και στην κεφαλίδα To. Το τελικό σημείο αρνείται το UDP, επομένως βεβαιωθείτε ότι ο κορμός δεν επιστρέφει σε αυτό.

Το Zoom στέλνει:

  • X-ZOOM-Call-Sid, που αποθηκεύεται ως το external_call_id της κλήσης. Η σελίδα αντιστοίχισης δεδομένων του ίδιου του Zoom δεν το παραθέτει· η ενσωμάτωση Zoom άλλου παρόχου AI το τεκμηριώνει, επομένως ελέγξτε το στην πρώτη δοκιμαστική κλήση σας.
  • X-ZOOM-DNIS, τον αριθμό που κάλεσε ο καλών, ως {{sip_x_zoom_dnis}}.
  • X-ZOOM-WEBHOOK, το Στατικό URL του συνδέσμου.

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

Ο πράκτορας στέλνει ένα REFER στη διεύθυνση του ανθρώπινου πράκτορα στο SBC του Zoom. Προσθέστε αυτόν τον αριθμό μεταβίβασης (δείτε Προσθέστε τον αριθμό μεταβίβασης), με τη διεύθυνση SBC που σας δίνει το Zoom:

{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}

Ο οδηγός του Zoom περιγράφει δύο τρόπους με τους οποίους ένα ρομπότ μεταβιβάζει το περιεχόμενο: ένα POST στο Στατικό URL του συνδέσμου πριν από το REFER (το voicebot_metadata και παρόμοια συμβάντα), και κεφαλίδες SIP που αντιστοιχίζονται στην ενότητα Εισερχόμενα από ρομπότ. Το ThunderPhone δεν δημοσιεύει στο Στατικό URL. Ο οδηγός του Zoom δεν αναφέρει αν διαβάζει αντιστοιχισμένες κεφαλίδες από ένα REFER; αν θέλετε να το δοκιμάσετε, προσθέστε headers όπως "X-Handoff-Id": "{{handoff_id}}" στην καταχώριση και ελέγξτε σε μια δοκιμαστική κλήση. Επίσης, επιβεβαιώστε με το Zoom ότι δέχεται ένα REFER χωρίς POST μεταδεδομένων πριν από αυτό.

Για να λάβετε τη μεταβίβαση χωρίς να βασίζεστε σε κανένα από τα δύο, ζητήστε από τη ροή σας να την αναζητήσει μετά από το γραφικό στοιχείο Bot, με ένα γραφικό στοιχείο Κλήση HTTP ή Δέσμη ενεργειών:

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

Το Zoom δεν δημοσιεύει τεκμηρίωση σε επίπεδο πεδίων για αυτά τα γραφικά στοιχεία, επομένως επιβεβαιώστε στον λογαριασμό σας ότι το γραφικό στοιχείο μπορεί να στείλει κεφαλίδα Authorization. Δείτε Αναζητήστε μια μεταβιβασμένη κλήση.

Δοκιμάστε το

Καλέστε έναν αριθμό που φτάνει στο γραφικό στοιχείο Bot, ζητήστε από τον πράκτορα να σας συνδέσει με κάποιο άτομο και ελέγξτε ότι ο καλών φτάνει σε ανθρώπινο πράκτορα και ότι το γραφικό στοιχείο επιστρέφει τη μεταβίβαση. Στη συνέχεια, ανοίξτε την κλήση με GET /v1/calls/{call_id}: το sip_headers θα πρέπει να εμφανίζει το x-zoom-call-sid, και το external_call_id θα πρέπει να αντιστοιχεί στο SID κλήσης που χρησιμοποιεί η ροή σας.

Περιορισμοί

  • Το ThunderPhone δεν δημοσιεύει στο Στατικό URL του συνδέσμου, επομένως το Zoom λαμβάνει τη μεταβίβαση μέσω της αναζήτησης ή μέσω αντιστοιχισμένων κεφαλίδων, αν η δοκιμή σας δείξει ότι το Zoom τις διαβάζει από το REFER.
  • Η ζεύξη έχει δημιουργηθεί από την ομάδα ISV του Zoom, επομένως δεν μπορείτε να τη ρυθμίσετε ή να τη δοκιμάσετε μόνοι σας.