Open in
התחברו מ-Microsoft Dynamics 365
העבירו שיחות מ-Dynamics 365 Contact Center ומ-Copilot Studio לסוכן ThunderPhone דרך ה-SBC שלכם עם כותרות X, וחפשו את ההעברה של הסוכן דרך HTTP.
Dynamics 365 Contact Center שולח את המתקשר לסוכן דרך בקר גבול השיחה (SBC) שלכם, עם עד חמש כותרות X הכוללות את מזהה השיחה. כאשר הסוכן מסיים, הוא מנתק, ה-SBC שלכם מחזיר את המתקשר אל Dynamics 365, וצומת בקשת HTTP מאחזר את ההעברה.
לפני שמתחילים
- סוכן ThunderPhone ומפתח API של הארגון.
- ערוץ הקול של Dynamics 365 Contact Center, המחובר דרך ניתוב ישיר של Azure Communication Services אל SBC שאתם מפעילים (דרישות SBC): SBC נתמך עם אישור ציבורי, TLS 1.2 ביציאה 5061 ו-SRTP לכיוון Microsoft.
- תמיכה בכותרות SIP X בצומת העברת שיחה (Copilot Studio). ודאו שהיא זמינה בסביבה שלכם.
Dynamics 365 מעביר שיחות רק למספר טלפון, ו-Microsoft מאמתת את ניתוב ישיר באמצעות אישור ולא באמצעות סיסמה. ה-SBC שלכם ממוקם בין Microsoft ל-ThunderPhone וממיר את המספר הזה לכתובת ה-SIP של הסוכן.
1. יצירת נקודת הקצה של SIP
השיחה מגיעה ל-ThunderPhone מה-SBC שלכם, לכן צרו נקודת קצה רגילה לשימוש ה-SBC:
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": "Dynamics 365 SBC"}'שמרו מיד את password מהתגובה; הוא מוצג פעם אחת, וה-SBC שלכם עונה באמצעותו לאתגר של ThunderPhone. אם ה-SBC שלכם אינו תומך באימות Digest, צרו במקום זאת את נקודת הקצה כאשר auth מוגדר ל-ip_allowlist ועם הכתובת הציבורית של ה-SBC שלכם; ראו
פלטפורמות שמאמתות לפי כתובת IP של המקור.
2. שליחת שיחות עם הקשר
- בחרו מספר טלפון עבור הסוכן ב-SBC שלכם, למשל
+14155550188. - ב-SBC, נתקבו שיחות למספר זה אל
sip_uriשל נקודת הקצה, לדוגמהsip:agent-12-jhxmginwjx@sip.thunderphone.com, באמצעות TLS ביציאה5061. ThunderPhone מזהה את נקודת הקצה לפי חלק המשתמש (agent-12-jhxmginwjx), שחייב להופיע גם ב-URI של הבקשה וגם בכותרתTo. העבירו את כותרות ה-X ללא שינוי. - ב-Copilot Studio, הוסיפו צומת העברת שיחה עם
העברת מספר טלפון חיצוני למספר זה, והוסיפו את כותרות ה-X:
X-Call-ID: מזהה השיחה של Dynamics 365. אף כותרת של Microsoft אינה כוללת אותו, לכן הוסיפו אותו כאן; ThunderPhone שומר אותו בתורexternal_call_idשל השיחה. ודאו ב-Copilot Studio איזה משתנה מחזיק את מזהה השיחה.- עד ארבע כותרות נוספות, כגון
X-Customer-Tier.
Microsoft שולחת לכל היותר חמש כותרות X, עם שמות באורך של עד 64 תווים וערכים באורך של עד 256 תווים, באמצעות אותיות, ספרות ו-= ; . ! % * _ + ~ -. היא כותבת את הקידומת באותיות קטנות בתור x-; ThunderPhone מתאים שמות כותרות ללא תלות באותיות רישיות או קטנות, לכן x-customer-tier מגיע להנחיה בתור {{sip_x_customer_tier}}.
אם אתם בונים את השיחה באמצעות Azure Communication Services Call Automation במקום זאת, AddSipX כותב כברירת מחדל שמות מסוג X-MS-Custom-. העבירו את
SipHeaderPrefix.X כדי ש-X-Call-ID ישמור על שמו
(הקשר מותאם אישית).
3. החזירו את השיחה
הסוכן מחזיר את השיחה: הוא נפרד ומנתק. הוסיפו את מספר ההעברה הזה (ראו הוספת מספר ההעברה):
{"name": "Dynamics 365", "action": "return"}החזרת המתקשר אל Dynamics 365 היא תפקידו של ה-SBC שלכם. Microsoft
מתעדת דרך אחת לכניסה לשיחה עם הקשר: שיחה חדשה דרך ה-SBC למספר הרשום ב-Dynamics 365, עם UUI שהמפתחות שלו תואמים למשתני ההקשר
שהגדרתם תחת זרמי עבודה → הגדרות מתקדמות
(העברת IVR של צד שלישי).
תאמו עם ספק ה-SBC שלכם כיצד המתקשר מגיע למספר הזה כאשר
ThunderPhone מנתק, והעבירו את מזהה השיחה ששלחתם ב-X-Call-ID
כדי שהתהליך יוכל למצוא את השיחה.
לאחר מכן, אחזרו את ההעברה באמצעות צומת בקשת HTTP ב-Copilot Studio:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ואחריו מזהה השיחה.- כותרת
Authorization: Bearer sk_live_…. - פענחו את התגובה אל תוך משתנה והשתמשו ב-
handoff.summaryוב-handoff.intent.
ראו חיפוש שיחה שהועברה.
בדקו זאת
התקשרו למספר Dynamics 365 שמגיע לצומת ההעברה, בקשו מהסוכן נציג,
ובדקו שהמתקשר חוזר אל Dynamics 365. לאחר מכן פתחו את השיחה באמצעות
GET /v1/calls/{call_id}: sip_headers אמור לכלול את x-call-id, ו-
external_call_id אמור להיות מזהה השיחה. אם השיחה לעולם אינה מגיעה אל
הסוכן ויומני ה-SBC שלכם מציגים SIP 404, כתובת ה-URI של הבקשה או כותרת
To שלה אינם כוללים את חלק המשתמש של נקודת הקצה.
מגבלות
- נדרש SBC. Microsoft אינה יכולה לחייג לכתובת SIP או להשיב לאתגר Digest.
- Microsoft שולחת לכל היותר חמש כותרות X, ושומרת רק את חמש הראשונות בשיחה נכנסת. Dynamics 365 מקבלת לכל היותר 128 תווים של UUI.
- Microsoft אינה מתעדת קריאת כותרות ב-
BYE, לכן ההעברה חוזרת רק באמצעות החיפוש.