ThunderPhone v3 כבר באוויר.בשירות עצמי, החל מ-2¢/דקה.קראו את הודעת ההשקה

Contact centers

התחברות מ-Amazon Connect

שלחו שיחות מ-Amazon Connect לסוכן ThunderPhone דרך SIP עם מזהה איש הקשר ו-UUI, והמשיכו את הזרימה שלכם עם העברת השיחה של הסוכן.

זרימת Amazon Connect שלכם מעבירה את המתקשר לסוכן עם מזהה איש הקשר וכל UUI שהגדרתם. כשהסוכן מסיים, הוא מנתק, הזרימה שלכם ממשיכה, ו-Lambda מאחזרת את ההעברה לפי מזהה איש הקשר.

לפני שמתחילים

  • סוכן ThunderPhone ומפתח API של הארגון.
  • מחבר העברת קול חיצונית של Amazon Connect. בקשו תחילה הגדלת מכסה עבור "External voice transfer connectors per account": התפריט נשאר מוסתר עד ש-AWS מאשרת אותה. AWS מחייבת עבור כל מחבר לפי יום ($100 ליום מאז 21 ביולי 2025) ובנוסף לפי שימוש בדקות.

1. צרו את נקודת הקצה של SIP

המחבר אינו מתעד אימות SIP digest, לכן צרו נקודת קצה שמקבלת שיחות לפי כתובת המקור:

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

קבלו מ-AWS את טווחי איתות ה-SIP של המחבר עבור האזור שלכם. כל טווח חייב להיות טווח IPv4 ציבורי של /16 או צר יותר (IPv6 של /48 או צר יותר). ראו פלטפורמות שמאמתות לפי כתובת IP של המקור עבור הכללים והסיכון שבכתובת המשותפת לכל לקוחות הפלטפורמה. שמרו את sip_uri מהתגובה, לדוגמה sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. שלחו שיחות עם הקשר

  1. במסוף Amazon Connect, פתחו את External Voice Systems → Voice Transfer Integrations ובחרו יצירה.
  2. בחרו את סוג היעד (SBC) והוסיפו נתיב יוצא עם המארח sip.thunderphone.com, היציאה 5061 והפרוטוקול TLS. נקודת הקצה דורשת TLS או TCP (יציאה 5060) ומסרבת ל-UDP. AWS אינה מתעדת אילו פרוטוקולים המחבר מציע, לכן ודאו מול AWS שהוא יכול להשתמש באחד מהם.
  3. בזרימה שלכם, הוסיפו בלוק העברה למספר טלפון כאשר העברה אל מוגדר כ-מערכת קול חיצונית, והגדירו:
    • ARN של היעד: המחבר.
    • אל משתמש: חלק המשתמש של sip_uri של נקודת הקצה, כגון agent-12-jhxmginwjx.
    • UUI (אופציונלי): הקשר עבור הסוכן. Connect שולחת אותו בקידוד הקסדצימלי.
    • המשך הזרימה לאחר ניתוק: כן, כדי שהזרימה תמשיך כשהסוכן מנתק.

Connect שולחת את מזהה איש הקשר ב-X-Amzn-ConnectContactId. ThunderPhone שומרת אותו כ-external_call_id של השיחה, וכך הזרימה שלכם מוצאת את השיחה מאוחר יותר. ה-UUI מגיע להנחיה כ-{{sip_uui}}. אינטגרציות של צד שלישי מתעדות את כותרת מזהה איש הקשר; התיעוד של AWS עצמה אינו עושה זאת, לכן בדקו אותה בשיחת הבדיקה הראשונה שלכם.

3. קבלו את השיחה בחזרה

AWS לא מתעדת דרך שבה Connect יכול לקרוא כותרות ב-BYE או לקבל REFER מהסוכן. לכן הסוכן מחזיר את השיחה: הוא נפרד ומנתק, והזרימה שלכם מתחדשת אחרי בלוק ההעברה. הוסיפו את מספר ההעברה הזה (ראו הוספת מספר ההעברה):

{"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 אמור להיות זהה ל-ContactId שה-Lambda שלכם מקבל. אם ההעברה נכשלת עם SIP 404, ThunderPhone לא מצא את חלק המשתמש של נקודת הקצה: הוא חייב להופיע גם ב-URI של הבקשה וגם בכותרת To.

מגבלות

  • AWS לא מתעדת דרך לקרוא כותרות ב-BYE, כולל X-TP-Handoff-Id, לכן מזהה איש הקשר הוא הקישור היחיד בחזרה לשיחה.
  • AWS לא מתעדת אורך UUI מרבי עבור המחבר.
  • בלוק Lambda סינכרוני מגיע לזמן קצוב לאחר 8 שניות.