---
title: "Povežite se iz Amazon Connecta"
description: "Klice iz Amazon Connecta usmerite h glasovnemu agentu ThunderPhone prek SIP-a z ID-jem stika in UUI ter nadaljujte svoj potek z agentovim predajanjem."
---

Vaš tok Amazon Connect usmeri klicatelja k agentu z ID-jem stika in
nastavljenimi podatki UUI. Ko agent konča, prekine klic, vaš tok se nadaljuje,
Lambda pa pridobi predajo po ID-ju stika.

## Preden začnete

- Agent ThunderPhone in [ključ API organizacije](/sl/guides/api-keys).
- Priključek Amazon Connect **Zunanji prenos glasu**. Najprej zahtevajte
  povečanje kvote »Priključki za zunanji prenos glasu na račun«: meni ostane
  skrit, dokler ga AWS ne odobri. AWS vsak priključek zaračunava na dan
  ([$100 na dan od 21. julija 2025](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  ter uporabo na minuto.

<Warning>
  Trenutni skrbniški vodnik AWS ne vsebuje več strani o zunanjem prenosu glasu.
  Preden ga začnete uporabljati, pri AWS potrdite, da je priključek na voljo za
  vaš primerek in regijo.
</Warning>

## 1. Ustvarite končno točko SIP

Priključek ne dokumentira preverjanja pristnosti SIP digest, zato ustvarite
končno točko, ki sprejema klice z izvornega naslova:

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

Obsege signalizacije SIP priključka za svojo regijo pridobite pri AWS. Vsak mora
biti javni obseg IPv4 velikosti `/16` ali ožji (IPv6 `/48` ali ožji). Oglejte si
[Platforme, ki preverjajo pristnost po izvornem IP-ju](/sl/guides/sip-addresses)
za pravila in tveganje naslova, ki si ga delijo vse stranke platforme. Shranite
`sip_uri` iz odgovora, na primer
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Pošljite klice s kontekstom

1. V konzoli Amazon Connect odprite **Zunanji glasovni sistemi → Integracije
   prenosa glasu** in izberite **Ustvarite**.
2. Izberite vrsto cilja (SBC) in dodajte odhodno pot z gostiteljem
   `sip.thunderphone.com`, vrati `5061` in protokolom TLS. Končna točka zahteva
   TLS ali TCP (vrata `5060`) in zavrača UDP. AWS ne dokumentira, katere
   protokole priključek ponuja, zato pri AWS potrdite, da lahko uporablja enega
   od njih.
3. V svojem toku dodajte blok **Prenos na telefonsko številko**, pri čemer
   nastavite **Prenos na** na **Zunanji glasovni sistem**, nato pa nastavite:
   - **ARN cilja:** priključek.
   - **Uporabniku:** uporabniški del `sip_uri` končne točke, na primer
     `agent-12-jhxmginwjx`.
   - **UUI** (izbirno): kontekst za agenta. Connect ga pošlje šestnajstiško kodiranega.
   - **Nadaljujte tok po prekinitvi:** Da, da se tok nadaljuje, ko agent
     prekine klic.

Connect pošlje ID stika v `X-Amzn-ConnectContactId`. ThunderPhone ga shrani kot
`external_call_id` klica, s čimer vaš tok pozneje najde klic. UUI doseže poziv
kot `{{sip_uui}}`. Integracije tretjih oseb dokumentirajo glavo ID-ja stika;
dokumentacija AWS je ne, zato jo preverite pri prvem testnem klicu.

## 3. Pridobite klic nazaj

AWS ne dokumentira načina, kako bi Connect prebral glave v `BYE` ali sprejel
`REFER` od agenta. Zato agent vrne klic: poslovi se in prekine klic, vaš potek pa se nadaljuje po bloku prenosa. Dodajte to številko za prenos (glejte [Dodajte številko za prenos](/sl/guides/contact-centers/overview)):

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

Nato po prenosu pridobite predajo z blokom **Prikličite funkcijo AWS Lambda**. Lambda poišče klic po ID-ju stika:

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

Blok vrne ploski zemljevid, zato lahko potek razveji glede na `intent` ali nastavi
`summary` kot atribut stika za osebo, ki prevzame klic. Blok zaženite
sinhrono (do 8 sekund) in ključ API shranite šifrirano, na primer v AWS Secrets Manager. Polja odgovora so opisana v
[Iskanje predanega klica](/api-reference/calls#look-up-a-handed-off-call).

## Preizkusite

Pokličite številko v svoji instanci Connect, ki doseže blok prenosa, agenta
prosite za osebo in preverite, ali se potek nadaljuje. Nato odprite klic z
`GET /v1/calls/{call_id}`: `sip_headers` mora navajati
`x-amzn-connectcontactid`, `external_call_id` pa mora biti enak `ContactId`,
ki ga prejme vaša Lambda. Če prenos ne uspe s SIP `404`, ThunderPhone ni našel
uporabniškega dela končne točke: biti mora tako v URI-ju zahteve kot v glavi
`To`.

## Omejitve

- AWS ne dokumentira načina za branje glav v `BYE`, vključno z
  `X-TP-Handoff-Id`, zato je ID stika edina povezava nazaj do klica.
- AWS ne dokumentira največje dolžine UUI za priključek.
- Sinhroni blok Lambda poteče po 8 sekundah.
