ThunderPhone v3 כבר באוויר.בשירות עצמי, החל מ-2¢/דקה.קראו את הודעת ההשקה

Contact centers

התחברות מ-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:

  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 ובתגובה הסופית שלו, לכן הסוכן מחזיר את השיחה: הוא נפרד ומנתק, והתסריט שלכם ממשיך שוב עם המתקשר. הוסיפו מספר העברה זה (ראו הוספת מספר ההעברה):

{"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.