ThunderPhone v3 on julkaistu.Ota käyttöön itse – alkaen 2 ¢/min.Lue lisää julkistuksesta

Contact centers

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

  1. Avaa Amazon Connect -konsolissa Ulkoiset puhejärjestelmät → Puheensiirtointegraatiot ja valitse Luo.
  2. Valitse kohdetyyppi (SBC) ja lisää lähtevä reitti, jonka isäntä on sip.thunderphone.com, portti 5061 ja protokolla TLS. Päätepiste vaatii TLS:n tai TCP:n (portti 5060) eikä hyväksy UDP:tä. AWS ei dokumentoi, mitä protokollia liitin tarjoaa, joten varmista AWS:ltä, että se voi käyttää jotakin niistä.
  3. 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, esimerkiksi agent-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 lukien X-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.