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

Contact centers

Σύνδεση από το Amazon Connect

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

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

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

  • Έναν πράκτορα ThunderPhone και ένα κλειδί API οργανισμού.
  • Τη σύνδεση Εξωτερική μεταφορά φωνής του Amazon Connect. Ζητήστε πρώτα την αύξηση του ορίου «Συνδέσεις εξωτερικής μεταφοράς φωνής ανά λογαριασμό»: το μενού παραμένει κρυφό μέχρι να το εγκρίνει η AWS. Η AWS χρεώνει κάθε σύνδεση ανά ημέρα ($100 την ημέρα από τις 21 Ιουλίου 2025) συν τη χρήση ανά λεπτό.

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

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

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 προέλευσης για τους κανόνες και τον κίνδυνο μιας διεύθυνσης που μοιράζονται όλοι οι πελάτες της πλατφόρμας. Διατηρήστε το 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 από τον πράκτορα. Επομένως, ο πράκτορας επιστρέφει την κλήση: αποχαιρετά και τερματίζει την κλήση και η ροή σας συνεχίζεται μετά το μπλοκ μεταφοράς. Προσθέστε αυτόν τον αριθμό μεταφοράς (δείτε Προσθήκη αριθμού μεταφοράς):

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

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

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. Τα πεδία απόκρισης βρίσκονται στην ενότητα Αναζήτηση παραδομένης κλήσης.

Δοκιμή

Καλέστε έναν αριθμό στην παρουσία 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 δευτερόλεπτα.