---
title: "התחברות מ-NICE CXone"
description: "העבירו שיחות מ-NICE CXone לסוכן ThunderPhone מסקריפט Studio עם ה-ContactID בכותרת SIP, ואתרו את ההעברה של הסוכן כאשר הסקריפט ממשיך."
---

תסריט ה-CXone Studio שלכם מציב שיחה לסוכן עם כותרות SIP שנושאות את
מזהה איש הקשר וכל הקשר נוסף. כאשר הסוכן מסיים, הוא מנתק, ופעולת REST API
בתסריט מאחזרת את נתוני ההעברה.

## לפני שתתחילו

- סוכן ThunderPhone ומפתח [API](/he/guides/api-keys) של הארגון שלכם.
- קבוצת קווי SIP של CXone שמקבלת כותרות מותאמות אישית. נציג החשבון שלכם ב-NICE
  צריך להפעיל הגדרה זו לפני ש-CXone שולח אותן.

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

Placecall מחייג למספר טלפון דרך קבוצת קווים של CXone, ולא לכתובת SIP.
NICE לא מתעדת אישורי SIP עבורה, ואינטגרציית CXone של ספק AI אחר
משתמשת ב-TLS עם רשימת כתובות IP מורשות. לכן, צרו נקודת קצה מסוג `ip_allowlist`
עם המספר שהתסריט יחייג אליו כמספר חיוג נכנס (ראו
[פלטפורמות שמחייגות למספר טלפון](/he/guides/sip-addresses)):

```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": "NICE CXone",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: טווחי איתות ה-SIP של אשכול ה-CXone שלכם,
  מ-NICE. כל אחד חייב להיות טווח IPv4 ציבורי של `/16` או צר יותר (IPv6 של `/48`
  או צר יותר).
- `dial_in_numbers`: המספר ש-Placecall יחייג אליו, כפי
  ש-CXone שולח אותו. הוא לא חייב להיות מספר טלפון אמיתי. הוא לא יכול כבר
  להיות בשימוש ב-ThunderPhone, כמספר טלפון או בנקודת קצה אחרת: מצב זה
  מחזיר `409`.

הכתובות של CXone משותפות לכל לקוחותיה, לכן כל לקוח CXone אחר
שמחייג למספר מגיע לסוכן שלכם. במקום שבו אתם בוחרים את
המספר, בחרו מספר ארוך שאיש לא ינחש (עד 15 ספרות), ודאו
ש-CXone שולח אותו ל-ThunderPhone במקום אל רשת הטלפוניה, ואל
תפרסמו אותו.

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

בתסריט ה-Studio שלכם, לפני **Placecall**:

1. הוסיפו פעולת **Sipputheader** עם הכותרת `X-Call-ID` והערך של
   `ContactID`. CXone לא שולחת כותרת מזהה שיחה משלה; ThunderPhone מאחסן
   כותרת זו בתור `external_call_id` של השיחה.
2. הוסיפו פעולת **Sipputheader** עבור כל ערך אחר שהסוכן צריך לדעת,
   כגון `X-Skill` שמוגדר ל-`support`. הוא מגיע להנחיה בתור
   `{{sip_x_skill}}`. Sipputheader מקבל `User-to-User`, כל כותרת `X-`, ורוב
   כותרות `P-`; NICE ממליצה על ערכים של 256 תווים או פחות.

לאחר מכן, הפעילו **Placecall** אל המספר הזה, דרך קבוצת קווים ששולחת אותו אל
`sip.thunderphone.com` עם המספר גם ב-URI של הבקשה וגם בכותרת `To`.
נקודת הקצה מקבלת TLS (יציאה 5061) או TCP (יציאה 5060), ומסרבת ל-
UDP, ו-NICE לא מתעדת את התעבורה של קבוצת הקווים, לכן ודאו שהיא אינה
UDP.

## 3. החזרת השיחה

CXone קוראת כותרות SIP רק ב-`INVITE` ובתגובה הסופית שלו, לכן
הסוכן מחזיר את השיחה: הוא נפרד ומנתק, והתסריט שלכם ממשיך שוב עם
המתקשר. הוסיפו מספר העברה זה (ראו
[הוספת מספר ההעברה](/he/guides/contact-centers/overview)):

```json
{"name": "NICE CXone", "action": "return"}
```

NICE לא מתעדת שתסריט ממשיך לאחר Placecall כאשר השיחה שהוצבה
מסתיימת. אינטגרציות CXone של ספקי AI אחרים מאותתות לתסריט דרך
Signal API של CXone (`POST /interactions/{contactId}/signal`) לפני
שהן מנתקות; ThunderPhone לא מבצע קריאה אליה. אשרו עם NICE כיצד התסריט שלכם
מחזיר את המתקשר, ולאחר מכן אחזרו את נתוני ההעברה באמצעות פעולת **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ואחריו `ContactID`.
- כותרת `Authorization: Bearer sk_live_…`.
- קראו את `handoff.summary` ואת `handoff.intent` מהתגובה כדי לנתב את
  איש הקשר.

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

## בדקו

התקשרו למספר שמריץ את התסריט, בקשו מהסוכן נציג, ובדקו שהתסריט ממשיך ושפעולת ה-REST API מחזירה את ההעברה. אם השיחה אינה מגיעה לסוכן, בדקו את המספר ש-CXone שולח, שכתובת המקור שלו נמצאת ב-`allowed_source_cidrs`, ושהשיחה הגיעה באמצעות TCP או TLS. לאחר מכן פתחו את השיחה באמצעות `GET /v1/calls/{call_id}`: `sip_headers` אמור לכלול את `x-call-id`, ו-`external_call_id` אמור להיות שווה ל-`ContactID`.

## מגבלות

- CXone שולח וקורא כותרות רק ב-`INVITE` ובתגובת ה-`2xx` הסופית שלו, לכן שום דבר ב-`BYE` של הסוכן אינו מגיע לתסריט.
- NICE אינה מתעדת תמיכה בקבלת `REFER` מהסוכן.
- פעולת ה-REST API מסתיימת בפסק זמן לאחר 10 שניות כברירת מחדל (ובכל מקרה לפני 90 שניות) וקוראת תגובות בגודל של עד 32 KB.
