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

Contact centers

התחברות מ-Genesys Cloud

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

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

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

  • סוכן ThunderPhone ומפתח API ארגוני.
  • Genesys Cloud עם BYOC Cloud וטראנק חיצוני (מסוג BYOC Carrier או PBX) שבו מופעלות ההגדרות הבאות (הגדרות טראנק חיצוני):
    • כותרות שיחה, כדי ש-Genesys תשלח את מזהה השיחה שלה ב- x-inin-cnv. הגדרה זו כבויה כברירת מחדל.
    • העברת UUI, עם סוג כותרת User-To-User וקידוד הקסדצימלי.
    • לקיחה חזרה והעברה, כדי ש-Genesys תקבל את ה-REFER של הסוכן.

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

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

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 מהתגובה; הוא מוצג פעם אחת בלבד. בטראנק:

הגדרהערך
שרת SIPsip.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 הקסדצימלי בתוך אותה כתובת. הוסיפו מספר העברה זה (ראו הוספת מספר ההעברה ו-כותרות בתוך כתובת ההעברה):

{
  "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 למשתני זרימה.

ראו חיפוש שיחה שהועברה.

בדקו זאת

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

מגבלות

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