---
title: "Opret forbindelse fra Amazon Connect"
description: "Send Amazon Connect-opkald til en ThunderPhone-agent via SIP med kontakt-id'et og UUI, og genoptag dit flow med agentens overdragelse."
---

Dit Amazon Connect-flow sender opkalderen til agenten med kontakt-id'et og
eventuel UUI, du angiver. Når agenten er færdig, lægger den på, dit flow
fortsætter, og en Lambda henter overdragelsen via kontakt-id'et.

## Før du starter

- En ThunderPhone-agent og en [API-nøgle](/da/guides/api-keys) til organisationen.
- Amazon Connects connector til **ekstern stemmeoverførsel**. Anmod først om
  en forhøjelse af kvoten "Connectors til ekstern stemmeoverførsel pr. konto":
  menuen forbliver skjult, indtil AWS godkender den. AWS fakturerer hver
  connector pr. dag
  ([$100 om dagen siden 21. juli 2025](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  plus brug pr. minut.

<Warning>
  AWS' nuværende administratorvejledning har ikke længere sider om ekstern
  stemmeoverførsel. Før du bygger på den, skal du bekræfte med AWS, at
  connectoren er tilgængelig for din instans og region.
</Warning>

## 1. Opret SIP-endpointet

Connectoren dokumenterer ikke SIP-digestgodkendelse, så opret et endpoint, der
accepterer opkald efter kildeadresse:

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

Hent connectorens SIP-signalområder for din region fra AWS. Hvert område skal
være et offentligt IPv4-område på `/16` eller snævrere (IPv6 `/48` eller
snævrere). Se
[Platforme, der godkender efter kilde-IP](/da/guides/sip-addresses)
for reglerne og risikoen ved en adresse, der deles af alle platformens kunder.
Gem svarets `sip_uri`, for eksempel
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Send opkald med kontekst

1. Åbn **Eksterne stemmesystemer → Integrationer til stemmeoverførsel** i
   Amazon Connect-konsollen, og vælg **Opret**.
2. Vælg destinationstypen (en SBC), og tilføj en udgående rute med værten
   `sip.thunderphone.com`, port `5061` og protokollen TLS. Endpointet kræver
   TLS eller TCP (port `5060`) og afviser UDP. AWS dokumenterer ikke, hvilke
   protokoller connectoren tilbyder, så bekræft med AWS, at den kan bruge en af
   dem.
3. Tilføj blokken **Overfør til telefonnummer** i dit flow med **Overfør til**
   angivet til **Eksternt stemmesystem**, og angiv:
   - **Destinations-ARN:** connectoren.
   - **Til bruger:** brugerdelen af endpointets `sip_uri`, for eksempel
     `agent-12-jhxmginwjx`.
   - **UUI** (valgfrit): kontekst til agenten. Connect sender den
     hex-kodet.
   - **Genoptag flow efter afbrydelse:** Ja, så flowet fortsætter, når
     agenten lægger på.

Connect sender kontakt-id'et i `X-Amzn-ConnectContactId`. ThunderPhone gemmer
det som opkaldets `external_call_id`, hvilket gør det muligt for dit flow at
finde opkaldet senere. UUI'en når prompten som `{{sip_uui}}`.
Tredjepartsintegrationer dokumenterer kontakt-id-headeren; AWS' egen
dokumentation gør ikke, så kontrollér den ved dit første testopkald.

## 3. Få opkaldet tilbage

AWS dokumenterer ingen måde, hvorpå Connect kan læse headers på `BYE` eller acceptere en
`REFER` fra agenten. Derfor returnerer agenten opkaldet: den siger farvel og
lægger på, og dit flow fortsætter efter overførselsblokken. Tilføj dette overførselsnummer
(se [Tilføj overførselsnummeret](/da/guides/contact-centers/overview)):

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

Hent derefter overleveringen med en **Kald AWS Lambda-funktion**-blok efter
overførslen. Lambdaen slår opkaldet op efter kontakt-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 "",
    }
```

Blokken returnerer et fladt map, så flowet kan forgrene på `intent` eller angive
`summary` som en kontaktattribut for den person, der overtager opkaldet. Kør
blokken synkront (op til 8 sekunder), og gem API-nøglen krypteret, for eksempel
i AWS Secrets Manager. Svarfelterne findes i
[Slå et overleveret opkald op](/api-reference/calls#look-up-a-handed-off-call).

## Test det

Ring til et nummer på din Connect-instans, der når overførselsblokken, bed
agenten om en person, og kontrollér, at flowet fortsætter. Åbn derefter opkaldet med
`GET /v1/calls/{call_id}`: `sip_headers` skal indeholde
`x-amzn-connectcontactid`, og `external_call_id` skal svare til det `ContactId`,
din Lambda modtager. Hvis overførslen fejler med SIP `404`, fandt ThunderPhone
ikke endpointets brugerdel: den skal være i både request-URI'en og `To`-headeren.

## Begrænsninger

- AWS dokumenterer ingen måde at læse headers på `BYE`, herunder
  `X-TP-Handoff-Id`, så kontakt-id'et er det eneste link tilbage til opkaldet.
- AWS dokumenterer ikke en maksimal UUI-længde for connectoren.
- En synkron Lambda-blok får timeout efter 8 sekunder.
