Open in
Yhdistä Amazon Connectista
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.
- 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) sekä minuuttiperusteisesta käytöstä.
1. Luo SIP-päätepiste
Liittimen dokumentaatio ei kuvaa SIP-digest-todennusta, joten luo päätepiste, joka hyväksyy puhelut lähdeosoitteen perusteella:
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.
Säilytä vastauksen sip_uri, esimerkiksi
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Lähetä puhelut kontekstin kanssa
- Avaa Amazon Connect -konsolissa Ulkoiset puhejärjestelmät → Puheensiirtointegraatiot ja valitse Luo.
- Valitse kohdetyyppi (SBC) ja lisää lähtevä reitti, jonka isäntä on
sip.thunderphone.com, portti5061ja protokolla TLS. Päätepiste vaatii TLS:n tai TCP:n (portti5060) eikä hyväksy UDP:tä. AWS ei dokumentoi, mitä protokollia liitin tarjoaa, joten varmista AWS:ltä, että se voi käyttää jotakin niistä. - 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, esimerkiksiagent-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):
{"name": "Amazon Connect", "action": "return"}Hae sitten luovutustiedot siirron jälkeen olevalla Kutsu AWS Lambda -funktiota -lohkolla. Lambda hakee puhelun yhteystunnuksen perusteella:
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.
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 lukienX-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.