---
title: "Připojení z Amazon Connect"
description: "Přesměrujte hovory z Amazon Connect k agentovi ThunderPhone přes SIP s ID kontaktu a UUI a pokračujte ve svém toku po předání agentem."
---

Váš tok Amazon Connect odešle volajícího agentovi s ID kontaktu a
libovolným UUI, které nastavíte. Když agent skončí, zavěsí, váš tok pokračuje a
Lambda načte předání podle ID kontaktu.

## Než začnete

- Agent ThunderPhone a [klíč API](/cs/guides/api-keys) organizace.
- Konektor **Externí hlasový přenos** služby Amazon Connect. Nejprve požádejte o
  zvýšení kvóty „Konektory externího hlasového přenosu na účet“: nabídka zůstane
  skrytá, dokud ji AWS neschválí. AWS účtuje každý konektor za den
  ([$100 za den od 21. července 2025](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  plus využití za minutu.

<Warning>
  Aktuální příručka pro správce AWS již neobsahuje stránky o externím hlasovém
  přenosu. Než jej začnete používat, ověřte si u AWS, že je konektor dostupný
  pro vaši instanci a Region.
</Warning>

## 1. Vytvořte koncový bod SIP

Konektor nedokumentuje ověřování SIP digest, proto vytvořte koncový bod, který
přijímá hovory podle zdrojové 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ískejte od AWS rozsahy signalizace SIP konektoru pro váš Region. Každý musí být
veřejný rozsah IPv4 o velikosti `/16` nebo menší (IPv6 `/48` nebo menší). Pravidla
a riziko adresy sdílené všemi zákazníky platformy najdete v části
[Platformy ověřované podle zdrojové IP](/cs/guides/sip-addresses).
Uložte si `sip_uri` z odpovědi, například
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Odesílejte hovory s kontextem

1. V konzoli Amazon Connect otevřete **Externí hlasové systémy → Integrace
   přenosu hlasu** a zvolte **Vytvořit**.
2. Vyberte typ cíle (SBC) a přidejte odchozí trasu s hostitelem
   `sip.thunderphone.com`, portem `5061` a protokolem TLS. Koncový bod vyžaduje
   TLS nebo TCP (port `5060`) a odmítá UDP. AWS nedokumentuje, které protokoly
   konektor nabízí, proto u AWS ověřte, že může použít jeden z nich.
3. Do toku přidejte blok **Přenos na telefonní číslo**, u možnosti **Přenést do**
   nastavte **Externí hlasový systém** a zadejte:
   - **ARN cíle:** konektor.
   - **Uživateli:** uživatelskou část `sip_uri` koncového bodu, například
     `agent-12-jhxmginwjx`.
   - **UUI** (volitelné): kontext pro agenta. Connect jej odesílá v hexadecimálním
     kódování.
   - **Pokračovat v toku po odpojení:** Ano, aby tok pokračoval, když agent
     zavěsí.

Connect odesílá ID kontaktu v `X-Amzn-ConnectContactId`. ThunderPhone jej ukládá
jako `external_call_id` hovoru, podle kterého váš tok hovor později najde.
UUI se do promptu dostane jako `{{sip_uui}}`. Integrace třetích stran hlavičku
ID kontaktu dokumentují; vlastní dokumentace AWS nikoli, proto ji zkontrolujte
při prvním testovacím hovoru.

## 3. Nechte hovor vrátit

AWS nepopisuje žádný způsob, jak může Connect číst hlavičky v `BYE` nebo přijmout
`REFER` od agenta. Agent proto hovor vrátí: rozloučí se a zavěsí a váš tok se
obnoví po bloku přesměrování. Přidejte toto číslo přesměrování (viz [Přidání čísla přesměrování](/cs/guides/contact-centers/overview)):

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

Poté po přesměrování načtěte předání pomocí bloku **Vyvolat funkci AWS Lambda**.
Funkce Lambda vyhledá hovor podle 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 vrací plochou mapu, takže tok se může větvit podle `intent` nebo nastavit
`summary` jako atribut kontaktu pro osobu, která hovor převezme. Spusťte blok
synchronně (až 8 sekund) a klíč API ukládejte zašifrovaný, například ve službě
AWS Secrets Manager. Pole odpovědi jsou popsána v části
[Vyhledání předaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestujte to

Zavolejte na číslo ve své instanci Connect, které vede k bloku přesměrování,
požádejte agenta o spojení s osobou a ověřte, že se tok obnoví. Poté otevřete
hovor pomocí `GET /v1/calls/{call_id}`: `sip_headers` by mělo obsahovat
`x-amzn-connectcontactid` a `external_call_id` by se mělo rovnat `ContactId`,
které přijme vaše Lambda. Pokud přesměrování selže se SIP `404`, ThunderPhone
nenašel uživatelskou část koncového bodu: musí být v identifikátoru URI požadavku
i v hlavičce `To`.

## Omezení

- AWS nepopisuje žádný způsob, jak číst hlavičky v `BYE`, včetně
  `X-TP-Handoff-Id`, takže ID kontaktu je jediným odkazem zpět na hovor.
- AWS neuvádí maximální délku UUI pro konektor.
- Synchronní blok Lambda vyprší po 8 sekundách.
