---
title: "Savienošana no Amazon Connect"
description: "Nosūtiet Amazon Connect zvanus uz ThunderPhone balss aģentu, izmantojot SIP ar kontakta ID un UUI, un atsāciet savu plūsmu ar balss aģenta pāradresēšanu."
---

Jūsu Amazon Connect plūsma nosūta zvanītāju balss aģentam kopā ar kontakta ID un jebkādu jūsu iestatīto UUI. Kad balss aģents ir pabeidzis darbu, tas noliek klausuli, jūsu plūsma turpinās, un Lambda pēc kontakta ID iegūst pārsūtīšanas informāciju.

## Pirms sākat

- ThunderPhone balss aģents un organizācijas [API atslēga](/lv/guides/api-keys).
- Amazon Connect **Ārējās balss pārsūtīšanas** savienotājs. Vispirms pieprasiet kvotas palielinājumu “Ārējās balss pārsūtīšanas savienotāji vienam kontam”: izvēlne paliek paslēpta, līdz AWS to apstiprina. AWS par katru savienotāju iekasē maksu dienā ([$100 dienā kopš 2025. gada 21. jūlija](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  un maksu par lietojumu minūtēs.

<Warning>
  AWS pašreizējā administratora rokasgrāmatā vairs nav lapu par ārējo balss pārsūtīšanu.
  Pirms to izmantojat, apstipriniet AWS, ka savienotājs ir pieejams jūsu instancei un
  reģionam.
</Warning>

## 1. Izveidojiet SIP galapunktu

Savienotāja dokumentācijā nav aprakstīta SIP digest autentifikācija, tāpēc izveidojiet
galapunktu, kas pieņem zvanus pēc avota adreses:

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

Iegūstiet savienotāja SIP signalizācijas diapazonus savam reģionam no AWS. Katram jābūt
publiskam IPv4 diapazonam ar `/16` vai šaurāku masku (IPv6 `/48` vai šaurāku masku). Skatiet
[Platformas, kas autentificē pēc avota IP](/lv/guides/sip-addresses)
noteikumus un risku, ko rada adrese, kuru koplieto visi platformas
klienti. Saglabājiet atbildē norādīto `sip_uri`, piemēram,
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Nosūtiet zvanus ar kontekstu

1. Amazon Connect konsolē atveriet **Ārējās balss sistēmas → Balss
   pārsūtīšanas integrācijas** un izvēlieties **Izveidot**.
2. Atlasiet galamērķa tipu (SBC) un pievienojiet izejošo maršrutu ar resursdatoru
   `sip.thunderphone.com`, portu `5061` un TLS protokolu. Galapunktam nepieciešams
   TLS vai TCP (ports `5060`), un tas noraida UDP. AWS nedokumentē, kurus
   protokolus savienotājs piedāvā, tāpēc apstipriniet AWS, ka tas var izmantot kādu
   no tiem.
3. Savā plūsmā pievienojiet bloku **Pārsūtīt uz tālruņa numuru**, kur **Pārsūtīt uz**
   ir iestatīts uz **Ārējā balss sistēma**, un norādiet:
   - **Galamērķa ARN:** savienotāju.
   - **Lietotājam:** galapunkta `sip_uri` lietotāja daļu, piemēram,
     `agent-12-jhxmginwjx`.
   - **UUI** (neobligāti): balss aģenta kontekstu. Connect to nosūta heksadecimāli kodētu.
   - **Atsākt plūsmu pēc atvienošanas:** Jā, lai plūsma turpinātos, kad
     balss aģents noliek klausuli.

Connect nosūta kontakta ID laukā `X-Amzn-ConnectContactId`. ThunderPhone to saglabā
kā zvana `external_call_id`, un tā jūsu plūsma vēlāk atrod zvanu. UUI nonāk
uzvednē kā `{{sip_uui}}`. Trešo pušu integrāciju dokumentācijā ir aprakstīta
kontakta ID galvene; AWS dokumentācijā tās nav, tāpēc pārbaudiet to savā pirmajā
testa zvanā.

## 3. Saņemiet zvanu atpakaļ

AWS nedokumentē veidu, kā Connect varētu nolasīt galvenes `BYE` ziņojumā vai
pieņemt aģenta `REFER` ziņojumu. Tāpēc balss aģents atgriež zvanu: tas atvadās un
noliek klausuli, un jūsu plūsma turpinās pēc pārsūtīšanas bloka. Pievienojiet šo
pārsūtīšanas numuru (skatiet [Pievienojiet pārsūtīšanas numuru](/lv/guides/contact-centers/overview)):

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

Pēc pārsūtīšanas izgūstiet nodošanas informāciju ar bloku **Izsaukt AWS Lambda funkciju**.
Lambda meklē zvanu pēc kontaktpersonas ID:

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

Bloks atgriež plakanu kartējumu, tāpēc plūsma var veidot atzarojumu pēc `intent` vai iestatīt
`summary` kā kontaktpersonas atribūtu personai, kura pieņem zvanu. Palaidiet
bloku sinhroni (līdz 8 sekundēm) un glabājiet API atslēgu šifrētā veidā, piemēram,
AWS Secrets Manager. Atbildes lauki ir aprakstīti sadaļā
[Meklēt nodotu zvanu](/api-reference/calls#look-up-a-handed-off-call).

## Pārbaudiet

Zvaniet uz numuru savā Connect instancē, kas sasniedz pārsūtīšanas bloku, lūdziet
balss aģentam savienot ar personu un pārbaudiet, vai plūsma turpinās. Pēc tam atveriet
zvanu ar `GET /v1/calls/{call_id}`: `sip_headers` jānorāda
`x-amzn-connectcontactid`, un `external_call_id` jāatbilst `ContactId`,
ko saņem jūsu Lambda. Ja pārsūtīšana neizdodas ar SIP `404`, ThunderPhone
neatrada galapunkta lietotāja daļu: tai jābūt gan pieprasījuma URI, gan `To`
galvenē.

## Ierobežojumi

- AWS nedokumentē veidu, kā nolasīt galvenes `BYE` ziņojumā, tostarp
  `X-TP-Handoff-Id`, tāpēc kontaktpersonas ID ir vienīgā saite atpakaļ uz zvanu.
- AWS nedokumentē savienotāja maksimālo UUI garumu.
- Sinhronais Lambda bloks pārsniedz noildzi pēc 8 sekundēm.
