ThunderPhone v3 er live.Selvbetjening fra 2 cent pr. minut.Læs mere om lanceringen

Contact centers

Opret forbindelse fra Amazon Connect

Send Amazon Connect-opkald til en ThunderPhone-agent via SIP med kontakt-id

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 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) plus brug pr. minut.

1. Opret SIP-endpointet

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

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 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):

{"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:

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.

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.