---
title: "Yhdistä Amazon Connectista"
description: "Ohjaa Amazon Connect -puhelut ThunderPhone-agentille SIP:n kautta yhteystunnuksen ja UUI:n kera ja jatka työnkulkuasi agentin siirron avulla."
---

Amazon Connect -työnkulkusi lähettää soittajan agentille yhteystunnuksen ja
mahdollisesti asettamasi UUI:n kanssa. Kun agentti on valmis, se katkaisee puhelun, työnkulkusi jatkuu, ja Lambda hakee puhelunsiirron yhteystunnuksen perusteella.

## Ennen aloittamista

- ThunderPhone-agentti ja organisaation [API-avain](/fi/guides/api-keys).
- Amazon Connectin **ulkoisen puheensiirron** liitin. Pyydä ensin
  "Ulkoisen puheensiirron liittimet tiliä kohden" -kiintiön korotusta: valikko pysyy piilotettuna, kunnes AWS hyväksyy sen. AWS veloittaa kustakin liittimestä päivittäin
  ([$100 päivässä 21. heinäkuuta 2025 alkaen](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  sekä minuuttiperusteisesta käytöstä.

<Warning>
  AWS:n nykyisessä ylläpito-oppaassa ei enää ole sivuja ulkoisesta puheensiirrosta.
  Varmista AWS:ltä ennen käyttöönottoa, että liitin on käytettävissä instanssillesi ja alueellasi.
</Warning>

## 1. Luo SIP-päätepiste

Liittimen dokumentaatio ei kuvaa SIP-digest-todennusta, joten luo
päätepiste, joka hyväksyy puhelut lähdeosoitteen perusteella:

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

Hae liittimen SIP-signalointialueet alueellesi AWS:ltä. Jokaisen on oltava
julkinen IPv4-alue, kooltaan `/16` tai pienempi (IPv6: `/48` tai pienempi). Katso
säännöt ja riski, joka liittyy alustaan, jonka osoite on jaettu sen kaikkien asiakkaiden kesken,
kohdasta
[Alustat, jotka todentavat lähde-IP-osoitteen perusteella](/fi/guides/sip-addresses).
Säilytä vastauksen `sip_uri`, esimerkiksi
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Lähetä puhelut kontekstin kanssa

1. Avaa Amazon Connect -konsolissa **Ulkoiset puhejärjestelmät → Puheensiirtointegraatiot** ja valitse **Luo**.
2. Valitse kohdetyyppi (SBC) ja lisää lähtevä reitti, jonka isäntä on
   `sip.thunderphone.com`, portti `5061` ja protokolla TLS. Päätepiste vaatii
   TLS:n tai TCP:n (portti `5060`) eikä hyväksy UDP:tä. AWS ei dokumentoi, mitä
   protokollia liitin tarjoaa, joten varmista AWS:ltä, että se voi käyttää jotakin
   niistä.
3. Lisää työnkulkuusi **Siirrä puhelinnumeroon** -lohko, jossa **Siirrä kohteeseen**
   on **Ulkoinen puhejärjestelmä**, ja määritä:
   - **Kohteen ARN:** liitin.
   - **Käyttäjä:** päätepisteen `sip_uri`-osoitteen käyttäjäosa, esimerkiksi
     `agent-12-jhxmginwjx`.
   - **UUI** (valinnainen): agentin konteksti. Connect lähettää sen heksakoodattuna.
   - **Jatka työnkulkua yhteyden katkaisun jälkeen:** Kyllä, jotta työnkulku jatkuu,
     kun agentti katkaisee puhelun.

Connect lähettää yhteystunnuksen otsakkeessa `X-Amzn-ConnectContactId`. ThunderPhone tallentaa
sen puhelun `external_call_id`-arvoksi, jonka avulla työnkulkusi löytää puhelun
myöhemmin. UUI saapuu kehotteeseen muodossa `{{sip_uui}}`. Kolmannen osapuolen integraatiot
dokumentoivat yhteystunnusotsakkeen, mutta AWS:n omat dokumentit eivät, joten tarkista se
ensimmäisessä testipuhelussasi.

## 3. Hae puhelu takaisin

AWS ei dokumentoi tapaa, jolla Connect voisi lukea `BYE`-viestin otsakkeita tai
hyväksyä agentin lähettämän `REFER`-pyynnön. Agentti siis palauttaa puhelun:
se hyvästelee ja katkaisee puhelun, ja työnkulkusi jatkuu siirtolohkon jälkeen.
Lisää tämä siirtonumero (katso [Lisää siirtonumero](/fi/guides/contact-centers/overview)):

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

Hae sitten luovutustiedot siirron jälkeen olevalla **Kutsu AWS Lambda -funktiota**
-lohkolla. Lambda hakee puhelun yhteystunnuksen perusteella:

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

Lohko palauttaa tasaisen kartan, joten työnkulku voi haarautua `intent`-arvon
perusteella tai asettaa `summary`-arvon yhteystiedon attribuutiksi puhelun
vastaanottavalle henkilölle. Suorita lohko synkronisesti (enintään 8 sekuntia)
ja tallenna API-avain salattuna esimerkiksi AWS Secrets Manageriin.
Vastauskentät ovat kohdassa
[Hae luovutettu puhelu](/api-reference/calls#look-up-a-handed-off-call).

## Testaa

Soita Connect-instanssisi numeroon, joka ohjautuu siirtolohkoon, pyydä
agentilta henkilöä ja tarkista, että työnkulku jatkuu. Avaa sitten puhelu
komennolla `GET /v1/calls/{call_id}`: `sip_headers`-kentässä pitäisi näkyä
`x-amzn-connectcontactid`, ja `external_call_id`-kentän pitäisi vastata
Lambdan vastaanottamaa `ContactId`-arvoa. Jos siirto epäonnistuu SIP-virheellä
`404`, ThunderPhone ei löytänyt päätepisteen käyttäjäosaa: sen täytyy olla sekä
pyynnön URI:ssa että `To`-otsakkeessa.

## Rajoitukset

- AWS ei dokumentoi tapaa lukea `BYE`-viestin otsakkeita, mukaan lukien
  `X-TP-Handoff-Id`, joten yhteystunnus on ainoa linkki takaisin puheluun.
- AWS ei dokumentoi liittimen UUI:n enimmäispituutta.
- Synkroninen Lambda-lohko aikakatkaistaan 8 sekunnin kuluttua.
