Open in
Amazon Connect ਤੋਂ ਕਨੈਕਟ ਕਰੋ
Amazon Connect ਕਾਲਾਂ ਨੂੰ contact id ਅਤੇ UUI ਸਮੇਤ SIP ਰਾਹੀਂ ThunderPhone ਏਜੰਟ ਨੂੰ ਭੇਜੋ, ਅਤੇ ਏਜੰਟ ਦੇ hand-off ਨਾਲ ਆਪਣਾ ਫਲੋ ਮੁੜ ਸ਼ੁਰੂ ਕਰੋ।
ਤੁਹਾਡਾ Amazon Connect ਫਲੋ ਕਾਲਰ ਨੂੰ contact id ਅਤੇ ਤੁਹਾਡੇ ਵੱਲੋਂ ਸੈੱਟ ਕੀਤਾ ਕੋਈ ਵੀ UUI ਦੇ ਨਾਲ ਏਜੰਟ ਕੋਲ ਭੇਜਦਾ ਹੈ। ਜਦੋਂ ਏਜੰਟ ਦਾ ਕੰਮ ਮੁੱਕ ਜਾਂਦਾ ਹੈ, ਉਹ ਕਾਲ ਬੰਦ ਕਰ ਦਿੰਦਾ ਹੈ, ਤੁਹਾਡਾ ਫਲੋ ਜਾਰੀ ਰਹਿੰਦਾ ਹੈ, ਅਤੇ ਇੱਕ Lambda contact id ਰਾਹੀਂ ਹੈਂਡ-ਆਫ਼ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ
- ਇੱਕ ThunderPhone ਏਜੰਟ ਅਤੇ ਇੱਕ ਸੰਗਠਨ ਦੀ API ਕੁੰਜੀ।
- Amazon Connect ਦਾ ਬਾਹਰੀ ਵੌਇਸ ਟ੍ਰਾਂਸਫਰ ਕਨੈਕਟਰ। ਪਹਿਲਾਂ "ਪ੍ਰਤੀ ਖਾਤਾ ਬਾਹਰੀ ਵੌਇਸ ਟ੍ਰਾਂਸਫਰ ਕਨੈਕਟਰ" ਕੋਟਾ ਵਧਾਉਣ ਦੀ ਬੇਨਤੀ ਕਰੋ: AWS ਦੀ ਮਨਜ਼ੂਰੀ ਮਿਲਣ ਤੱਕ ਮੀਨੂ ਲੁਕਿਆ ਰਹਿੰਦਾ ਹੈ। AWS ਹਰੇਕ ਕਨੈਕਟਰ ਲਈ ਪ੍ਰਤੀ ਦਿਨ ($100 ਪ੍ਰਤੀ ਦਿਨ, 21 ਜੁਲਾਈ 2025 ਤੋਂ) ਅਤੇ ਪ੍ਰਤੀ-ਮਿੰਟ ਵਰਤੋਂ ਲਈ ਬਿੱਲ ਕਰਦਾ ਹੈ।
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 ਤੋਂ ਪ੍ਰਾਪਤ ਕਰੋ। ਹਰੇਕ
/16 ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ ਜਨਤਕ IPv4 ਰੇਂਜ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ (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 X-Amzn-ConnectContactId ਵਿੱਚ contact id ਭੇਜਦਾ ਹੈ। ThunderPhone ਇਸਨੂੰ ਕਾਲ ਦੇ external_call_id ਵਜੋਂ ਸਟੋਰ ਕਰਦਾ ਹੈ, ਜਿਸ ਰਾਹੀਂ ਤੁਹਾਡਾ ਫਲੋ ਬਾਅਦ ਵਿੱਚ ਕਾਲ ਲੱਭਦਾ ਹੈ। UUI prompt ਤੱਕ {{sip_uui}} ਵਜੋਂ ਪਹੁੰਚਦਾ ਹੈ। ਤੀਜੀ-ਧਿਰ ਇੰਟੀਗ੍ਰੇਸ਼ਨ contact-id ਹੈਡਰ ਨੂੰ ਦਸਤਾਵੇਜ਼ਬੱਧ ਕਰਦੀਆਂ ਹਨ; AWS ਦੇ ਆਪਣੇ ਦਸਤਾਵੇਜ਼ ਨਹੀਂ ਕਰਦੇ, ਇਸ ਲਈ ਆਪਣੀ ਪਹਿਲੀ ਟੈਸਟ ਕਾਲ ਵਿੱਚ ਇਸਦੀ ਜਾਂਚ ਕਰੋ।
3. ਕਾਲ ਦੀ ਜਾਣਕਾਰੀ ਵਾਪਸ ਲਵੋ
AWS ਨੇ ਇਹ ਨਹੀਂ ਦੱਸਿਆ ਕਿ Connect BYE ਉੱਤੇ ਹੈਡਰ ਕਿਵੇਂ ਪੜ੍ਹ ਸਕਦਾ ਹੈ ਜਾਂ
ਏਜੰਟ ਤੋਂ REFER ਕਿਵੇਂ ਸਵੀਕਾਰ ਕਰ ਸਕਦਾ ਹੈ। ਇਸ ਲਈ ਏਜੰਟ ਕਾਲ ਵਾਪਸ ਕਰਦਾ ਹੈ: ਉਹ
ਵਿਦਾ ਕਹਿ ਕੇ ਕਾਲ ਕੱਟ ਦਿੰਦਾ ਹੈ ਅਤੇ ਤੁਹਾਡਾ ਫਲੋ ਟ੍ਰਾਂਸਫਰ ਬਲਾਕ ਤੋਂ ਬਾਅਦ ਮੁੜ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ। ਇਹ ਟ੍ਰਾਂਸਫਰ
ਨੰਬਰ ਜੋੜੋ (ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਜੋੜੋ ਵੇਖੋ):
{"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 ਉਸ ContactId
ਦੇ ਬਰਾਬਰ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ ਜੋ ਤੁਹਾਡੇ Lambda ਨੂੰ ਮਿਲਦਾ ਹੈ। ਜੇ ਟ੍ਰਾਂਸਫਰ SIP 404 ਨਾਲ ਅਸਫਲ ਹੁੰਦਾ ਹੈ,
ਤਾਂ ThunderPhone ਨੂੰ ਐਂਡਪੌਇੰਟ ਦਾ ਯੂਜ਼ਰ ਭਾਗ ਨਹੀਂ ਮਿਲਿਆ: ਇਹ ਬੇਨਤੀ URI ਅਤੇ To
ਹੈਡਰ, ਦੋਵਾਂ ਵਿੱਚ ਹੋਣਾ ਲਾਜ਼ਮੀ ਹੈ।
ਸੀਮਾਵਾਂ
- AWS ਨੇ
BYEਉੱਤੇ, ਜਿਸ ਵਿੱਚX-TP-Handoff-Idਵੀ ਸ਼ਾਮਲ ਹੈ, ਹੈਡਰ ਪੜ੍ਹਨ ਦਾ ਕੋਈ ਤਰੀਕਾ ਨਹੀਂ ਦੱਸਿਆ, ਇਸ ਲਈ ਸੰਪਰਕ id ਹੀ ਕਾਲ ਨਾਲ ਵਾਪਸ ਜੋੜਨ ਦਾ ਇੱਕੋ-ਇੱਕ ਲਿੰਕ ਹੈ। - AWS ਨੇ ਕਨੈਕਟਰ ਲਈ ਵੱਧ ਤੋਂ ਵੱਧ UUI ਲੰਬਾਈ ਬਾਰੇ ਕੋਈ ਦਸਤਾਵੇਜ਼ ਨਹੀਂ ਦਿੱਤਾ।
- ਇੱਕ ਸਮਕਾਲੀ Lambda ਬਲਾਕ 8 ਸਕਿੰਟਾਂ ਬਾਅਦ ਟਾਈਮ ਆਉਟ ਹੋ ਜਾਂਦਾ ਹੈ।