---
title: "Pripojenie z Amazon Connect"
description: "Odosielajte hovory z Amazon Connect hlasovému agentovi ThunderPhone cez SIP s ID kontaktu a UUI a pokračujte vo svojom toku s odovzdaním agenta."
---

Váš tok Amazon Connect odošle volajúceho agentovi s identifikátorom kontaktu a
ľubovoľným nastaveným UUI. Keď agent skončí, zavesí hovor, váš tok pokračuje a
Lambda načíta odovzdanie podľa identifikátora kontaktu.

## Skôr než začnete

- Agent ThunderPhone a [kľúč API](/sk/guides/api-keys) organizácie.
- Konektor Amazon Connect **Externý hlasový prenos**. Najprv požiadajte o
  zvýšenie kvóty „Konektory externého hlasového prenosu na účet“: ponuka
  zostane skrytá, kým ju AWS neschváli. AWS účtuje každý konektor za deň
  ([$100 za deň od 21. júla 2025](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  plus používanie za minútu.

<Warning>
  Aktuálna príručka správcu AWS už neobsahuje stránky o externom hlasovom prenose.
  Skôr než ho začnete používať, overte si u AWS, že je konektor dostupný pre
  vašu inštanciu a región.
</Warning>

## 1. Vytvorte koncový bod SIP

Konektor nedokumentuje autentifikáciu SIP digest, preto vytvorte
koncový bod, ktorý prijíma hovory podľa zdrojovej adresy:

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

Získajte od AWS signalizačné rozsahy SIP konektora pre váš región. Každý musí byť
verejný rozsah IPv4 s maskou `/16` alebo užšou (IPv6 `/48` alebo užšou). Pravidlá
a riziko adresy zdieľanej všetkými zákazníkmi platformy nájdete v časti
[Platformy, ktoré sa autentifikujú podľa zdrojovej IP](/sk/guides/sip-addresses).
Uchovajte si `sip_uri` z odpovede, napríklad
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Odosielajte hovory s kontextom

1. V konzole Amazon Connect otvorte **Externé hlasové systémy → Integrácie
   prenosu hlasu** a vyberte **Vytvoriť**.
2. Vyberte typ cieľa (SBC) a pridajte odchádzajúcu trasu s hostiteľom
   `sip.thunderphone.com`, portom `5061` a protokolom TLS. Koncový bod vyžaduje
   TLS alebo TCP (port `5060`) a odmieta UDP. AWS nedokumentuje, ktoré
   protokoly konektor ponúka, preto si u AWS overte, že môže použiť jeden z
   nich.
3. Do toku pridajte blok **Preniesť na telefónne číslo**, nastavte **Preniesť do**
   na **Externý hlasový systém** a nastavte:
   - **ARN cieľa:** konektor.
   - **Používateľ príjemcu:** používateľská časť `sip_uri` koncového bodu, napríklad
     `agent-12-jhxmginwjx`.
   - **UUI** (voliteľné): kontext pre agenta. Connect ho odosiela v hexadecimálnom kódovaní.
   - **Pokračovať v toku po odpojení:** Áno, aby tok pokračoval, keď agent zavesí hovor.

Connect odosiela identifikátor kontaktu v `X-Amzn-ConnectContactId`. ThunderPhone ho ukladá
ako `external_call_id` hovoru, podľa ktorého váš tok hovor neskôr nájde.
UUI sa do výzvy dostane ako `{{sip_uui}}`. Integrácie tretích strán dokumentujú
hlavičku identifikátora kontaktu; vlastná dokumentácia AWS nie, preto ju skontrolujte pri
prvom testovacom hovore.

## 3. Získajte hovor späť

AWS neuvádza spôsob, ako môže Connect čítať hlavičky v `BYE` alebo prijať
`REFER` od agenta. Agent preto hovor vráti: rozlúči sa a zavesí a váš tok
pokračuje po bloku prenosu. Pridajte toto číslo prenosu (pozrite si [Pridanie čísla prenosu](/sk/guides/contact-centers/overview)):

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

Potom po prenose získajte odovzdanie pomocou bloku **Vyvolať funkciu AWS Lambda**.
Lambda vyhľadá hovor podľa ID kontaktu:

```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 vráti plochú mapu, takže tok môže vetviť podľa `intent` alebo nastaviť
`summary` ako atribút kontaktu pre osobu, ktorá hovor prevezme. Blok spúšťajte
synchrónne (maximálne 8 sekúnd) a kľúč API ukladajte zašifrovaný, napríklad v
službe AWS Secrets Manager. Polia odpovede sú uvedené v dokumentácii
[Vyhľadanie odovzdaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestujte to

Zavolajte na číslo vo svojej inštancii Connect, ktoré vedie k bloku prenosu,
požiadajte agenta o spojenie s osobou a overte, že tok pokračuje. Potom otvorte
hovor pomocou `GET /v1/calls/{call_id}`: `sip_headers` by malo obsahovať
`x-amzn-connectcontactid` a `external_call_id` by sa malo rovnať hodnote
`ContactId`, ktorú prijme vaša Lambda. Ak prenos zlyhá s chybou SIP `404`,
ThunderPhone nenašiel používateľskú časť koncového bodu: musí byť v URI
požiadavky aj v hlavičke `To`.

## Obmedzenia

- AWS neuvádza spôsob, ako čítať hlavičky v `BYE` vrátane
  `X-TP-Handoff-Id`, takže ID kontaktu je jediným prepojením späť na hovor.
- AWS neuvádza maximálnu dĺžku UUI pre konektor.
- Synchrónny blok Lambda po 8 sekundách vyprší.
