ThunderPhone v3 ir klāt.Sāciet patstāvīgi — no 2 ¢/min.Lasīt paziņojumu

Contact centers

Savienošana no Amazon Connect

Nosūtiet Amazon Connect zvanus uz ThunderPhone balss aģentu, izmantojot SIP ar kontakta ID un UUI, un atsāciet savu plūsmu ar balss aģenta pāradresēšanu.

Jūsu Amazon Connect plūsma nosūta zvanītāju balss aģentam kopā ar kontakta ID un jebkādu jūsu iestatīto UUI. Kad balss aģents ir pabeidzis darbu, tas noliek klausuli, jūsu plūsma turpinās, un Lambda pēc kontakta ID iegūst pārsūtīšanas informāciju.

Pirms sākat

  • ThunderPhone balss aģents un organizācijas API atslēga.
  • Amazon Connect Ārējās balss pārsūtīšanas savienotājs. Vispirms pieprasiet kvotas palielinājumu “Ārējās balss pārsūtīšanas savienotāji vienam kontam”: izvēlne paliek paslēpta, līdz AWS to apstiprina. AWS par katru savienotāju iekasē maksu dienā ($100 dienā kopš 2025. gada 21. jūlija) un maksu par lietojumu minūtēs.

1. Izveidojiet SIP galapunktu

Savienotāja dokumentācijā nav aprakstīta SIP digest autentifikācija, tāpēc izveidojiet galapunktu, kas pieņem zvanus pēc avota adreses:

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

Iegūstiet savienotāja SIP signalizācijas diapazonus savam reģionam no AWS. Katram jābūt publiskam IPv4 diapazonam ar /16 vai šaurāku masku (IPv6 /48 vai šaurāku masku). Skatiet Platformas, kas autentificē pēc avota IP noteikumus un risku, ko rada adrese, kuru koplieto visi platformas klienti. Saglabājiet atbildē norādīto sip_uri, piemēram, sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Nosūtiet zvanus ar kontekstu

  1. Amazon Connect konsolē atveriet Ārējās balss sistēmas → Balss pārsūtīšanas integrācijas un izvēlieties Izveidot.
  2. Atlasiet galamērķa tipu (SBC) un pievienojiet izejošo maršrutu ar resursdatoru sip.thunderphone.com, portu 5061 un TLS protokolu. Galapunktam nepieciešams TLS vai TCP (ports 5060), un tas noraida UDP. AWS nedokumentē, kurus protokolus savienotājs piedāvā, tāpēc apstipriniet AWS, ka tas var izmantot kādu no tiem.
  3. Savā plūsmā pievienojiet bloku Pārsūtīt uz tālruņa numuru, kur Pārsūtīt uz ir iestatīts uz Ārējā balss sistēma, un norādiet:
    • Galamērķa ARN: savienotāju.
    • Lietotājam: galapunkta sip_uri lietotāja daļu, piemēram, agent-12-jhxmginwjx.
    • UUI (neobligāti): balss aģenta kontekstu. Connect to nosūta heksadecimāli kodētu.
    • Atsākt plūsmu pēc atvienošanas: Jā, lai plūsma turpinātos, kad balss aģents noliek klausuli.

Connect nosūta kontakta ID laukā X-Amzn-ConnectContactId. ThunderPhone to saglabā kā zvana external_call_id, un tā jūsu plūsma vēlāk atrod zvanu. UUI nonāk uzvednē kā {{sip_uui}}. Trešo pušu integrāciju dokumentācijā ir aprakstīta kontakta ID galvene; AWS dokumentācijā tās nav, tāpēc pārbaudiet to savā pirmajā testa zvanā.

3. Saņemiet zvanu atpakaļ

AWS nedokumentē veidu, kā Connect varētu nolasīt galvenes BYE ziņojumā vai pieņemt aģenta REFER ziņojumu. Tāpēc balss aģents atgriež zvanu: tas atvadās un noliek klausuli, un jūsu plūsma turpinās pēc pārsūtīšanas bloka. Pievienojiet šo pārsūtīšanas numuru (skatiet Pievienojiet pārsūtīšanas numuru):

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

Pēc pārsūtīšanas izgūstiet nodošanas informāciju ar bloku Izsaukt AWS Lambda funkciju. Lambda meklē zvanu pēc kontaktpersonas 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 "",
    }

Bloks atgriež plakanu kartējumu, tāpēc plūsma var veidot atzarojumu pēc intent vai iestatīt summary kā kontaktpersonas atribūtu personai, kura pieņem zvanu. Palaidiet bloku sinhroni (līdz 8 sekundēm) un glabājiet API atslēgu šifrētā veidā, piemēram, AWS Secrets Manager. Atbildes lauki ir aprakstīti sadaļā Meklēt nodotu zvanu.

Pārbaudiet

Zvaniet uz numuru savā Connect instancē, kas sasniedz pārsūtīšanas bloku, lūdziet balss aģentam savienot ar personu un pārbaudiet, vai plūsma turpinās. Pēc tam atveriet zvanu ar GET /v1/calls/{call_id}: sip_headers jānorāda x-amzn-connectcontactid, un external_call_id jāatbilst ContactId, ko saņem jūsu Lambda. Ja pārsūtīšana neizdodas ar SIP 404, ThunderPhone neatrada galapunkta lietotāja daļu: tai jābūt gan pieprasījuma URI, gan To galvenē.

Ierobežojumi

  • AWS nedokumentē veidu, kā nolasīt galvenes BYE ziņojumā, tostarp X-TP-Handoff-Id, tāpēc kontaktpersonas ID ir vienīgā saite atpakaļ uz zvanu.
  • AWS nedokumentē savienotāja maksimālo UUI garumu.
  • Sinhronais Lambda bloks pārsniedz noildzi pēc 8 sekundēm.