---
title: "התחברות מ-Genesys Cloud"
description: "נתבו שיחות מ-Genesys Cloud לסוכן ThunderPhone דרך trunk של BYOC Cloud עם מזהה השיחה ו-UUI, והחזירו אותן עם ההעברה ב-UUI."
---

זרימת Architect שלכם שולחת את המתקשר לסוכן דרך טראנק BYOC Cloud, עם מזהה השיחה וכל UUI שהגדרתם. כאשר המתקשר זקוק לנציג, הסוכן שולח SIP `REFER`, ‏Genesys מחזירה את השיחה, ומזהה ההעברה מגיע ב-UUI של השיחה.

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

- סוכן ThunderPhone ומפתח [API](/he/guides/api-keys) ארגוני.
- Genesys Cloud עם BYOC Cloud וטראנק חיצוני (מסוג BYOC Carrier או
  PBX) שבו מופעלות ההגדרות הבאות
  ([הגדרות טראנק חיצוני](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **כותרות שיחה**, כדי ש-Genesys תשלח את מזהה השיחה שלה ב-
    `x-inin-cnv`. הגדרה זו כבויה כברירת מחדל.
  - **העברת UUI**, עם סוג כותרת `User-To-User` וקידוד הקסדצימלי.
  - **לקיחה חזרה והעברה**, כדי ש-Genesys תקבל את ה-`REFER` של הסוכן.

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

מכיוון ש-Genesys עונה לאתגר אימות דייג׳סט, השתמשו בנקודת קצה רגילה:

```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": "Genesys Cloud"}'
```

שמרו מיד את ה-`password` מהתגובה; הוא מוצג פעם אחת בלבד. בטראנק:

| הגדרה | ערך |
|---|---|
| שרת SIP | `sip.thunderphone.com`, יציאה `5061` |
| פרוטוקול | TLS |
| אימות דייג׳סט | ה-`username` וה-`password` של נקודת הקצה |
| מקודדים | PCMU, PCMA או G.722 |

הוסיפו את הטראנק לנתיב יוצא באתר שלכם, שתוכנית המספור שלו מכסה את
הכתובת שהזרימה מחייגת אליה.

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

בזרימת Architect שלכם:

1. לפי הצורך, הוסיפו פעולה **הגדרת נתוני UUI** עם הקשר עבור הסוכן, כגון
   `account=12345`. ‏Genesys ממליצה על 128 תווים או פחות.
2. הוסיפו פעולה **העברה למספר** עם ה-`sip_uri` של נקודת הקצה, לדוגמה
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys שולחת את מזהה השיחה ב-`x-inin-cnv`. ‏ThunderPhone שומרת אותו בתור
ה-`external_call_id` של השיחה. ה-UUI מגיע להנחיה לאחר פענוח, בתור
`{{sip_uui}}`.

כותרות מותאמות אישית של הטראנק הן סטטיות ב-Genesys, לכן הציבו ערכים לכל
שיחה ב-UUI. ‏Genesys שומרת לעצמה את קידומות הכותרות `x-inin`, ‏`x-genesys`,
`x-pcv` ו-`x-gcv`.

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

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

```json
{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

החליפו את הכתובת בכתובת שמנתבת חזרה לתור או לזרימה שאמורים לקבל את
המתקשר; ודאו את המבנה שלה מול Genesys. ה-`REFER` נראה כך:

```
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
```

כאשר **לקיחה חזרה והעברה** מופעלת, Genesys מחזירה את השיחה מהטראנק
ומנתבת אותה לכתובת זו. ‏Genesys מתעדת שנתוני UUI נכנסים מגיעים אל
`Call.UUIData`; היא אינה מתעדת זאת עבור לקיחה חזרה, לכן ודאו מול Genesys,
או בשיחת בדיקה, שהזרימה שמקבלת את המתקשר מאתרת שם את מזהה ההעברה. כדי לקבל
את הסיכום והכוונה, בצעו חיפוש אחר נתוני ההעברה באמצעות **פעולת נתונים של שיחה**
באינטגרציית פעולות נתונים של שירותי אינטרנט:

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

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

## בדקו זאת

התקשרו למספר שמגיע לזרימה, בקשו מהסוכן לדבר עם אדם, ובדקו ש-
Genesys מעביר את השיחה לכתובת שהגדרתם. בזרימה הזו, בדקו ש-
`Call.UUIData` מכיל את מזהה ההעברה כטקסט (אם מוצגות ספרות הקסדצימליות, בדקו שקידוד ה-UUI של ה-trunk הוא Hex). לאחר מכן פתחו את השיחה באמצעות `GET /v1/calls/{call_id}`:
`external_call_id` אמור להיות מזהה השיחה.

## מגבלות

- הפעולה **קבלת כותרות SIP** קוראת רק את ה-`INVITE` הראשוני, ולכן היא לא יכולה
  לקרוא דבר מה-`REFER` של הסוכן. ההעברה מגיעה ל-Genesys רק
  באמצעות UUI.
- Genesys משמיטה את כל נתוני ה-UUI כאשר שיחה כוללת יותר מכותרת UUI אחת.
- כתובת ההעברה מוגבלת ל-254 תווים, ולכן UUI ארוך נחתך כדי להתאים.
  מזהה העברה תמיד נכנס.
