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

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

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

- סוכן ThunderPhone ומפתח [API של הארגון](/he/guides/api-keys).
- מחבר **העברת קול חיצונית** של Amazon Connect. בקשו תחילה הגדלת מכסה עבור "External voice transfer connectors per account": התפריט נשאר מוסתר עד ש-AWS מאשרת אותה. AWS מחייבת עבור כל מחבר לפי יום ([$100 ליום מאז 21 ביולי 2025](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  ובנוסף לפי שימוש בדקות.

<Warning>
  במדריך הניהול הנוכחי של AWS אין עוד דפים עבור העברת קול חיצונית.
  לפני שתבנו על כך, ודאו מול AWS שהמחבר זמין עבור המופע והאזור שלכם.
</Warning>

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

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

```bash
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 של המקור](/he/guides/sip-addresses)
עבור הכללים והסיכון שבכתובת המשותפת לכל לקוחות הפלטפורמה.
שמרו את `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` מהסוכן. לכן הסוכן מחזיר את השיחה: הוא נפרד ומנתק, והזרימה שלכם
מתחדשת אחרי בלוק ההעברה. הוסיפו את מספר ההעברה הזה (ראו [הוספת מספר ההעברה](/he/guides/contact-centers/overview)):

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

לאחר ההעברה, אחזרו את מסירת השיחה באמצעות בלוק **הפעלת פונקציית AWS Lambda**.
ה-Lambda מאתר את השיחה לפי מזהה איש הקשר:

```python
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.
שדות התגובה מפורטים ב-[איתור שיחה שנמסרה](/api-reference/calls#look-up-a-handed-off-call).

## בדקו זאת

התקשרו למספר במופע ה-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 שניות.
