---
title: "התחברות מ-Talkdesk"
description: "העבירו שיחות מ-Talkdesk לסוכן ThunderPhone באמצעות Connect to Autopilot Voice, והסלימו אותן בחזרה באמצעות מזהה ההעברה ב-UUI."
---

זרימת Talkdesk Studio שלכם שולחת את המתקשר לסוכן עם מזהה האינטראקציה ו-UUI. כאשר המתקשר זקוק לאדם, הסוכן מסלים את השיחה באמצעות SIP
`REFER` אל Talkdesk, ומזהה ההעברה מגיע למשתנה ב-Studio.

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

- סוכן ThunderPhone ומפתח [API](/he/guides/api-keys) של הארגון.
- רישיון **מתאם שיחות** של Talkdesk, הכולל את הרכיב **התחברות ל-Autopilot קולי** במצב **זרם קול חיצוני**
  ([המאמר של Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk מחייבת לפי דקה בזמן שהסוכן מחזיק את השיחה.

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

Talkdesk מתעדת רק רשימת היתרים של כתובות IP, לכן צרו נקודת קצה שמקבלת
שיחות לפי כתובת המקור:

```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": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'
```

המאמר של Talkdesk מציין שהיא שולחת שמע דרך SRTP, ו-`"srtp": "optional"`
משיב באמצעות SRTP כאשר Talkdesk מציעה אותו. המאמר אינו מציין אם Talkdesk
מחייבת SRTP; אם Talkdesk מודיעה לכם שכן, הגדירו את `srtp` כ-`required`, אשר
דוחה שיחות בלעדיו.

קבלו את טווחי האיתות SIP של Talkdesk מ-Talkdesk. כל טווח חייב להיות טווח IPv4
ציבורי של `/16` או מצומצם יותר (IPv6 של `/48` או מצומצם יותר). ראו
[פלטפורמות שמאמתות לפי כתובת IP של המקור](/he/guides/sip-addresses).
Talkdesk שולחת SIP מרשת Twilio, שכתובותיה משותפות לכל לקוחות Twilio,
לכן כתובת נקודת הקצה היא שמונעת ממתקשרים אחרים להיכנס: אל תפרסמו אותה.
שמרו את `sip_uri` מהתגובה, לדוגמה
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

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

בזרימת Studio שלכם, הוסיפו את **התחברות ל-Autopilot קולי** במצב **זרם קול
חיצוני** והגדירו את היעד שלו כ-`sip_uri` של נקודת הקצה עם `;transport=tls` נוסף, לדוגמה
`sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. נקודת הקצה
דוחה שיחות דרך UDP, שבו SIP של Twilio משתמש אלא אם מציינים אחרת.

Talkdesk שולחת:

- `X-Talkdesk-Interaction-Id`, המאוחסן כ-`external_call_id` של השיחה;
- `User-to-User`, מקודד בהקסדצימלי, כגון `business_hours=open`. הוא מגיע אל
  ההנחיה לאחר פענוח, כ-`{{sip_uui}}`.

גרסה 2.1 של הרכיב יכולה גם לשלוח **כותרות מוגדרות**. דף ההעדפות של Talkdesk
מתאר אותן כ-JSON שנשלח דרך WebSocket, לכן ודאו מול Talkdesk אם הן מגיעות
ככותרות SIP לפני שתסתמכו עליהן.

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

הסוכן מסלים באמצעות `REFER` לכתובת ההסלמה של Talkdesk, עם מזהה ההעברה כ-UUI הקסדצימלי בתוך אותה כתובת, המקום היחיד שבו Talkdesk קוראת אותו.
הוסיפו את מספר ההעברה הזה (ראו
[הוספת מספר ההעברה](/he/guides/contact-centers/overview)
ו-[כותרות בתוך כתובת ההעברה](/he/guides/call-transfers)):

```json
{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

הכתובת היא זו שמופיעה במאמר של Talkdesk. גרסה 2.1 של הרכיב
קוראת את `autopilot_result=`; גרסה 1.7 קוראת את `escalate_to=`, לכן השתמשו במפתח זה
בגרסה 1.7. ה-`REFER` נראה כך:

```
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
```

Talkdesk מציבה את הערך במשתנה של Studio. כדי לקבל את הסיכום והכוונה,
הוסיפו שלב **ביצוע פעולה** באינטגרציה מותאמת אישית שנבנתה באמצעות
חיבורים:

- סוג אימות: **מפתח API**, שם הכותרת `Authorization`, ערך
  `Bearer sk_live_…`.
- בקשה: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  ולאחריה המזהה מהמשתנה. תוכלו גם לאתר את השיחה לפי
  `external_call_id` באמצעות מזהה האינטראקציה.
- נווטו לפי `handoff.intent`, והציגו את `handoff.summary` לאדם שמקבל
  את השיחה.

ראו [איתור שיחה שהועברה](/api-reference/calls#look-up-a-handed-off-call).

## בדקו זאת

התחילו שיחה דרך זרימת Studio, בקשו מהסוכן נציג, ובדקו
שהזרימה ממשיכה מעבר לרכיב עם מזהה ההעברה במשתנה שלו. לאחר מכן פתחו את השיחה עם
`GET /v1/calls/{call_id}`:
`external_call_id` צריך להיות מזהה האינטראקציה של Talkdesk.

## מגבלות

- Talkdesk קוראת לכל היותר 256 בתים של UUI ואינה מאפשרת ערכים המופרדים באמצעות
  `|` או `;`, לכן שלחו ערך יחיד. מזהה ההעברה מתאים.
- ממשקי ה-API של Talkdesk אינם יכולים לקרוא את תמליל הסוכן. השתמשו במקום זאת באיתור ההעברה או
  ב-`GET /v1/calls/{call_id}`.
