Open in
התחברות מ-Zoom Contact Center
העבירו שיחות מ-Zoom Contact Center לסוכן ThunderPhone באמצעות מחבר voicebot של צד שלישי, והחזירו אותן לנציג אנושי באמצעות SIP REFER.
וידג'ט Bot בתהליך של Zoom Contact Center שולח את המתקשר לסוכן עם מזהה השיחה של
Zoom. כאשר המתקשר זקוק לאדם, הסוכן שולח REFER של SIP לכתובת הנציג האנושי של
Zoom, והתהליך שלכם מאחזר את ההעברה לפי מזהה השיחה.
לפני שמתחילים
- סוכן ThunderPhone ומפתח API של הארגון שלכם.
- אפליקציה כללית של Zoom Marketplace, המנוהלת על ידי מנהל המערכת שלכם וזמינה עבור Contact Center, עם מחבר עבור ווידג'ט Bot (המדריך של Zoom לבוטים קוליים של צד שלישי).
- קו SIP מ-Zoom לספק הבוט. צוות ה-ISV של Zoom בונה אותו בשלבים (גילוי, קו ביניים, ולאחר מכן ייצור), ושם החברה של האפליקציה חייב להתאים במדויק לרשומת הקו. הגדרה זו מתחילה עם התמיכה של ThunderPhone ו-Zoom, ולא בחשבון Zoom שלכם בלבד.
1. יצירת נקודת הקצה של SIP
המחבר של Zoom מחייג למספר בן 15 ספרות המתחיל ב-999, ולא לכתובת SIP.
שמירת המחבר יוצרת את המספר הזה. הקו של Zoom משתמש ב-TLS 1.2
בפורט 5061 עם SRTP עבור שמע, ומאושר לפי תתי-הרשתות של Zoom במקום באמצעות
סיסמה. לכן, צרו נקודת קצה מסוג ip_allowlist עם מספר המחבר כמספר חיוג נכנס
ועם דרישת SRTP (ראו
פלטפורמות שמחייגות למספר טלפון):
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": "Zoom Contact Center",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["999123456789012"],
"srtp": "required"
}'allowed_source_cidrs: תתי-הרשתות לאיתות SIP של Zoom, המסופקות על ידי Zoom. כל אחת חייבת להיות טווח IPv4 ציבורי של/16או צר יותר (IPv6 של/48או צר יותר).dial_in_numbers: מספר המחבר בדיוק כפי ש-Zoom שולחת אותו, ללא+.srtp:required, מכיוון שהקו של Zoom תמיד משתמש ב-SRTP.
הכתובות של Zoom משותפות לכל לקוחותיה, לכן כל לקוח Zoom אחר שמחייג למספר מגיע לסוכן שלכם. Zoom מקצה את המספר; אל תפרסמו אותו.
2. שליחת שיחות עם הקשר
הוסיפו ווידג'ט Bot לתהליך שלכם וקשרו אותו למחבר. בקשו מצוות ה-ISV
של Zoom להפנות את הקו אל sip.thunderphone.com, עם TLS בפורט 5061,
ועם מספר המחבר גם ב-URI של הבקשה וגם בכותרת To. נקודת הקצה
דוחה UDP, לכן ודאו שהקו אינו חוזר להשתמש בו.
Zoom שולחת:
X-ZOOM-Call-Sid, המאוחסן בתורexternal_call_idשל השיחה. דף מיפוי הנתונים של Zoom עצמה אינו מפרט אותו; שילוב Zoom של ספק AI אחר מתעד אותו, לכן בדקו אותו בשיחת הבדיקה הראשונה שלכם.X-ZOOM-DNIS, המספר שהמתקשר חייג אליו, בתור{{sip_x_zoom_dnis}}.X-ZOOM-WEBHOOK, כתובת ה-URL הסטטית של המחבר.
3. קבלו את השיחה בחזרה
הסוכן שולח REFER לכתובת הנציג האנושי ב-SBC של Zoom. הוסיפו את
מספר ההעברה הזה (ראו
הוספת מספר ההעברה),
עם כתובת ה-SBC ש-Zoom מספקת לכם:
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}המדריך של Zoom מתאר שתי דרכים שבהן בוט מעביר הקשר: POST לכתובת ה-URL
הסטטית של המחבר לפני ה-REFER (אירועי voicebot_metadata ואירועים דומים),
וכותרות SIP שממופות תחת נכנס מהבוט. ThunderPhone לא שולחת בקשות לכתובת
ה-URL הסטטית. המדריך של Zoom לא מציין אם היא קוראת כותרות ממופות מ-REFER;
אם תרצו לנסות, הוסיפו לכניסה headers כגון
"X-Handoff-Id": "{{handoff_id}}" ובדקו זאת בשיחת בדיקה. אשרו גם מול Zoom
שהיא מקבלת REFER ללא POST של מטא-נתונים לפניו.
כדי לקבל את ההעברה בלי להסתמך על אף אחת מהאפשרויות, הגדירו את המערך שלכם כך שיבצע חיפוש אחריה אחרי ווידג'ט הבוט, באמצעות ווידג'ט שיחת HTTP או סקריפט:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ואחריו מזהה השיחה.- כותרת
Authorization: Bearer sk_live_…. - השתמשו ב-
handoff.summaryוב-handoff.intentכדי לנתב את המתקשר ולתדרך את הנציג שמקבל את השיחה.
Zoom לא מפרסמת תיעוד ברמת השדות עבור הווידג'טים האלה, לכן אשרו בחשבון שלכם
שהווידג'ט יכול לשלוח כותרת Authorization. ראו
חיפוש שיחה שהועברה.
בדקו זאת
התקשרו למספר שמגיע לווידג'ט הבוט, בקשו מהסוכן לדבר עם אדם, ובדקו
שהמתקשר מגיע לנציג אנושי ושהווידג'ט מחזיר את ההעברה. לאחר מכן פתחו את השיחה
באמצעות GET /v1/calls/{call_id}: הערך sip_headers אמור לכלול את
x-zoom-call-sid, ו-external_call_id אמור להתאים למזהה השיחה שבו המערך שלכם
משתמש.
מגבלות
- ThunderPhone לא שולחת בקשות לכתובת ה-URL הסטטית של המחבר, לכן Zoom מקבלת את
ההעברה באמצעות החיפוש, או באמצעות כותרות ממופות אם הבדיקה שלכם מראה ש-Zoom
קוראת אותן מה-
REFER. - הטראנק נבנה על ידי צוות ה-ISV של Zoom, לכן אינכם יכולים להגדיר או לבדוק אותו בעצמכם.