Open in
התחברות מ-NICE CXone
העבירו שיחות מ-NICE CXone לסוכן ThunderPhone מסקריפט Studio עם ה-ContactID בכותרת SIP, ואתרו את ההעברה של הסוכן כאשר הסקריפט ממשיך.
תסריט ה-CXone Studio שלכם מציב שיחה לסוכן עם כותרות SIP שנושאות את מזהה איש הקשר וכל הקשר נוסף. כאשר הסוכן מסיים, הוא מנתק, ופעולת REST API בתסריט מאחזרת את נתוני ההעברה.
לפני שתתחילו
- סוכן ThunderPhone ומפתח API של הארגון שלכם.
- קבוצת קווי SIP של CXone שמקבלת כותרות מותאמות אישית. נציג החשבון שלכם ב-NICE צריך להפעיל הגדרה זו לפני ש-CXone שולח אותן.
1. יצירת נקודת הקצה של SIP
Placecall מחייג למספר טלפון דרך קבוצת קווים של CXone, ולא לכתובת SIP.
NICE לא מתעדת אישורי SIP עבורה, ואינטגרציית CXone של ספק AI אחר
משתמשת ב-TLS עם רשימת כתובות IP מורשות. לכן, צרו נקודת קצה מסוג ip_allowlist
עם המספר שהתסריט יחייג אליו כמספר חיוג נכנס (ראו
פלטפורמות שמחייגות למספר טלפון):
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:
- הוסיפו פעולת Sipputheader עם הכותרת
X-Call-IDוהערך שלContactID. CXone לא שולחת כותרת מזהה שיחה משלה; ThunderPhone מאחסן כותרת זו בתורexternal_call_idשל השיחה. - הוסיפו פעולת 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 ובתגובה הסופית שלו, לכן
הסוכן מחזיר את השיחה: הוא נפרד ומנתק, והתסריט שלכם ממשיך שוב עם
המתקשר. הוסיפו מספר העברה זה (ראו
הוספת מספר ההעברה):
{"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מהתגובה כדי לנתב את איש הקשר.
ראו חיפוש שיחה שהועברה.
בדקו
התקשרו למספר שמריץ את התסריט, בקשו מהסוכן נציג, ובדקו שהתסריט ממשיך ושפעולת ה-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.