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

Contact centers

התחברו מ-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. שליחת שיחות עם הקשר

  1. בחרו מספר טלפון עבור הסוכן ב-SBC שלכם, למשל +14155550188.
  2. ב-SBC, נתקבו שיחות למספר זה אל sip_uri של נקודת הקצה, לדוגמה sip:agent-12-jhxmginwjx@sip.thunderphone.com, באמצעות TLS ביציאה 5061. ThunderPhone מזהה את נקודת הקצה לפי חלק המשתמש (agent-12-jhxmginwjx), שחייב להופיע גם ב-URI של הבקשה וגם בכותרת To. העבירו את כותרות ה-X ללא שינוי.
  3. ב-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, לכן ההעברה חוזרת רק באמצעות החיפוש.