---
title: "Σύνδεση από το Amazon Connect"
description: "Στείλτε κλήσεις του Amazon Connect σε έναν πράκτορα ThunderPhone μέσω SIP με το αναγνωριστικό επαφής και το UUI και συνεχίστε τη ροή σας με την προώθηση του πράκτορα."
---

Η ροή Amazon Connect στέλνει τον καλούντα στον πράκτορα με το αναγνωριστικό επαφής και οποιοδήποτε UUI ορίσετε. Όταν ο πράκτορας ολοκληρώσει, τερματίζει την κλήση, η ροή σας συνεχίζεται και μια Lambda ανακτά τη μεταβίβαση με βάση το αναγνωριστικό επαφής.

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

- Έναν πράκτορα ThunderPhone και ένα [κλειδί API](/el/guides/api-keys) οργανισμού.
- Τη σύνδεση **Εξωτερική μεταφορά φωνής** του Amazon Connect. Ζητήστε πρώτα την αύξηση του ορίου «Συνδέσεις εξωτερικής μεταφοράς φωνής ανά λογαριασμό»: το μενού παραμένει κρυφό μέχρι να το εγκρίνει η AWS. Η AWS χρεώνει κάθε σύνδεση ανά ημέρα
  ([$100 την ημέρα από τις 21 Ιουλίου 2025](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  συν τη χρήση ανά λεπτό.

<Warning>
  Ο τρέχων οδηγός διαχειριστή της AWS δεν περιλαμβάνει πλέον σελίδες για την εξωτερική μεταφορά φωνής.
  Πριν βασιστείτε σε αυτήν, επιβεβαιώστε με την AWS ότι η σύνδεση είναι διαθέσιμη για την παρουσία και την Περιοχή σας.
</Warning>

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

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

```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": "Amazon Connect",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["CONNECT_SIGNALLING_RANGE_1", "CONNECT_SIGNALLING_RANGE_2"]
  }'
```

Λάβετε από την AWS τα εύρη σηματοδότησης SIP της σύνδεσης για την Περιοχή σας. Κάθε εύρος πρέπει να
είναι δημόσιο εύρος IPv4 `/16` ή στενότερο (IPv6 `/48` ή στενότερο). Δείτε τις
[Πλατφόρμες που πραγματοποιούν έλεγχο ταυτότητας βάσει IP προέλευσης](/el/guides/sip-addresses)
για τους κανόνες και τον κίνδυνο μιας διεύθυνσης που μοιράζονται όλοι οι πελάτες της
πλατφόρμας. Διατηρήστε το `sip_uri` της απόκρισης, για παράδειγμα
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Στείλτε κλήσεις με περιεχόμενο

1. Στην κονσόλα Amazon Connect, ανοίξτε **Εξωτερικά φωνητικά συστήματα → Ενσωματώσεις
   μεταφοράς φωνής** και επιλέξτε **Δημιουργία**.
2. Επιλέξτε τον τύπο προορισμού (ένα SBC) και προσθέστε μια εξερχόμενη διαδρομή με κεντρικό υπολογιστή
   `sip.thunderphone.com`, θύρα `5061` και πρωτόκολλο TLS. Το τελικό σημείο απαιτεί
   TLS ή TCP (θύρα `5060`) και απορρίπτει UDP. Η AWS δεν τεκμηριώνει ποια
   πρωτόκολλα προσφέρει η σύνδεση, επομένως επιβεβαιώστε με την AWS ότι μπορεί να χρησιμοποιήσει ένα από
   αυτά.
3. Στη ροή σας, προσθέστε ένα μπλοκ **Μεταφορά σε αριθμό τηλεφώνου** με το **Μεταφορά σε**
   ορισμένο σε **Εξωτερικό φωνητικό σύστημα** και ορίστε:
   - **ARN προορισμού:** τη σύνδεση.
   - **Προς χρήστη:** το τμήμα χρήστη του `sip_uri` του τελικού σημείου, όπως
     `agent-12-jhxmginwjx`.
   - **UUI** (προαιρετικό): περιεχόμενο για τον πράκτορα. Το Connect το στέλνει κωδικοποιημένο σε δεκαεξαδική μορφή.
   - **Συνέχιση ροής μετά την αποσύνδεση:** Ναι, ώστε η ροή να συνεχίζεται όταν ο
     πράκτορας τερματίζει την κλήση.

Το Connect στέλνει το αναγνωριστικό επαφής στο `X-Amzn-ConnectContactId`. Το ThunderPhone το αποθηκεύει
ως `external_call_id` της κλήσης, με το οποίο η ροή σας βρίσκει την κλήση
αργότερα. Το UUI φτάνει στο prompt ως `{{sip_uui}}`. Οι ενσωματώσεις τρίτων
τεκμηριώνουν την κεφαλίδα αναγνωριστικού επαφής· η τεκμηρίωση της AWS δεν το κάνει, επομένως ελέγξτε την στην πρώτη
δοκιμαστική κλήση σας.

## 3. Λήψη της κλήσης πίσω

Η AWS δεν τεκμηριώνει τρόπο ώστε το Connect να διαβάζει κεφαλίδες στο `BYE` ή να δέχεται `REFER` από τον πράκτορα. Επομένως, ο πράκτορας επιστρέφει την κλήση: αποχαιρετά και τερματίζει την κλήση και η ροή σας συνεχίζεται μετά το μπλοκ μεταφοράς. Προσθέστε αυτόν τον αριθμό μεταφοράς (δείτε [Προσθήκη αριθμού μεταφοράς](/el/guides/contact-centers/overview)):

```json
{"name": "Amazon Connect", "action": "return"}
```

Στη συνέχεια, ανακτήστε την παράδοση με ένα μπλοκ **Επίκληση συνάρτησης AWS Lambda** μετά τη μεταφορά. Η Lambda αναζητά την κλήση βάσει του αναγνωριστικού επαφής:

```python
import json
import os
import urllib.error
import urllib.parse
import urllib.request


def lambda_handler(event, context):
    contact_id = event["Details"]["ContactData"]["ContactId"]
    url = "https://api.thunderphone.com/v1/calls/handoff?" + urllib.parse.urlencode(
        {"external_call_id": contact_id}
    )
    request = urllib.request.Request(
        url, headers={"Authorization": "Bearer " + os.environ["THUNDERPHONE_API_KEY"]}
    )
    try:
        with urllib.request.urlopen(request, timeout=5) as response:
            call = json.load(response)
    except (urllib.error.URLError, TimeoutError):
        return {"found": "false"}
    handoff = call.get("handoff") or {}
    return {
        "found": "true",
        "intent": handoff.get("intent") or "",
        "summary": handoff.get("summary") or "",
    }
```

Το μπλοκ επιστρέφει έναν επίπεδο χάρτη, ώστε η ροή να μπορεί να διακλαδίζεται βάσει του `intent` ή να ορίζει το `summary` ως χαρακτηριστικό επαφής για το άτομο που αναλαμβάνει την κλήση. Εκτελέστε το μπλοκ συγχρονισμένα (έως 8 δευτερόλεπτα) και αποθηκεύστε το κλειδί API κρυπτογραφημένο, για παράδειγμα στο AWS Secrets Manager. Τα πεδία απόκρισης βρίσκονται στην ενότητα [Αναζήτηση παραδομένης κλήσης](/api-reference/calls#look-up-a-handed-off-call).

## Δοκιμή

Καλέστε έναν αριθμό στην παρουσία Connect που φτάνει στο μπλοκ μεταφοράς, ζητήστε από τον πράκτορα να μιλήσετε με ένα άτομο και ελέγξτε ότι η ροή συνεχίζεται. Στη συνέχεια, ανοίξτε την κλήση με `GET /v1/calls/{call_id}`: το `sip_headers` πρέπει να εμφανίζει το `x-amzn-connectcontactid` και το `external_call_id` πρέπει να ισούται με το `ContactId` που λαμβάνει η Lambda σας. Αν η μεταφορά αποτύχει με SIP `404`, το ThunderPhone δεν βρήκε το τμήμα χρήστη του τελικού σημείου: πρέπει να υπάρχει τόσο στο URI του αιτήματος όσο και στην κεφαλίδα `To`.

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

- Η AWS δεν τεκμηριώνει τρόπο ανάγνωσης κεφαλίδων στο `BYE`, συμπεριλαμβανομένου του `X-TP-Handoff-Id`, επομένως το αναγνωριστικό επαφής είναι ο μόνος σύνδεσμος πίσω στην κλήση.
- Η AWS δεν τεκμηριώνει μέγιστο μήκος UUI για τον συνδετήρα.
- Ένα συγχρονισμένο μπλοκ Lambda λήγει μετά από 8 δευτερόλεπτα.
