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

Contact centers

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