---
title: "Povežite se iz Amazon Connecta"
description: "Šaljite pozive iz Amazon Connecta glasovnom agentu ThunderPhonea putem SIP-a s ID-jem kontakta i UUI-jem te nastavite tijek rada s predajom agenta."
---

Vaš Amazon Connect tijek šalje pozivatelja agentu s ID-jem kontakta i
svim UUI podacima koje postavite. Kada agent završi, prekida poziv, vaš se tijek nastavlja, a
Lambda dohvaća primopredaju prema ID-ju kontakta.

## Prije početka

- ThunderPhone agent i organizacijski [API ključ](/hr/guides/api-keys).
- Konektor Amazon Connecta **Prijenos vanjskog glasa**. Najprije zatražite
  povećanje kvote „Konektori za prijenos vanjskog glasa po računu”: izbornik ostaje skriven
  dok ga AWS ne odobri. AWS svaki konektor naplaćuje po danu
  ([$100 dnevno od 21. srpnja 2025.](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  uz korištenje po minuti.

<Warning>
  Trenutačni AWS-ov administrativni vodič više nema stranice za prijenos vanjskog glasa.
  Prije nego što ga počnete koristiti, potvrdite s AWS-om da je konektor dostupan za
  vašu instancu i regiju.
</Warning>

## 1. Izradite SIP krajnju točku

Konektor ne dokumentira SIP digest autentikaciju, stoga izradite
krajnju točku koja prihvaća pozive prema izvornoj adresi:

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

Od AWS-a pribavite SIP signalizacijske raspone konektora za svoju regiju. Svaki mora biti
javni IPv4 raspon `/16` ili uži (IPv6 `/48` ili uži). Pogledajte
[Platforme koje se autentikiraju prema izvornoj IP adresi](/hr/guides/sip-addresses)
za pravila i rizik adrese koju dijele svi korisnici
platforme. Sačuvajte `sip_uri` iz odgovora, na primjer
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Šaljite pozive s kontekstom

1. U konzoli Amazon Connect otvorite **Vanjski glasovni sustavi → Integracije
   prijenosa glasa** i odaberite **Izradite**.
2. Odaberite vrstu odredišta (SBC) i dodajte odlaznu rutu s hostom
   `sip.thunderphone.com`, portom `5061` i protokolom TLS. Krajnja točka zahtijeva
   TLS ili TCP (port `5060`) i odbija UDP. AWS ne dokumentira koje
   protokole konektor nudi, stoga potvrdite s AWS-om da može koristiti jedan od
   njih.
3. U svojem tijeku dodajte blok **Prijenos na telefonski broj** s opcijom **Prijenos na**
   postavljenom na **Vanjski glasovni sustav** i postavite:
   - **ARN odredišta:** konektor.
   - **Za korisnika:** korisnički dio `sip_uri` krajnje točke, kao što je
     `agent-12-jhxmginwjx`.
   - **UUI** (neobavezno): kontekst za agenta. Connect ga šalje heksadekadski kodiranog.
   - **Nastavi tijek nakon prekida veze:** Da, kako bi se tijek nastavio kada
     agent prekine poziv.

Connect šalje ID kontakta u `X-Amzn-ConnectContactId`. ThunderPhone ga pohranjuje
kao `external_call_id` poziva, što vašem tijeku omogućuje da kasnije pronađe poziv.
UUI dolazi do upute kao `{{sip_uui}}`. Integracije trećih strana dokumentiraju
zaglavlje ID-ja kontakta; AWS-ova vlastita dokumentacija to ne navodi, stoga ga provjerite pri prvom
testnom pozivu.

## 3. Dohvatite poziv natrag

AWS ne dokumentira način na koji Connect može čitati zaglavlja u `BYE` zahtjevu ni prihvatiti
`REFER` od agenta. Zato agent vraća poziv: pozdravi se i prekine vezu, a vaš se tijek nastavlja nakon bloka za prijenos. Dodajte ovaj broj za prijenos (pogledajte [Dodajte broj za prijenos](/hr/guides/contact-centers/overview)):

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

Zatim dohvatite predaju pomoću bloka **Pokrenite funkciju AWS Lambda** nakon
prijenosa. Lambda traži poziv prema ID-u kontakta:

```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 vraća ravnu mapu, pa se tijek može granati prema `intent` ili postaviti
`summary` kao atribut kontakta za osobu koja preuzima poziv. Pokrenite blok
sinkrono (do 8 sekundi) i API ključ pohranite šifriran, primjerice u AWS Secrets Manageru. Polja odgovora opisana su u
[Potražite predani poziv](/api-reference/calls#look-up-a-handed-off-call).

## Testirajte

Nazovite broj na svojoj instanci Connect koji vodi do bloka za prijenos, zatražite od
agenta osobu i provjerite nastavlja li se tijek. Zatim otvorite poziv pomoću
`GET /v1/calls/{call_id}`: `sip_headers` treba navesti
`x-amzn-connectcontactid`, a `external_call_id` treba biti jednak `ContactId`
koji prima vaša Lambda. Ako prijenos ne uspije sa SIP-om `404`, ThunderPhone nije
pronašao korisnički dio krajnje točke: mora biti i u URI-ju zahtjeva i u zaglavlju `To`.

## Ograničenja

- AWS ne dokumentira način čitanja zaglavlja u `BYE` zahtjevu, uključujući
  `X-TP-Handoff-Id`, pa je ID kontakta jedina poveznica natrag na poziv.
- AWS ne dokumentira najveću duljinu UUI-ja za poveznik.
- Sinkroni Lambda blok istječe nakon 8 sekundi.
