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

Contact centers

Σύνδεση από το Five9

Στείλτε κλήσεις Five9 σε έναν πράκτορα ThunderPhone μέσω SIP με το AI Agent Connect και λάβετε τες πίσω με κεφαλίδες δρομολόγησης που διαβάζει το σενάριο IVR σας.

Το σενάριο Five9 IVR στέλνει τον καλούντα στον πράκτορα μαζί με τα στοιχεία κλήσης του Five9. Όταν ο πράκτορας ολοκληρώσει, τερματίζει την κλήση με κεφαλίδες δρομολόγησης στο SIP BYE, τις οποίες το σενάριο διαβάζει σε μεταβλητές κλήσης για να δρομολογήσει τον καλούντα.

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

  • Έναν πράκτορα ThunderPhone και ένα κλειδί API οργανισμού.
  • Το πρόσθετο AI Agent Connect του Five9. Το Five9 το περιορίζει σε παρόχους AI που έχει διαπιστεύσει και η ομάδα υλοποίησης του Five9 το ρυθμίζει: εισάγει το πρότυπο σεναρίου IVR του παρόχου, δημιουργεί τις μεταβλητές κλήσης και κατευθύνει τη μονάδα Third Party Transfer του σεναρίου στον πάροχο. Το ThunderPhone δεν βρίσκεται ακόμη στη λίστα διαπιστευμένων του Five9: ρωτήστε την ομάδα λογαριασμού σας στο Five9 ή την υποστήριξη του ThunderPhone πριν βασίσετε τον σχεδιασμό σας σε αυτό.

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

Η μονάδα Third Party Transfer του Five9 καλεί έναν αριθμό τηλεφώνου, όχι μια διεύθυνση SIP, και οι ενσωματώσεις Five9 άλλων παρόχων ελέγχουν την ταυτότητα του Five9 βάσει της διεύθυνσης προέλευσης αντί για κωδικό πρόσβασης. Επομένως, δημιουργήστε ένα τελικό σημείο ip_allowlist με τον αριθμό που θα καλεί το Five9 ως αριθμό εισερχόμενης κλήσης (δείτε Πλατφόρμες που καλούν έναν αριθμό τηλεφώνου):

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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
  • allowed_source_cidrs: τα εύρη σηματοδότησης SIP των κέντρων δεδομένων Five9 σας, από το Five9. Κάθε ένα πρέπει να είναι δημόσιο εύρος IPv4 /16 ή στενότερο (IPv6 /48 ή στενότερο).
  • dial_in_numbers: ο αριθμός που θα καλεί το σενάριο Five9, γραμμένος με τον τρόπο που τον στέλνει το Five9. Δεν χρειάζεται να είναι πραγματικός αριθμός τηλεφώνου. Δεν μπορεί ήδη να χρησιμοποιείται στο ThunderPhone, ως αριθμός τηλεφώνου ή σε άλλο τελικό σημείο: αυτό επιστρέφει 409.

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

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

Ζητήστε από την ομάδα υλοποίησης του Five9 να:

  • Στείλει την κλήση από τη μονάδα Third Party Transfer στο sip:+14155550188@sip.thunderphone.com, με τον αριθμό τόσο στο URI αιτήματος όσο και στην κεφαλίδα To. Η μονάδα λαμβάνει τον αριθμό, με τον τομέα SIP του παρόχου σε μια κεφαλίδα.
  • Τη στείλει μέσω TLS (θύρα 5061) ή TCP (θύρα 5060). Το τελικό σημείο απορρίπτει UDP και το Five9 δεν δημοσιεύει ποια μεταφορά χρησιμοποιεί, επομένως βεβαιωθείτε ότι δεν είναι UDP.
  • Ενεργοποιήσει το Return After 3rd Party Call, ώστε το σενάριο να συνεχίσει όταν ο πράκτορας τερματίσει την κλήση (το Five9 επιτρέπει έως 3.600 δευτερόλεπτα για την κλήση τρίτου μέρους).

Ο οδηγός του Five9 παραθέτει τις τιμές που στέλνει (call.ANI, call.DNIS, call.call_id, call.session_id, call.campaign_name και άλλες), όχι τα ονόματα των κεφαλίδων τους. Οι ενσωματώσεις Five9 άλλων παρόχων AI τις τεκμηριώνουν στη μετάδοση ως X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign και X-AgentID; ελέγξτε τις στην πρώτη δοκιμαστική κλήση σας. Καθεμία φτάνει στην προτροπή ως μεταβλητή, όπως {{sip_x_callcampaign}}. Το X-CallID αποθηκεύεται ως το external_call_id της κλήσης.

3. Λάβετε την κλήση πίσω

Ο φωνητικός πράκτορας επιστρέφει την κλήση: αποχαιρετά και τερματίζει την κλήση, ενώ το BYE μεταφέρει τις τέσσερις κεφαλίδες που διαβάζει το σενάριο του Five9. Προσθέστε αυτόν τον αριθμό μεταφοράς (δείτε Προσθήκη του αριθμού μεταφοράς):

{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
  • Τα X-RouteType και X-RouteValue υποδεικνύουν στο σενάριο πού να στείλει τον καλούντα, εδώ στη δεξιότητα Support. Τιμές που τεκμηριώνουν άλλοι πάροχοι για το X-RouteType περιλαμβάνουν τις SkillTransfer, PhoneTransfer, Hangup και DispositionOnly; συμφωνήστε τις τιμές με όποιον συντηρεί το σενάριο. Για πολλούς προορισμούς, προσθέστε μία επιστροφή ανά προορισμό με διαφορετικό όνομα και X-RouteValue.
  • Το X-RouteReason μεταφέρει την ετικέτα πρόθεσης του πράκτορα, όπως billing_dispute.
  • Το X-CustomMetaData μεταφέρει το αναγνωριστικό παράδοσης. Το BYE το μεταφέρει επίσης ως X-TP-Handoff-Id, το οποίο δεν διαβάζει το Five9.

Το σενάριο του Five9 αντιστοιχίζει τις τέσσερις κεφαλίδες σε μεταβλητές κλήσης. Για τη σύνοψη του πράκτορα, ζητήστε από το σενάριο να καλέσει την αναζήτηση παράδοσης με μια μονάδα IVR Ερώτημα: GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ακολουθούμενο από call.call_id, με ένα Προφίλ εξουσιοδότησης που στέλνει Authorization: Bearer και το κλειδί API σας. Δείτε Αναζήτηση κλήσης που παραδόθηκε.

Δοκιμάστε το

Καλέστε το σενάριο IVR, ζητήστε από τον πράκτορα ένα άτομο και ελέγξτε ότι το σενάριο δρομολογεί τον καλούντα με συμπληρωμένες τις μεταβλητές κλήσης. Αν η κλήση δεν φτάνει ποτέ στον πράκτορα, ελέγξτε ότι ο αριθμός στο URI αιτήματος και στην κεφαλίδα To αντιστοιχεί στον αριθμό εισερχόμενης κλήσης, ότι η διεύθυνση προέλευσης του Five9 βρίσκεται στο allowed_source_cidrs και ότι η κλήση πραγματοποιήθηκε μέσω TCP ή TLS. Στη συνέχεια, ανοίξτε την κλήση με GET /v1/calls/{call_id}: το sip_headers θα πρέπει να παραθέτει το x-callid και το external_call_id θα πρέπει να αντιστοιχεί στο call.call_id στο Five9.

Περιορισμοί

  • Ο οδηγός του Five9 τεκμηριώνει δεδομένα δρομολόγησης στο BYE και δεν αναφέρει αποδοχή ενός REFER, επομένως η επιστροφή γίνεται ως ψυχρή μεταφορά από το σενάριο.
  • Το Five9 διαβάζει τα X-RouteType, X-RouteValue, X-RouteReason και X-CustomMetaData, όχι το User-to-User. Το ThunderPhone στέλνει κάθε τιμή κεφαλίδας με μήκος έως 256 byte.
  • Το Five9 συνιστά να διατηρείτε τις προσαρμοσμένες κεφαλίδες σε περίπου δέκα, ώστε να αποφεύγεται ο κατακερματισμός πακέτων.