Open in
Amazon Connect પરથી કનેક્ટ કરો
contact id અને UUI સાથે Amazon Connect કૉલ્સને SIP મારફતે ThunderPhone એજન્ટ પાસે મોકલો અને એજન્ટના હેન્ડ-ઓફ સાથે તમારો ફ્લો ફરી શરૂ કરો.
તમારો Amazon Connect ફ્લો કૉલરને સંપર્ક ID અને તમે સેટ કરેલ કોઈપણ UUI સાથે એજન્ટ પાસે મોકલે છે. એજન્ટનું કામ પૂર્ણ થાય ત્યારે તે કૉલ બંધ કરે છે, તમારો ફ્લો આગળ ચાલુ રહે છે અને Lambda સંપર્ક ID દ્વારા હેન્ડ-ઓફ મેળવે છે.
શરૂ કરતાં પહેલાં
- ThunderPhone એજન્ટ અને સંસ્થાની API કી.
- Amazon Connectનું બાહ્ય વૉઇસ ટ્રાન્સફર કનેક્ટર. પહેલાં "એકાઉન્ટ દીઠ બાહ્ય વૉઇસ ટ્રાન્સફર કનેક્ટર્સ" માટે ક્વોટા વધારો માગો: AWS તેને મંજૂરી આપે ત્યાં સુધી મેનૂ છુપાયેલું રહે છે. AWS દરેક કનેક્ટર માટે દરરોજ (21 જુલાઈ, 2025થી દરરોજ $100) ઉપરાંત પ્રતિ-મિનિટ ઉપયોગનું બિલ કરે છે.
1. SIP એન્ડપૉઇન્ટ બનાવો
કનેક્ટર SIP ડાઇજેસ્ટ ઑથેન્ટિકેશનનું દસ્તાવેજીકરણ કરતું નથી, તેથી સ્ત્રોત સરનામા પરથી આવતા કૉલ સ્વીકારે એવું એન્ડપૉઇન્ટ બનાવો:
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માંથી મેળવો. દરેક જાહેર IPv4 રેન્જ /16 અથવા તેથી વધુ સંકુચિત હોવી જોઈએ (IPv6 /48 અથવા તેથી વધુ સંકુચિત). નિયમો અને પ્લેટફૉર્મના દરેક ગ્રાહક દ્વારા શેર કરાતા સરનામાના જોખમ માટે
સ્ત્રોત IP દ્વારા ઑથેન્ટિકેટ કરતી પ્લેટફૉર્મ્સ
જુઓ. પ્રતિસાદનું sip_uri રાખો, ઉદાહરણ તરીકે
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. સંદર્ભ સાથે કૉલ મોકલો
- Amazon Connect કન્સોલમાં, બાહ્ય વૉઇસ સિસ્ટમ્સ → વૉઇસ ટ્રાન્સફર ઇન્ટિગ્રેશન્સ ખોલો અને બનાવો પસંદ કરો.
- ગંતવ્ય પ્રકાર (SBC) પસંદ કરો અને હોસ્ટ
sip.thunderphone.com, પોર્ટ5061અને પ્રોટોકૉલ TLS સાથે આઉટબાઉન્ડ રૂટ ઉમેરો. એન્ડપૉઇન્ટને TLS અથવા TCP (પોર્ટ5060) જરૂરી છે અને તે UDP સ્વીકારતું નથી. AWS કનેક્ટર કયા પ્રોટોકૉલ આપે છે તેનું દસ્તાવેજીકરણ કરતું નથી, તેથી AWS સાથે ખાતરી કરો કે તેમાંથી કોઈ એકનો ઉપયોગ કરી શકે છે. - તમારા ફ્લોમાં, ફોન નંબર પર ટ્રાન્સફર કરો બ્લૉક ઉમેરો જેમાં ટ્રાન્સફર કરો ને બાહ્ય વૉઇસ સિસ્ટમ પર સેટ કરો, અને સેટ કરો:
- ગંતવ્ય ARN: કનેક્ટર.
- વપરાશકર્તા માટે: એન્ડપૉઇન્ટના
sip_uriનો વપરાશકર્તા ભાગ, જેમ કેagent-12-jhxmginwjx. - UUI (વૈકલ્પિક): એજન્ટ માટેનો સંદર્ભ. Connect તેને હેક્સ-એન્કોડેડ મોકલે છે.
- ડિસકનેક્ટ પછી ફ્લો ફરી શરૂ કરો: હા, જેથી એજન્ટ કૉલ બંધ કરે ત્યારે ફ્લો ચાલુ રહે.
Connect સંપર્ક IDને X-Amzn-ConnectContactIdમાં મોકલે છે. ThunderPhone તેને કૉલના external_call_id તરીકે સંગ્રહિત કરે છે, જેના દ્વારા તમારો ફ્લો પછીથી કૉલ શોધે છે. UUI {{sip_uui}} તરીકે prompt સુધી પહોંચે છે. તૃતીય-પક્ષ ઇન્ટિગ્રેશન્સ સંપર્ક-ID હેડરનું દસ્તાવેજીકરણ કરે છે; AWSના પોતાના દસ્તાવેજોમાં તે નથી, તેથી તમારા પ્રથમ ટેસ્ટ કૉલમાં તેને તપાસો.
3. કૉલ પાછો મેળવો
AWS એ BYE પર હેડર્સ વાંચવા અથવા એજન્ટ પાસેથી REFER સ્વીકારવા માટે Connect પાસે કોઈ રીત દસ્તાવેજીકૃત કરી નથી. તેથી એજન્ટ કૉલ પરત કરે છે: તે વિદાય કહે છે અને કૉલ બંધ કરે છે, અને ટ્રાન્સફર બ્લોક પછી તમારો ફ્લો ફરી શરૂ થાય છે. આ ટ્રાન્સફર નંબર ઉમેરો (ટ્રાન્સફર નંબર ઉમેરો જુઓ):
{"name": "Amazon Connect", "action": "return"}પછી ટ્રાન્સફર પછીના AWS Lambda ફંક્શન ચલાવો બ્લોકથી હેન્ડ-ઑફ મેળવો. Lambda સંપર્ક 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 "",
}બ્લોક ફ્લેટ મેપ પરત કરે છે, તેથી ફ્લો 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 હેડર બંનેમાં હોવો આવશ્યક છે.
મર્યાદાઓ
- AWS એ
X-TP-Handoff-IdસહિતBYEપર હેડર્સ વાંચવાની કોઈ રીત દસ્તાવેજીકૃત કરી નથી, તેથી સંપર્ક ID કૉલ સાથે પાછી જોડતી એકમાત્ર કડી છે. - AWS એ કનેક્ટર માટે મહત્તમ UUI લંબાઈ દસ્તાવેજીકૃત કરી નથી.
- સિંક્રોનસ Lambda બ્લોક 8 સેકન્ડ પછી સમયસમાપ્તિ પામે છે.