Open in
Σύνδεση από το Talkdesk
Προωθήστε κλήσεις Talkdesk σε έναν πράκτορα ThunderPhone με το Connect to Autopilot Voice και κλιμακώστε τες ξανά με το αναγνωριστικό μεταβίβασης στο UUI.
Η ροή σας στο Talkdesk Studio στέλνει τον καλούντα στον πράκτορα με το αναγνωριστικό αλληλεπίδρασης και το UUI. Όταν ο καλών χρειάζεται άνθρωπο, ο πράκτορας κλιμακώνει την κλήση με ένα SIP
REFER στο Talkdesk και το αναγνωριστικό μεταβίβασης καταλήγει σε μια μεταβλητή του Studio.
Πριν ξεκινήσετε
- Έναν πράκτορα ThunderPhone και ένα κλειδί API οργανισμού.
- Μια άδεια Talkdesk Ενορχηστρωτή συνομιλιών, η οποία καλύπτει το στοιχείο Σύνδεση με το Autopilot Voice του Studio στη λειτουργία Εξωτερική ροή φωνής (άρθρο του Talkdesk). Το Talkdesk τη χρεώνει ανά λεπτό όσο ο πράκτορας διατηρεί την κλήση.
1. Δημιουργήστε το τελικό σημείο SIP
Το Talkdesk τεκμηριώνει μόνο μια λίστα επιτρεπόμενων IP, επομένως δημιουργήστε ένα τελικό σημείο που δέχεται κλήσεις βάσει διεύθυνσης προέλευσης:
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": "Talkdesk",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
"srtp": "optional"
}'Το άρθρο του Talkdesk αναφέρει ότι στέλνει ήχο μέσω SRTP και το "srtp": "optional"
απαντά με SRTP όταν το Talkdesk το προσφέρει. Το άρθρο δεν αναφέρει αν το Talkdesk
απαιτεί SRTP· αν το Talkdesk σάς ενημερώσει ότι το απαιτεί, ορίστε το srtp σε required,
το οποίο απορρίπτει κλήσεις χωρίς αυτό.
Λάβετε τα εύρη σηματοδότησης SIP του Talkdesk από το Talkdesk. Κάθε εύρος πρέπει να
είναι δημόσιο εύρος IPv4 /16 ή στενότερο (IPv6 /48 ή στενότερο). Δείτε
Πλατφόρμες που πραγματοποιούν έλεγχο ταυτότητας βάσει IP προέλευσης.
Το Talkdesk στέλνει SIP από το δίκτυο του Twilio, του οποίου τις διευθύνσεις μοιράζονται
όλοι οι πελάτες του Twilio, επομένως η διεύθυνση του τελικού σημείου είναι αυτή που
εμποδίζει άλλους καλούντες να συνδεθούν: μην τη δημοσιεύσετε.
Διατηρήστε το sip_uri της απόκρισης, για παράδειγμα
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Στείλτε κλήσεις με περιβάλλον
Στη ροή Studio, προσθέστε το Σύνδεση με το Autopilot Voice στη λειτουργία Εξωτερική ροή
φωνής και ορίστε ως προορισμό το sip_uri του τελικού σημείου με το ;transport=tls προστιθέμενο, για
παράδειγμα sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Το
τελικό σημείο απορρίπτει κλήσεις μέσω UDP, το οποίο χρησιμοποιεί το SIP του Twilio εκτός αν οριστεί διαφορετικά.
Το Talkdesk στέλνει:
X-Talkdesk-Interaction-Id, αποθηκευμένο ωςexternal_call_idτης κλήσης·User-to-User, κωδικοποιημένο σε δεκαεξαδική μορφή, όπωςbusiness_hours=open. Φτάνει στο prompt αποκωδικοποιημένο, ως{{sip_uui}}.
Η έκδοση 2.1 του στοιχείου μπορεί επίσης να στείλει Ορισμένες κεφαλίδες. Η σελίδα προτιμήσεων του Talkdesk τις περιγράφει ως JSON που στέλνεται μέσω WebSocket, επομένως επιβεβαιώστε με το Talkdesk αν φτάνουν ως κεφαλίδες SIP πριν βασιστείτε σε αυτές.
3. Λάβετε ξανά την κλήση
Ο πράκτορας κλιμακώνει την κλήση με REFER στη διεύθυνση κλιμάκωσης του Talkdesk,
με το αναγνωριστικό μεταβίβασης ως δεκαεξαδικό UUI μέσα σε αυτή τη διεύθυνση,
το μοναδικό σημείο όπου το διαβάζει το Talkdesk. Προσθέστε αυτόν τον αριθμό
μεταφοράς (δείτε
Προσθήκη του αριθμού μεταφοράς
και Κεφαλίδες μέσα στη διεύθυνση μεταφοράς):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Η διεύθυνση είναι αυτή που αναφέρεται στο άρθρο του Talkdesk. Η έκδοση 2.1 του
στοιχείου διαβάζει autopilot_result=· η έκδοση 1.7 διαβάζει escalate_to=,
επομένως χρησιμοποιήστε αυτό το κλειδί στην έκδοση 1.7. Το REFER έχει την
εξής μορφή:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Το Talkdesk τοποθετεί την τιμή σε μια μεταβλητή Studio. Για να λάβετε τη σύνοψη και την πρόθεση, προσθέστε ένα βήμα Εκτέλεση ενέργειας σε μια προσαρμοσμένη ενσωμάτωση που έχει δημιουργηθεί με το Connections:
- Τύπος ελέγχου ταυτότητας Κλειδί API, όνομα κεφαλίδας
Authorization, τιμήBearer sk_live_…. - Αίτημα:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=ακολουθούμενο από το αναγνωριστικό της μεταβλητής. Μπορείτε επίσης να αναζητήσετε την κλήση μεexternal_call_idχρησιμοποιώντας το αναγνωριστικό αλληλεπίδρασης. - Δρομολογήστε βάσει του
handoff.intentκαι εμφανίστε τοhandoff.summaryστο άτομο που αναλαμβάνει την κλήση.
Δείτε Αναζήτηση μεταβιβασμένης κλήσης.
Δοκιμή
Ξεκινήστε μια κλήση μέσω της ροής Studio, ζητήστε από τον πράκτορα ένα άτομο και
ελέγξτε ότι η ροή συνεχίζει μετά το στοιχείο με το αναγνωριστικό μεταβίβασης στη
μεταβλητή του. Έπειτα ανοίξτε την κλήση με GET /v1/calls/{call_id}:
το external_call_id πρέπει να είναι το αναγνωριστικό αλληλεπίδρασης του Talkdesk.
Περιορισμοί
- Το Talkdesk διαβάζει έως 256 byte UUI και δεν επιτρέπει τιμές που διαχωρίζονται
με
|ή;, επομένως στείλτε μία μόνο τιμή. Το αναγνωριστικό μεταβίβασης χωράει. - Τα API του Talkdesk δεν μπορούν να διαβάσουν την απομαγνητοφώνηση του
πράκτορα. Χρησιμοποιήστε αντί γι’ αυτό την αναζήτηση μεταβιβασμένης κλήσης ή
το
GET /v1/calls/{call_id}.