---
title: "Conectați din Amazon Connect"
description: "Trimiteți apeluri Amazon Connect către un agent ThunderPhone prin SIP, împreună cu ID-ul de contact și UUI, apoi reluați fluxul cu transferul agentului."
---

Fluxul dumneavoastră Amazon Connect trimite apelantul către agent cu ID-ul de contact și
orice UUI configurați. Când agentul termină, închide apelul, fluxul dumneavoastră continuă, iar
o funcție Lambda preia transferul după ID-ul de contact.

## Înainte de a începe

- Un agent ThunderPhone și o [cheie API](/ro/guides/api-keys) a organizației.
- Conectorul Amazon Connect **Transfer vocal extern**. Solicitați mai întâi
  creșterea cotei „Conectori de transfer vocal extern per cont”: meniul rămâne ascuns până când AWS o aprobă. AWS facturează fiecare conector pe zi
  ([$100 pe zi începând cu 21 iulie 2025](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  plus utilizarea pe minut.

<Warning>
  Ghidul actual de administrare AWS nu mai conține pagini despre transferul vocal extern.
  Înainte de a construi pe baza acestuia, confirmați cu AWS că conectorul este disponibil pentru
  instanța și regiunea dumneavoastră.
</Warning>

## 1. Creați punctul terminal SIP

Conectorul nu documentează autentificarea SIP digest, așadar creați un
punct terminal care acceptă apeluri după adresa sursă:

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

Obțineți de la AWS intervalele de semnalizare SIP ale conectorului pentru regiunea dumneavoastră. Fiecare trebuie să fie
un interval IPv4 public de `/16` sau mai restrâns (IPv6 `/48` sau mai restrâns). Consultați
[Platforme care se autentifică după IP-ul sursă](/ro/guides/sip-addresses)
pentru reguli și riscul unei adrese partajate de fiecare client al
platformei. Păstrați `sip_uri` din răspuns, de exemplu
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Trimiteți apeluri cu context

1. În consola Amazon Connect, deschideți **Sisteme vocale externe → Integrări de
   transfer vocal** și alegeți **Creare**.
2. Alegeți tipul de destinație (un SBC) și adăugați o rută de ieșire cu gazda
   `sip.thunderphone.com`, portul `5061` și protocolul TLS. Punctul terminal necesită
   TLS sau TCP (portul `5060`) și refuză UDP. AWS nu documentează ce
   protocoale oferă conectorul, așadar confirmați cu AWS că poate utiliza unul dintre
   acestea.
3. În fluxul dumneavoastră, adăugați un bloc **Transferați către număr de telefon** cu **Transferați către**
   setat la **Sistem vocal extern** și configurați:
   - **ARN de destinație:** conectorul.
   - **Către utilizator:** partea de utilizator din `sip_uri` al punctului terminal, precum
     `agent-12-jhxmginwjx`.
   - **UUI** (opțional): context pentru agent. Connect îl trimite codificat hexazecimal.
   - **Reluați fluxul după deconectare:** Da, astfel încât fluxul să continue când
     agentul închide apelul.

Connect trimite ID-ul de contact în `X-Amzn-ConnectContactId`. ThunderPhone îl stochează
ca `external_call_id` al apelului, astfel găsește fluxul dumneavoastră apelul
ulterior. UUI ajunge în prompt ca `{{sip_uui}}`. Integrările terțe
documentează antetul ID-ului de contact; documentația AWS nu îl menționează, așadar verificați-l la primul
apel de test.

## 3. Preluați apelul înapoi

AWS nu documentează nicio metodă prin care Connect să citească anteturile din `BYE` sau să accepte un `REFER` de la agent. Prin urmare, agentul returnează apelul: își ia rămas-bun și închide, iar fluxul dumneavoastră reia execuția după blocul de transfer. Adăugați acest număr de transfer (consultați [Adăugați numărul de transfer](/ro/guides/contact-centers/overview)):

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

Apoi preluați transferul cu un bloc **Invocați funcția AWS Lambda** după transfer. Lambda caută apelul după ID-ul contactului:

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

Blocul returnează o mapare plată, astfel încât fluxul poate crea ramificații pe baza lui `intent` sau poate seta `summary` ca atribut de contact pentru persoana care preia apelul. Rulați blocul sincron (până la 8 secunde) și stocați cheia API criptată, de exemplu în AWS Secrets Manager. Câmpurile de răspuns sunt disponibile în [Căutați un apel transferat](/api-reference/calls#look-up-a-handed-off-call).

## Testați

Apelați un număr din instanța dumneavoastră Connect care ajunge la blocul de transfer, solicitați agentului o persoană și verificați că fluxul reia execuția. Apoi deschideți apelul cu `GET /v1/calls/{call_id}`: `sip_headers` trebuie să includă `x-amzn-connectcontactid`, iar `external_call_id` trebuie să fie egal cu `ContactId` primit de Lambda. Dacă transferul eșuează cu SIP `404`, ThunderPhone nu a găsit partea de utilizator a endpointului: aceasta trebuie să fie atât în URI-ul cererii, cât și în antetul `To`.

## Limite

- AWS nu documentează nicio metodă de a citi anteturile din `BYE`, inclusiv `X-TP-Handoff-Id`, astfel încât ID-ul contactului este singura legătură înapoi către apel.
- AWS nu documentează o lungime UUI maximă pentru conector.
- Un bloc Lambda sincron expiră după 8 secunde.
