---
title: "Prisijunkite iš Amazon Connect"
description: "Per SIP siųskite Amazon Connect skambučius ThunderPhone agentui su kontakto ID ir UUI, o perdavus pokalbį agentui tęskite savo srautą."
---

Jūsų Amazon Connect srautas siunčia skambinantį asmenį agentui su kontakto ID ir
bet kokiu jūsų nustatytu UUI. Kai agentas baigia skambutį, jūsų srautas tęsiamas, o
Lambda pagal kontakto ID gauna perdavimo informaciją.

## Prieš pradėdami

- ThunderPhone agentas ir organizacijos [API raktas](/lt/guides/api-keys).
- Amazon Connect **Išorinio balso perdavimo** jungtis. Pirmiausia paprašykite
  padidinti kvotą „Išorinio balso perdavimo jungtys vienai paskyrai“: meniu
  lieka paslėptas, kol AWS ją patvirtina. AWS už kiekvieną jungtį taiko dienos
  mokestį ([$100 per dieną nuo 2025 m. liepos 21 d.](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  ir papildomą mokestį už minutes.

<Warning>
  Dabartiniame AWS administratoriaus vadove nebėra puslapių apie išorinį balso
  perdavimą. Prieš diegdami šį sprendimą, patvirtinkite su AWS, kad jungtis
  pasiekiama jūsų egzemplioriui ir regionui.
</Warning>

## 1. Sukurkite SIP galinį tašką

Jungties dokumentacijoje neaprašytas SIP santraukos autentifikavimas, todėl
sukurkite galinį tašką, priimantį skambučius pagal šaltinio adresą:

```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"]
  }'
```

Gaukite savo regiono jungties SIP signalizavimo diapazonus iš AWS. Kiekvienas jų
turi būti viešasis IPv4 diapazonas `/16` arba siauresnis (IPv6 `/48` arba
siauresnis). Informaciją apie taisykles ir visų platformos klientų bendrinamo
adreso riziką rasite skiltyje
[Platformos, kurios autentifikuoja pagal šaltinio IP](/lt/guides/sip-addresses).
Išsaugokite atsakyme pateiktą `sip_uri`, pavyzdžiui,
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Siųskite skambučius su kontekstu

1. Amazon Connect konsolėje atidarykite **Išorinės balso sistemos → Balso
   perdavimo integracijos** ir pasirinkite **Sukurti**.
2. Pasirinkite paskirties tipą (SBC) ir pridėkite išeinantį maršrutą su
   pagrindinio kompiuterio vardu `sip.thunderphone.com`, prievadu `5061` ir
   TLS protokolu. Galiniam taškui reikia TLS arba TCP (prievadas `5060`), jis
   nepriima UDP. AWS dokumentacijoje nenurodyta, kuriuos protokolus siūlo
   jungtis, todėl patvirtinkite su AWS, kad ji gali naudoti vieną iš jų.
3. Savo sraute pridėkite bloką **Perkelti į telefono numerį**, kuriame
   **Perkelti į** nustatyta kaip **Išorinė balso sistema**, ir nustatykite:
   - **Paskirties ARN:** jungtis.
   - **Naudotojui:** galinio taško `sip_uri` naudotojo dalis, pvz.,
     `agent-12-jhxmginwjx`.
   - **UUI** (nebūtina): kontekstas agentui. Connect jį siunčia užkoduotą
     šešioliktainiu formatu.
   - **Tęsti srautą atsijungus:** Taip, kad srautas būtų tęsiamas, kai
     agentas baigia skambutį.

Connect siunčia kontakto ID antraštėje `X-Amzn-ConnectContactId`. ThunderPhone
jį išsaugo kaip skambučio `external_call_id`, pagal kurį jūsų srautas vėliau
randa skambutį. UUI pasiekia raginimą kaip `{{sip_uui}}`. Trečiųjų šalių
integracijų dokumentacijoje aprašoma kontakto ID antraštė, tačiau AWS
dokumentacijoje jos nėra, todėl patikrinkite ją pirmojo bandomojo skambučio metu.

## 3. Grąžinkite skambutį

AWS dokumentacijoje nenurodytas būdas, kaip Connect galėtų nuskaityti `BYE`
antraštes arba priimti agento siunčiamą `REFER`. Todėl agentas grąžina skambutį:
atsisveikina ir padeda ragelį, o jūsų srautas tęsiamas po perdavimo bloko.
Pridėkite šį perdavimo numerį (žr. [Pridėkite perdavimo numerį](/lt/guides/contact-centers/overview)):

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

Tada po perdavimo gaukite perdavimo duomenis naudodami **Iškviesti AWS Lambda funkciją**
bloką. Lambda ieško skambučio pagal kontakto ID:

```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 "",
    }
```

Blokas grąžina vieno lygio reikšmių žemėlapį, todėl srautas gali išsišakoti pagal
`intent` arba nustatyti `summary` kaip kontakto atributą skambutį perimančiam
asmeniui. Vykdykite bloką sinchroniškai (iki 8 sekundžių) ir saugokite API raktą
užšifruotą, pavyzdžiui, AWS Secrets Manager. Atsakymo laukai aprašyti
[Peržiūrėkite perduotą skambutį](/api-reference/calls#look-up-a-handed-off-call).

## Išbandykite

Paskambinkite į savo Connect egzemplioriaus numerį, kurio skambučiai pasiekia
perdavimo bloką, paprašykite agento sujungti su asmeniu ir patikrinkite, ar
srautas tęsiamas. Tada atidarykite skambutį naudodami
`GET /v1/calls/{call_id}`: `sip_headers` turėtų būti nurodyta
`x-amzn-connectcontactid`, o `external_call_id` turėtų sutapti su `ContactId`,
kurį gauna jūsų Lambda. Jei perdavimas nepavyksta ir gaunamas SIP `404`,
ThunderPhone nerado galinio taško naudotojo dalies: ji turi būti ir užklausos
URI, ir `To` antraštėje.

## Apribojimai

- AWS dokumentacijoje nenurodytas būdas nuskaityti `BYE` antraštes, įskaitant
  `X-TP-Handoff-Id`, todėl kontakto ID yra vienintelė nuoroda atgal į skambutį.
- AWS dokumentacijoje nenurodytas didžiausias jungties UUI ilgis.
- Sinchroninis Lambda blokas baigia skirtą laiką po 8 sekundžių.
