ThunderPhone v3 இப்போது கிடைக்கிறது.நீங்களே தொடங்கலாம்; நிமிடத்திற்கு 2¢ முதல்.அறிவிப்பைப் படிக்கவும்

Contact centers

Amazon Connect இலிருந்து இணைக்கவும்

contact id மற்றும் UUI உடன் Amazon Connect அழைப்புகளை SIP வழியாக ThunderPhone ஏஜென்ட்டிற்கு அனுப்பி, ஏஜென்ட்டின் hand-off மூலம் உங்கள் flow-ஐத் தொடரவும்.

உங்கள் Amazon Connect flow, contact ID மற்றும் நீங்கள் அமைக்கும் எந்த UUI-உடனும் அழைப்பாளரை ஏஜென்ட்டிற்கு அனுப்பும். ஏஜென்ட் முடித்ததும், அது அழைப்பைத் துண்டிக்கும், உங்கள் flow தொடரும், மேலும் ஒரு Lambda contact ID மூலம் ஒப்படைப்பைப் பெறும்.

தொடங்குவதற்கு முன்

  • ஒரு ThunderPhone ஏஜென்ட் மற்றும் ஒரு நிறுவனம் API விசை.
  • Amazon Connect-இன் வெளிப்புற குரல் பரிமாற்றம் இணைப்பி. முதலில் "ஒரு கணக்கிற்கான வெளிப்புற குரல் பரிமாற்ற இணைப்பிகள்" quota அதிகரிப்பைக் கோருங்கள்: AWS அதை அங்கீகரிக்கும் வரை மெனு மறைந்தே இருக்கும். AWS ஒவ்வொரு இணைப்பிக்கும் ஒரு நாளுக்கு கட்டணம் வசூலிக்கும் ($100 ஒரு நாள், July 21, 2025 முதல்) மற்றும் நிமிடப் பயன்பாட்டிற்கும் கூடுதல் கட்டணம் வசூலிக்கும்.

1. SIP endpoint-ஐ உருவாக்குங்கள்

இந்த இணைப்பி SIP digest அங்கீகாரத்தை ஆவணப்படுத்தவில்லை; எனவே மூல முகவரி மூலம் அழைப்புகளை ஏற்கும் ஒரு endpoint-ஐ உருவாக்குங்கள்:

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

உங்கள் பிராந்தியத்திற்கான இணைப்பியின் SIP சிக்னலிங் வரம்புகளை AWS-இடமிருந்து பெறுங்கள். ஒவ்வொன்றும் /16 அல்லது அதைவிடக் குறுகலான பொது IPv4 வரம்பாக இருக்க வேண்டும் (IPv6 /48 அல்லது அதைவிடக் குறுகலானது). விதிகள் மற்றும் தளத்தின் ஒவ்வொரு வாடிக்கையாளரும் பகிரக்கூடிய முகவரியின் ஆபத்து பற்றிய விவரங்களுக்கு மூல IP மூலம் அங்கீகரிக்கும் தளங்கள் பார்க்கவும். பதிலில் உள்ள sip_uri-ஐ வைத்திருங்கள், உதாரணமாக sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. சூழலுடன் அழைப்புகளை அனுப்புங்கள்

  1. Amazon Connect console-இல், வெளிப்புற குரல் அமைப்புகள் → குரல் பரிமாற்ற ஒருங்கிணைப்புகள் என்பதைத் திறந்து உருவாக்கு என்பதைத் தேர்ந்தெடுக்கவும்.
  2. இலக்கு வகையை (ஒரு SBC) தேர்ந்தெடுத்து, host sip.thunderphone.com, port 5061, மற்றும் TLS நெறிமுறையுடன் ஒரு வெளிச்செல்லும் route-ஐச் சேர்க்கவும். இந்த endpoint-க்கு TLS அல்லது TCP (port 5060) தேவை; அது UDP-ஐ நிராகரிக்கும். இணைப்பி எந்த நெறிமுறைகளை வழங்குகிறது என்பதை AWS ஆவணப்படுத்தவில்லை; எனவே அவற்றில் ஒன்றைப் பயன்படுத்த முடியும் என்பதை AWS-இடம் உறுதிப்படுத்துங்கள்.
  3. உங்கள் flow-இல், தொலைபேசி எண்ணுக்கு பரிமாற்று block-ஐச் சேர்த்து, பரிமாற்று என்பதை வெளிப்புற குரல் அமைப்பு என அமைக்கவும்; பின்னர் இதை அமைக்கவும்:
    • இலக்கு ARN: இணைப்பி.
    • பயனருக்கு: endpoint-இன் sip_uri-இல் உள்ள பயனர் பகுதி, உதாரணமாக agent-12-jhxmginwjx.
    • UUI (விருப்பமானது): ஏஜென்ட்டிற்கான சூழல். Connect இதை hex-encoded வடிவில் அனுப்பும்.
    • இணைப்பு துண்டிக்கப்பட்ட பிறகு flow-ஐத் தொடரவும்: ஆம், இதனால் ஏஜென்ட் அழைப்பைத் துண்டிக்கும்போது flow தொடரும்.

Connect, contact ID-ஐ X-Amzn-ConnectContactId-இல் அனுப்பும். ThunderPhone அதை அழைப்பின் external_call_id ஆகச் சேமிக்கும்; இதன் மூலமே உங்கள் flow பின்னர் அழைப்பைக் கண்டறியும். UUI, prompt-ஐ {{sip_uui}} ஆக அடையும். மூன்றாம் தரப்பு ஒருங்கிணைப்புகள் contact-ID header-ஐ ஆவணப்படுத்துகின்றன; AWS-இன் சொந்த ஆவணங்கள் அவ்வாறு செய்யவில்லை, எனவே உங்கள் முதல் சோதனை அழைப்பில் அதைச் சரிபார்க்கவும்.

3. அழைப்பை மீண்டும் பெறுங்கள்

BYE-இல் தலைப்புகளைப் படிக்கவோ அல்லது ஏஜென்டிடமிருந்து REFER-ஐ ஏற்கவோ Connect-க்கு வழி இல்லை என்று AWS ஆவணப்படுத்துகிறது. எனவே ஏஜென்ட் அழைப்பைத் திருப்பி அனுப்புகிறது: அது விடைபெற்று அழைப்பை முடிக்கிறது, மேலும் பரிமாற்றத் தொகுதிக்குப் பிறகு உங்கள் ஓட்டம் தொடர்கிறது. இந்தப் பரிமாற்ற எண்ணைச் சேர்க்கவும் (பரிமாற்ற எண்ணைச் சேர்க்கவும் பார்க்கவும்):

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

பின்னர், பரிமாற்றத்திற்குப் பிறகு AWS Lambda செயல்பாட்டை அழைக்கவும் தொகுதி மூலம் ஒப்படைப்பைப் பெறுங்கள். Lambda, தொடர்பு அடையாளத்தின் மூலம் அழைப்பைக் கண்டறியும்:

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

இந்தத் தொகுதி ஒரு எளிய மேப்பைத் திருப்பி அனுப்புகிறது; எனவே ஓட்டம் intent-ஐ அடிப்படையாகக் கொண்டு கிளையாக்கலாம் அல்லது அழைப்பை ஏற்கும் நபருக்கான தொடர்பு பண்புக்கூறாக summary-ஐ அமைக்கலாம். தொகுதியை ஒத்திசைவாக இயக்குங்கள் (அதிகபட்சம் 8 வினாடிகள்), மேலும் API விசையை குறியாக்கப்பட்ட நிலையில் சேமியுங்கள்; எடுத்துக்காட்டாக AWS Secrets Manager-ல். பதில் புலங்கள் ஒப்படைக்கப்பட்ட அழைப்பைக் கண்டறியுங்கள்-இல் உள்ளன.

இதைச் சோதிக்கவும்

பரிமாற்றத் தொகுதியை அடையும் உங்கள் Connect நிகழ்விலுள்ள எண்ணை அழைத்து, ஏஜென்டிடம் ஒரு நபரைக் கேட்டு, ஓட்டம் தொடர்கிறதா என்பதைச் சரிபார்க்கவும். பின்னர் GET /v1/calls/{call_id} மூலம் அழைப்பைத் திறக்கவும்: sip_headers-இல் x-amzn-connectcontactid பட்டியலிடப்பட்டிருக்க வேண்டும், மேலும் external_call_id, உங்கள் Lambda பெறும் ContactId-க்கு சமமாக இருக்க வேண்டும். SIP 404 உடன் பரிமாற்றம் தோல்வியடைந்தால், ThunderPhone இறுதிப்புள்ளியின் பயனர் பகுதியைக் கண்டறியவில்லை: அது கோரிக்கை URI மற்றும் To தலைப்பு இரண்டிலும் இருக்க வேண்டும்.

வரம்புகள்

  • X-TP-Handoff-Id உட்பட BYE-இல் தலைப்புகளைப் படிப்பதற்கான வழியை AWS ஆவணப்படுத்தவில்லை; எனவே அழைப்புக்கான ஒரே இணைப்பு தொடர்பு அடையாளம்தான்.
  • இணைப்பிக்கான அதிகபட்ச UUI நீளத்தை AWS ஆவணப்படுத்தவில்லை.
  • ஒத்திசைவு Lambda தொகுதி 8 வினாடிகளுக்குப் பிறகு நேரம் முடிவடையும்.