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

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

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

- Έναν πράκτορα ThunderPhone και ένα [κλειδί API](/el/guides/api-keys) οργανισμού.
- Το πρόσθετο **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 ως αριθμό εισερχόμενης κλήσης (δείτε
[Πλατφόρμες που καλούν έναν αριθμό τηλεφώνου](/el/guides/sip-addresses)):

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

```json
{
  "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 σας. Δείτε
[Αναζήτηση κλήσης που παραδόθηκε](/api-reference/calls#look-up-a-handed-off-call).

## Δοκιμάστε το

Καλέστε το σενάριο 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 συνιστά να διατηρείτε τις προσαρμοσμένες κεφαλίδες σε περίπου δέκα, ώστε να αποφεύγεται
  ο κατακερματισμός πακέτων.
