Open in
התחברות מ-Five9
העבירו שיחות מ-Five9 לסוכן ThunderPhone דרך SIP באמצעות AI Agent Connect, וקבלו אותן בחזרה עם כותרות ניתוב שסקריפט ה-IVR שלכם קורא.
סקריפט ה-IVR שלכם ב-Five9 שולח את המתקשר לסוכן עם פרטי השיחה של Five9. כשהסוכן מסיים, הוא מנתק עם כותרות ניתוב ב-BYE של SIP, שהסקריפט קורא למשתני שיחה כדי לנתב את המתקשר.
לפני שמתחילים
- סוכן ThunderPhone ומפתח API של הארגון.
- התוסף חיבור סוכן AI של Five9. Five9 מגבילה אותו לספקי AI שהסמיכה, וצוות ההטמעה של Five9 מגדיר אותו: הוא מייבא את תבנית סקריפט ה-IVR של הספק, יוצר את משתני השיחה ומפנה את מודול העברה לצד שלישי של הסקריפט אל הספק. ThunderPhone עדיין אינה ברשימת הספקים המוסמכים של Five9: פנו לצוות החשבון שלכם ב-Five9 או לתמיכת ThunderPhone לפני שתתכננו על בסיס זה.
1. יצירת נקודת הקצה של SIP
מודול ההעברה לצד שלישי של Five9 מחייג למספר טלפון, ולא לכתובת SIP, ושילובי Five9 של ספקים אחרים מאמתים את Five9 לפי כתובת המקור ולא באמצעות סיסמה. לכן, צרו נקודת קצה מסוג ip_allowlist עם המספר ש-Five9 תחייג אליו כמספר חיוג נכנס (ראו
פלטפורמות שמחייגות למספר טלפון):
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": "Five9",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: טווחי איתות ה-SIP של מרכזי הנתונים שלכם ב-Five9, שאותם תקבלו מ-Five9. כל טווח חייב להיות טווח IPv4 ציבורי של/16או צר יותר (IPv6 של/48או צר יותר).dial_in_numbers: המספר שסקריפט Five9 יחייג אליו, כפי ש-Five9 שולחת אותו. הוא לא חייב להיות מספר טלפון אמיתי. הוא לא יכול כבר להיות בשימוש ב-ThunderPhone, כמספר טלפון או בנקודת קצה אחרת: מצב כזה מחזיר409.
הכתובות של Five9 משותפות לכל הלקוחות שלה, ולכן כל לקוח אחר של Five9 שמחייג למספר מגיע לסוכן שלכם. במקום שבו אתם בוחרים את המספר, בחרו מספר ארוך שאיש לא ינחש (עד 15 ספרות), ודאו ש-Five9 שולחת אותו ל-ThunderPhone ולא החוצה לרשת הטלפוניה, ואל תפרסמו אותו.
2. שליחת שיחות עם הקשר
בקשו מצוות ההטמעה של Five9:
- לשלוח את השיחה ממודול העברה לצד שלישי אל
sip:+14155550188@sip.thunderphone.com, עם המספר גם ב-URI של הבקשה וגם בכותרתTo. המודול מקבל את המספר, עם דומיין ה-SIP של הספק בכותרת. - לשלוח אותה באמצעות TLS (יציאה 5061) או TCP (יציאה 5060). נקודת הקצה דוחה UDP, ו-Five9 לא מפרסמת באיזו תעבורה היא משתמשת, לכן ודאו שלא מדובר ב-UDP.
- להפעיל את חזרה לאחר שיחה עם צד שלישי, כדי שהסקריפט ימשיך כשהסוכן מנתק (Five9 מאפשרת עד 3,600 שניות בשיחה עם צד שלישי).
המדריך של Five9 מפרט את הערכים שהיא שולחת (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name ואחרים), ולא את שמות
הכותרות שלהם. שילובי Five9 של ספקי AI אחרים מתעדים אותם בתעבורה
כ-X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign
ו-X-AgentID; בדקו אותם בשיחת הבדיקה הראשונה שלכם. כל אחד מגיע להנחיה כמשתנה, לדוגמה
{{sip_x_callcampaign}}. הערך X-CallID נשמר בתור
external_call_id של השיחה.
3. החזירו את השיחה
הסוכן מחזיר את השיחה: הוא נפרד ומנתק, וה-BYE כולל את ארבע הכותרות
שתסריט Five9 קורא. הוסיפו את מספר ההעברה הזה (ראו
הוספת מספר ההעברה):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeו-X-RouteValueמורים לתסריט לאן לשלוח את המתקשר, במקרה זה למיומנות התמיכה. ערכים שספקים אחרים מתעדים עבורX-RouteTypeכוללים אתSkillTransfer,PhoneTransfer,Hangupו-DispositionOnly; תאמו את הערכים עם מי שמתחזק את התסריט. עבור כמה יעדים, הוסיפו החזרה אחת לכל יעד עם שם שונה ו-X-RouteValueשונה.X-RouteReasonכולל את תווית הכוונה של הסוכן, כגוןbilling_dispute.X-CustomMetaDataכולל את מזהה ההעברה. ה-BYEכולל אותו גם בתורX-TP-Handoff-Id, ש-Five9 אינו קורא.
התסריט של Five9 ממפה את ארבע הכותרות למשתני שיחה. כדי לקבל את סיכום
הסוכן, הגדירו את התסריט לקרוא לחיפוש ההעברה באמצעות מודול IVR מסוג שאילתה:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ואחריו
call.call_id, עם פרופיל הרשאה ששולח
Authorization: Bearer ואת מפתח ה-API שלכם. ראו
חיפוש שיחה שהועברה.
בדקו זאת
התקשרו לתסריט ה-IVR, בקשו מהסוכן אדם, ובדקו שהתסריט
מנתב את המתקשר כשמשתני השיחה מלאים. אם השיחה אינה מגיעה לעולם אל
הסוכן, בדקו שהמספר ב-URI של הבקשה ובכותרת To תואם למספר החיוג,
שכתובת המקור של Five9 נמצאת ב-allowed_source_cidrs, ושהשיחה הגיעה
באמצעות TCP או TLS. לאחר מכן פתחו את השיחה באמצעות
GET /v1/calls/{call_id}: sip_headers אמור לכלול את x-callid, ו-
external_call_id אמור להתאים ל-call.call_id ב-Five9.
מגבלות
- המדריך של Five9 מתעד נתוני ניתוב ב-
BYEואינו מזכיר קבלתREFER, לכן ההחזרה היא העברה קרה באמצעות התסריט. - Five9 קורא את
X-RouteType,X-RouteValue,X-RouteReasonו-X-CustomMetaData, ולא אתUser-to-User. ThunderPhone שולח כל ערך כותרת באורך של עד 256 בתים. - Five9 ממליץ לשמור על כעשר כותרות מותאמות אישית כדי להימנע מפיצול מנות.