---
title: "Połącz z Amazon Connect"
description: "Przekazuj połączenia z Amazon Connect do agenta ThunderPhone przez SIP z identyfikatorem kontaktu i UUI, a następnie wznawiaj przepływ po przekazaniu rozmowy przez agenta."
---

Przepływ Amazon Connect przekazuje rozmówcę do agenta wraz z identyfikatorem kontaktu
i ustawionym przez Ciebie UUI. Gdy agent zakończy rozmowę, rozłącza się, przepływ jest kontynuowany,
a funkcja Lambda pobiera przekazanie na podstawie identyfikatora kontaktu.

## Zanim zaczniesz

- Agent ThunderPhone i organizacyjny [klucz API](/pl/guides/api-keys).
- Konektor **External voice transfer** Amazon Connect. Najpierw poproś o
  zwiększenie limitu „External voice transfer connectors per account”: menu pozostaje ukryte, dopóki AWS go nie zatwierdzi. AWS nalicza opłatę dzienną za każdy konektor
  ([$100 dziennie od 21 lipca 2025 r.](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  oraz opłatę za użycie naliczaną za minutę.

<Warning>
  Aktualny przewodnik administratora AWS nie zawiera już stron dotyczących zewnętrznego transferu głosowego.
  Zanim go wdrożysz, potwierdź z AWS, że konektor jest dostępny dla
  Twojej instancji i regionu.
</Warning>

## 1. Utwórz punkt końcowy SIP

Konektor nie dokumentuje uwierzytelniania SIP Digest, dlatego utwórz
punkt końcowy, który akceptuje połączenia według adresu źródłowego:

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

Pobierz z AWS zakresy sygnalizacji SIP konektora dla swojego regionu. Każdy z nich musi być
publicznym zakresem IPv4 o prefiksie `/16` lub węższym (IPv6 `/48` lub węższym). Zobacz
[Platformy uwierzytelniane według źródłowego adresu IP](/pl/guides/sip-addresses)
aby poznać zasady oraz ryzyko związane z adresem współdzielonym przez wszystkich klientów
platformy. Zachowaj `sip_uri` z odpowiedzi, na przykład
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Wysyłaj połączenia z kontekstem

1. W konsoli Amazon Connect otwórz **External Voice Systems → Voice
   Transfer Integrations** i wybierz **Create**.
2. Wybierz typ miejsca docelowego (SBC) i dodaj trasę wychodzącą z hostem
   `sip.thunderphone.com`, portem `5061` oraz protokołem TLS. Punkt końcowy wymaga
   TLS lub TCP (port `5060`) i odrzuca UDP. AWS nie dokumentuje, które
   protokoły oferuje konektor, dlatego potwierdź z AWS, że może użyć jednego z
   nich.
3. W swoim przepływie dodaj blok **Transfer to phone number**, w którym opcja **Transfer to**
   jest ustawiona na **External voice system**, a następnie ustaw:
   - **Destination ARN:** konektor.
   - **To User:** część użytkownika `sip_uri` punktu końcowego, na przykład
     `agent-12-jhxmginwjx`.
   - **UUI** (opcjonalnie): kontekst dla agenta. Connect wysyła go w kodowaniu szesnastkowym.
   - **Resume flow after disconnect:** Tak, aby przepływ był kontynuowany, gdy
     agent się rozłączy.

Connect wysyła identyfikator kontaktu w `X-Amzn-ConnectContactId`. ThunderPhone zapisuje
go jako `external_call_id` połączenia, dzięki czemu przepływ może później znaleźć połączenie.
UUI trafia do promptu jako `{{sip_uui}}`. Integracje innych firm
dokumentują nagłówek identyfikatora kontaktu, ale dokumentacja AWS tego nie robi, dlatego sprawdź go podczas pierwszego
połączenia testowego.

## 3. Odbierz połączenie z powrotem

AWS nie dokumentuje sposobu, aby Connect odczytał nagłówki w `BYE` lub zaakceptował
`REFER` od agenta. Dlatego agent zwraca połączenie: żegna się i
rozłącza, a przepływ jest wznawiany po bloku transferu. Dodaj ten numer
transferowy (zobacz [Dodaj numer transferowy](/pl/guides/contact-centers/overview)):

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

Następnie pobierz przekazanie za pomocą bloku **Wywołaj funkcję AWS Lambda** po
transferze. Funkcja Lambda wyszukuje połączenie według identyfikatora 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 zwraca płaską mapę, więc przepływ może rozgałęziać się na podstawie `intent` lub ustawić
`summary` jako atrybut kontaktu dla osoby, która odbiera połączenie. Uruchom
blok synchronicznie (do 8 sekund) i przechowuj klucz API w postaci zaszyfrowanej, na
przykład w AWS Secrets Manager. Pola odpowiedzi opisano w
[Wyszukaj przekazane połączenie](/api-reference/calls#look-up-a-handed-off-call).

## Przetestuj

Zadzwoń na numer w instancji Connect, który prowadzi do bloku transferu, poproś
agenta o połączenie z osobą i sprawdź, czy przepływ zostanie wznowiony. Następnie otwórz połączenie za pomocą
`GET /v1/calls/{call_id}`: `sip_headers` powinno zawierać
`x-amzn-connectcontactid`, a `external_call_id` powinno być równe `ContactId`,
które otrzymuje funkcja Lambda. Jeśli transfer zakończy się błędem SIP `404`, ThunderPhone nie
znalazł części użytkownika punktu końcowego: musi ona występować zarówno w URI żądania, jak i w nagłówku `To`.

## Limity

- AWS nie dokumentuje sposobu odczytu nagłówków w `BYE`, w tym
  `X-TP-Handoff-Id`, dlatego identyfikator kontaktu jest jedynym połączeniem zwrotnym z połączeniem.
- AWS nie dokumentuje maksymalnej długości UUI dla konektora.
- Synchroniczny blok Lambda przekracza limit czasu po 8 sekundach.
