Open in
התחברות מ-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של הסוכן.
- כותרות שיחה, כדי ש-Genesys תשלח את מזהה השיחה שלה ב-
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 מהתגובה; הוא מוצג פעם אחת בלבד. בטראנק:
| הגדרה | ערך |
|---|---|
| שרת SIP | sip.thunderphone.com, יציאה 5061 |
| פרוטוקול | TLS |
| אימות דייג׳סט | ה-username וה-password של נקודת הקצה |
| מקודדים | PCMU, PCMA או G.722 |
הוסיפו את הטראנק לנתיב יוצא באתר שלכם, שתוכנית המספור שלו מכסה את הכתובת שהזרימה מחייגת אליה.
2. שלחו שיחות עם הקשר
בזרימת Architect שלכם:
- לפי הצורך, הוסיפו פעולה הגדרת נתוני UUI עם הקשר עבור הסוכן, כגון
account=12345. Genesys ממליצה על 128 תווים או פחות. - הוסיפו פעולה העברה למספר עם ה-
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 ארוך נחתך כדי להתאים. מזהה העברה תמיד נכנס.