ThunderPhone v3 sasa inapatikana.Anza mwenyewe, kuanzia 2¢/dakika.Soma tangazo

Contact centers

Unganisha kutoka Amazon Connect

Tuma simu za Amazon Connect kwa ejenti wa ThunderPhone kupitia SIP pamoja na kitambulisho cha mawasiliano na UUI, kisha endelea na mtiririko wako kwa makabidhiano ya ejenti.

Mtiririko wako wa Amazon Connect humtuma mpigaji simu kwa ejenti pamoja na kitambulisho cha mawasiliano na UUI yoyote uliyoweka. Ejenti anapomaliza, hukata simu, mtiririko wako unaendelea, na Lambda huchukua uhamisho kwa kutumia kitambulisho cha mawasiliano.

Kabla ya kuanza

  • Ejenti wa ThunderPhone na ufunguo wa API wa shirika.
  • Kiunganishi cha Uhamisho wa sauti wa nje cha Amazon Connect. Omba kwanza ongezeko la kikomo cha "Viunganishi vya uhamisho wa sauti wa nje kwa kila akaunti": menyu hubaki fiche hadi AWS iidhinishe. AWS hutoza kila kiunganishi kwa siku ($100 kwa siku tangu Julai 21, 2025) pamoja na matumizi ya kila dakika.

1. Unda endpoint ya SIP

Kiunganishi hakiandiki uthibitishaji wa SIP digest, kwa hivyo unda endpoint inayokubali simu kwa anwani chanzo:

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

Pata masafa ya uashiriaji wa SIP ya kiunganishi kwa Mkoa wako kutoka AWS. Kila moja lazima liwe masafa ya umma ya IPv4 ya /16 au membamba zaidi (IPv6 /48 au membamba zaidi). Angalia Majukwaa yanayothibitisha kwa IP chanzo kwa sheria na hatari ya anwani inayoshirikiwa na kila mteja wa jukwaa. Hifadhi sip_uri ya jibu, kwa mfano sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Tuma simu pamoja na muktadha

  1. Katika dashibodi ya Amazon Connect, fungua Mifumo ya Sauti ya Nje → Miunganisho ya Uhamisho wa Sauti kisha uchague Unda.
  2. Chagua aina ya lengwa (SBC) na uongeze njia ya kutoka yenye host sip.thunderphone.com, porti 5061 na itifaki TLS. Endpoint inahitaji TLS au TCP (porti 5060) na hukataa UDP. AWS haielezi ni itifaki zipi kiunganishi hutoa, kwa hivyo thibitisha na AWS kwamba kinaweza kutumia mojawapo yao.
  3. Katika mtiririko wako, ongeza bloku ya Hamisha kwa nambari ya simu huku Hamisha kwa ikiwekwa kuwa Mfumo wa sauti wa nje, kisha weka:
    • ARN ya lengwa: kiunganishi.
    • Kwa Mtumiaji: sehemu ya mtumiaji ya sip_uri ya endpoint, kama agent-12-jhxmginwjx.
    • UUI (hiari): muktadha wa ejenti. Connect huituma ikiwa imesimbwa kwa hex.
    • Endelea na mtiririko baada ya kukatwa: Ndiyo, ili mtiririko uendelee ejenti anapokata simu.

Connect hutuma kitambulisho cha mawasiliano katika X-Amzn-ConnectContactId. ThunderPhone huhifadhi hiki kama external_call_id ya simu, ambacho ndicho kinachowezesha mtiririko wako kupata simu baadaye. UUI hufika kwenye prompt kama {{sip_uui}}. Miunganisho ya wahusika wengine huandika header ya kitambulisho cha mawasiliano; nyaraka za AWS zenyewe hazifanyi hivyo, kwa hivyo ikague kwenye simu yako ya kwanza ya majaribio.

3. Rejesha simu

AWS haijaweka wazi njia ya Connect kusoma header kwenye BYE au kukubali REFER kutoka kwa ejenti. Kwa hivyo ejenti hurejesha simu: inaaga na kukata simu, kisha mtiririko wako unaendelea baada ya blok ya uhamisho. Ongeza nambari hii ya uhamisho (tazama Ongeza nambari ya uhamisho):

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

Kisha leta uhamishaji kwa blok ya Washa kipengele cha AWS Lambda baada ya uhamisho. Lambda huitafuta simu kwa kitambulisho cha mawasiliano:

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 "",
    }

Blok hurejesha ramani tambarare, kwa hivyo mtiririko unaweza kutenganisha kwa msingi wa intent au kuweka summary kama sifa ya mawasiliano kwa mtu anayepokea simu. Endesha blok kwa usawazishaji (hadi sekunde 8) na uhifadhi ufunguo wa API ukiwa umesimbwa, kwa mfano katika AWS Secrets Manager. Sehemu za jibu ziko katika Tafuta simu iliyohamishwa.

Ijaribu

Piga nambari kwenye instansi yako ya Connect inayofikia blok ya uhamisho, omba ejenti akuunganishe na mtu, na uhakikishe kwamba mtiririko unaendelea. Kisha fungua simu kwa GET /v1/calls/{call_id}: sip_headers inapaswa kuorodhesha x-amzn-connectcontactid, na external_call_id inapaswa kuwa sawa na ContactId ambayo Lambda yako inapokea. Ikiwa uhamisho unashindwa kwa SIP 404, ThunderPhone haikupata sehemu ya mtumiaji ya endpoint: lazima iwe katika URI ya ombi na header ya To.

Vikomo

  • AWS haijaweka wazi njia ya kusoma header kwenye BYE, ikijumuisha X-TP-Handoff-Id, kwa hivyo kitambulisho cha mawasiliano ndicho kiungo pekee cha kurejea kwenye simu.
  • AWS haijaweka wazi urefu wa juu zaidi wa UUI kwa kiunganishi.
  • Blok ya Lambda ya usawazishaji huisha muda baada ya sekunde 8.