---
title: "התחברו מ-Microsoft Dynamics 365"
description: "העבירו שיחות מ-Dynamics 365 Contact Center ומ-Copilot Studio לסוכן ThunderPhone דרך ה-SBC שלכם עם כותרות X, וחפשו את ההעברה של הסוכן דרך HTTP."
---

Dynamics 365 Contact Center שולח את המתקשר לסוכן דרך בקר גבול השיחה (SBC) שלכם, עם עד חמש כותרות X הכוללות את מזהה השיחה. כאשר הסוכן מסיים, הוא מנתק, ה-SBC שלכם מחזיר את המתקשר אל Dynamics 365, וצומת בקשת HTTP מאחזר את ההעברה.

## לפני שמתחילים

- סוכן ThunderPhone ומפתח [API](/he/guides/api-keys) של הארגון.
- ערוץ הקול של Dynamics 365 Contact Center, המחובר דרך **ניתוב ישיר** של Azure Communication Services אל SBC שאתם מפעילים
  ([דרישות SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  SBC נתמך עם אישור ציבורי, TLS 1.2 ביציאה 5061 ו-SRTP לכיוון Microsoft.
- **תמיכה בכותרות SIP X** בצומת **העברת שיחה**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  ודאו שהיא זמינה בסביבה שלכם.

Dynamics 365 מעביר שיחות רק למספר טלפון, ו-Microsoft מאמתת את ניתוב ישיר באמצעות אישור ולא באמצעות סיסמה. ה-SBC שלכם ממוקם בין Microsoft ל-ThunderPhone וממיר את המספר הזה לכתובת ה-SIP של הסוכן.

## 1. יצירת נקודת הקצה של SIP

השיחה מגיעה ל-ThunderPhone מה-SBC שלכם, לכן צרו נקודת קצה רגילה לשימוש ה-SBC:

```bash
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 של המקור](/he/guides/sip-addresses).

## 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` ישמור על שמו
([הקשר מותאם אישית](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. החזירו את השיחה

הסוכן מחזיר את השיחה: הוא נפרד ומנתק. הוסיפו את מספר ההעברה הזה (ראו
[הוספת מספר ההעברה](/he/guides/contact-centers/overview)):

```json
{"name": "Dynamics 365", "action": "return"}
```

החזרת המתקשר אל Dynamics 365 היא תפקידו של ה-SBC שלכם. Microsoft
מתעדת דרך אחת לכניסה לשיחה עם הקשר: שיחה חדשה דרך ה-SBC למספר הרשום ב-Dynamics 365, עם UUI שהמפתחות שלו תואמים למשתני ההקשר
שהגדרתם תחת **זרמי עבודה → הגדרות מתקדמות**
([העברת IVR של צד שלישי](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-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`.

ראו [חיפוש שיחה שהועברה](/api-reference/calls#look-up-a-handed-off-call).

## בדקו זאת

התקשרו למספר 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`, לכן ההעברה חוזרת רק באמצעות
  החיפוש.
