---
title: "Σύνδεση από το Talkdesk"
description: "Προωθήστε κλήσεις Talkdesk σε έναν πράκτορα ThunderPhone με το Connect to Autopilot Voice και κλιμακώστε τες ξανά με το αναγνωριστικό μεταβίβασης στο UUI."
---

Η ροή σας στο Talkdesk Studio στέλνει τον καλούντα στον πράκτορα με το αναγνωριστικό αλληλεπίδρασης και το UUI. Όταν ο καλών χρειάζεται άνθρωπο, ο πράκτορας κλιμακώνει την κλήση με ένα SIP
`REFER` στο Talkdesk και το αναγνωριστικό μεταβίβασης καταλήγει σε μια μεταβλητή του Studio.

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

- Έναν πράκτορα ThunderPhone και ένα [κλειδί API](/el/guides/api-keys) οργανισμού.
- Μια άδεια Talkdesk **Ενορχηστρωτή συνομιλιών**, η οποία καλύπτει το στοιχείο
  **Σύνδεση με το Autopilot Voice** του Studio στη λειτουργία **Εξωτερική ροή
  φωνής** ([άρθρο του Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Το Talkdesk τη χρεώνει ανά λεπτό όσο ο πράκτορας διατηρεί την κλήση.

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

Το Talkdesk τεκμηριώνει μόνο μια λίστα επιτρεπόμενων IP, επομένως δημιουργήστε
ένα τελικό σημείο που δέχεται κλήσεις βάσει διεύθυνσης προέλευσης:

```bash
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 προέλευσης](/el/guides/sip-addresses).
Το 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. Προσθέστε αυτόν τον αριθμό
μεταφοράς (δείτε
[Προσθήκη του αριθμού μεταφοράς](/el/guides/contact-centers/overview)
και [Κεφαλίδες μέσα στη διεύθυνση μεταφοράς](/el/guides/call-transfers)):

```json
{
  "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` στο
  άτομο που αναλαμβάνει την κλήση.

Δείτε [Αναζήτηση μεταβιβασμένης κλήσης](/api-reference/calls#look-up-a-handed-off-call).

## Δοκιμή

Ξεκινήστε μια κλήση μέσω της ροής Studio, ζητήστε από τον πράκτορα ένα άτομο και
ελέγξτε ότι η ροή συνεχίζει μετά το στοιχείο με το αναγνωριστικό μεταβίβασης στη
μεταβλητή του. Έπειτα ανοίξτε την κλήση με `GET /v1/calls/{call_id}`:
το `external_call_id` πρέπει να είναι το αναγνωριστικό αλληλεπίδρασης του Talkdesk.

## Περιορισμοί

- Το Talkdesk διαβάζει έως 256 byte UUI και δεν επιτρέπει τιμές που διαχωρίζονται
  με `|` ή `;`, επομένως στείλτε μία μόνο τιμή. Το αναγνωριστικό μεταβίβασης
  χωράει.
- Τα API του Talkdesk δεν μπορούν να διαβάσουν την απομαγνητοφώνηση του
  πράκτορα. Χρησιμοποιήστε αντί γι’ αυτό την αναζήτηση μεταβιβασμένης κλήσης ή
  το `GET /v1/calls/{call_id}`.
