ThunderPhone v3 ಈಗ ಲೈವ್ ಆಗಿದೆ.ನೀವೇ ನೇರವಾಗಿ ಆರಂಭಿಸಿ — 2¢/ನಿಮಿಷದಿಂದ.ಘೋಷಣೆ ಓದಿ

Contact centers

Amazon Connect ನಿಂದ ಸಂಪರ್ಕಿಸಿ

ಕಾಂಟ್ಯಾಕ್ಟ್ ಐಡಿ ಮತ್ತು UUI ಯೊಂದಿಗೆ Amazon Connect ಕರೆಗಳನ್ನು SIP ಮೂಲಕ ThunderPhone ಏಜೆಂಟ್‌ಗೆ ಕಳುಹಿಸಿ, ಮತ್ತು ಏಜೆಂಟ್‌ನ ಹ್ಯಾಂಡ್-ಆಫ್‌ನೊಂದಿಗೆ ನಿಮ್ಮ ಫ್ಲೋವನ್ನು ಪುನರಾರಂಭಿಸಿ.

ನಿಮ್ಮ Amazon Connect ಫ್ಲೋ ಕರೆ ಮಾಡುವವರನ್ನು ಸಂಪರ್ಕ ID ಮತ್ತು ನೀವು ಹೊಂದಿಸುವ ಯಾವುದೇ UUI ಜೊತೆಗೆ ಏಜೆಂಟ್‌ಗೆ ಕಳುಹಿಸುತ್ತದೆ. ಏಜೆಂಟ್ ಮುಗಿಸಿದಾಗ, ಅದು ಕರೆಯನ್ನು ಮುಗಿಸುತ್ತದೆ, ನಿಮ್ಮ ಫ್ಲೋ ಮುಂದುವರಿಯುತ್ತದೆ, ಮತ್ತು Lambda ಸಂಪರ್ಕ 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. ಸಂದರ್ಭದೊಂದಿಗೆ ಕರೆಗಳನ್ನು ಕಳುಹಿಸಿ

  1. Amazon Connect ಕನ್ಸೋಲ್‌ನಲ್ಲಿ, ಬಾಹ್ಯ ಧ್ವನಿ ವ್ಯವಸ್ಥೆಗಳು → ಧ್ವನಿ ವರ್ಗಾವಣೆ ಏಕೀಕರಣಗಳು ತೆರೆಯಿರಿ ಮತ್ತು ರಚಿಸಿ ಆಯ್ಕೆಮಾಡಿ.
  2. ಗಮ್ಯಸ್ಥಾನದ ಪ್ರಕಾರವನ್ನು (SBC) ಆಯ್ಕೆಮಾಡಿ ಮತ್ತು ಹೋಸ್ಟ್ sip.thunderphone.com, ಪೋರ್ಟ್ 5061, ಹಾಗೂ TLS ಪ್ರೋಟೋಕಾಲ್‌ನೊಂದಿಗೆ ಹೊರಹೋಗುವ ಮಾರ್ಗವನ್ನು ಸೇರಿಸಿ. ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗೆ TLS ಅಥವಾ TCP (ಪೋರ್ಟ್ 5060) ಅಗತ್ಯವಿದೆ ಮತ್ತು ಅದು UDP ಯನ್ನು ನಿರಾಕರಿಸುತ್ತದೆ. ಕನೆಕ್ಟರ್ ಯಾವ ಪ್ರೋಟೋಕಾಲ್‌ಗಳನ್ನು ಒದಗಿಸುತ್ತದೆ ಎಂಬುದನ್ನು AWS ದಾಖಲಿಸುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ ಅವುಗಳಲ್ಲಿ ಒಂದನ್ನು ಬಳಸಬಹುದೇ ಎಂದು AWS ಜೊತೆ ದೃಢೀಕರಿಸಿ.
  3. ನಿಮ್ಮ ಫ್ಲೋದಲ್ಲಿ, ಫೋನ್ ಸಂಖ್ಯೆಗೆ ವರ್ಗಾಯಿಸಿ ಬ್ಲಾಕ್ ಸೇರಿಸಿ, ಅದರಲ್ಲಿ ವರ್ಗಾಯಿಸು ಅನ್ನು ಬಾಹ್ಯ ಧ್ವನಿ ವ್ಯವಸ್ಥೆ ಎಂದು ಹೊಂದಿಸಿ, ನಂತರ ಹೀಗೆ ಹೊಂದಿಸಿ:
    • ಗಮ್ಯಸ್ಥಾನ ARN: ಕನೆಕ್ಟರ್.
    • ಬಳಕೆದಾರರಿಗೆ: ಎಂಡ್‌ಪಾಯಿಂಟ್‌ನ sip_uri ನ ಬಳಕೆದಾರ ಭಾಗ, ಉದಾಹರಣೆಗೆ agent-12-jhxmginwjx.
    • UUI (ಐಚ್ಛಿಕ): ಏಜೆಂಟ್‌ಗೆ ಸಂದರ್ಭ. Connect ಇದನ್ನು ಹೆಕ್ಸ್-ಎನ್‌ಕೋಡ್ ಮಾಡಿ ಕಳುಹಿಸುತ್ತದೆ.
    • ಸಂಪರ್ಕ ಕಡಿತದ ನಂತರ ಫ್ಲೋ ಪುನರಾರಂಭಿಸಿ: ಹೌದು, ಇದರಿಂದ ಏಜೆಂಟ್ ಕರೆ ಮುಗಿಸಿದಾಗ ಫ್ಲೋ ಮುಂದುವರಿಯುತ್ತದೆ.

Connect ಸಂಪರ್ಕ ID ಯನ್ನು X-Amzn-ConnectContactId ನಲ್ಲಿ ಕಳುಹಿಸುತ್ತದೆ. ThunderPhone ಅದನ್ನು ಕರೆಯ external_call_id ಆಗಿ ಸಂಗ್ರಹಿಸುತ್ತದೆ, ಇದರಿಂದ ನಿಮ್ಮ ಫ್ಲೋ ನಂತರ ಕರೆಯನ್ನು ಕಂಡುಹಿಡಿಯುತ್ತದೆ. UUI {{sip_uui}} ಆಗಿ prompt ಗೆ ತಲುಪುತ್ತದೆ. ತೃತೀಯ-ಪಕ್ಷದ ಏಕೀಕರಣಗಳು ಸಂಪರ್ಕ-ID ಹೆಡರ್ ಅನ್ನು ದಾಖಲಿಸುತ್ತವೆ; AWS ನ ಸ್ವಂತ ದಾಖಲೆಗಳು ಹಾಗೆ ಮಾಡುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ ನಿಮ್ಮ ಮೊದಲ ಪರೀಕ್ಷಾ ಕರೆಯಲ್ಲಿ ಅದನ್ನು ಪರಿಶೀಲಿಸಿ.

3. ಕರೆಯನ್ನು ಮರಳಿ ಪಡೆಯಿರಿ

Connect ಗೆ BYE ಮೇಲಿನ ಹೆಡರ್‌ಗಳನ್ನು ಓದಲು ಅಥವಾ ಏಜೆಂಟ್‌ನಿಂದ REFER ಅನ್ನು ಸ್ವೀಕರಿಸಲು 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 ಸೆಕೆಂಡುಗಳ ನಂತರ ಮೀರುತ್ತದೆ.