---
title: "התחברות מ-Zoom Contact Center"
description: "העבירו שיחות מ-Zoom Contact Center לסוכן ThunderPhone באמצעות מחבר voicebot של צד שלישי, והחזירו אותן לנציג אנושי באמצעות SIP REFER."
---

וידג'ט Bot בתהליך של Zoom Contact Center שולח את המתקשר לסוכן עם מזהה השיחה של
Zoom. כאשר המתקשר זקוק לאדם, הסוכן שולח `REFER` של SIP לכתובת הנציג האנושי של
Zoom, והתהליך שלכם מאחזר את ההעברה לפי מזהה השיחה.

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

- סוכן ThunderPhone ומפתח [API](/he/guides/api-keys) של הארגון שלכם.
- **אפליקציה כללית** של Zoom Marketplace, המנוהלת על ידי מנהל המערכת שלכם וזמינה
  עבור Contact Center, עם מחבר עבור ווידג'ט Bot
  ([המדריך של Zoom לבוטים קוליים של צד שלישי](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- קו SIP מ-Zoom לספק הבוט. צוות ה-ISV של Zoom בונה אותו בשלבים
  (גילוי, קו ביניים, ולאחר מכן ייצור), ושם החברה של האפליקציה חייב להתאים
  במדויק לרשומת הקו. הגדרה זו מתחילה עם התמיכה של ThunderPhone ו-Zoom,
  ולא בחשבון Zoom שלכם בלבד.

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

המחבר של Zoom מחייג למספר בן 15 ספרות המתחיל ב-`999`, ולא לכתובת SIP.
שמירת המחבר יוצרת את המספר הזה. הקו של Zoom משתמש ב-TLS 1.2
בפורט 5061 עם SRTP עבור שמע, ומאושר לפי תתי-הרשתות של Zoom במקום באמצעות
סיסמה. לכן, צרו נקודת קצה מסוג `ip_allowlist` עם מספר המחבר כמספר חיוג נכנס
ועם דרישת SRTP (ראו
[פלטפורמות שמחייגות למספר טלפון](/he/guides/sip-addresses)):

```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": "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. הוסיפו את
מספר ההעברה הזה (ראו
[הוספת מספר ההעברה](/he/guides/contact-centers/overview)),
עם כתובת ה-SBC ש-Zoom מספקת לכם:

```json
{"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`. ראו
[חיפוש שיחה שהועברה](/api-reference/calls#look-up-a-handed-off-call).

## בדקו זאת

התקשרו למספר שמגיע לווידג'ט הבוט, בקשו מהסוכן לדבר עם אדם, ובדקו
שהמתקשר מגיע לנציג אנושי ושהווידג'ט מחזיר את ההעברה. לאחר מכן פתחו את השיחה
באמצעות `GET /v1/calls/{call_id}`: הערך `sip_headers` אמור לכלול את
`x-zoom-call-sid`, ו-`external_call_id` אמור להתאים למזהה השיחה שבו המערך שלכם
משתמש.

## מגבלות

- ThunderPhone לא שולחת בקשות לכתובת ה-URL הסטטית של המחבר, לכן Zoom מקבלת את
  ההעברה באמצעות החיפוש, או באמצעות כותרות ממופות אם הבדיקה שלכם מראה ש-Zoom
  קוראת אותן מה-`REFER`.
- הטראנק נבנה על ידי צוות ה-ISV של Zoom, לכן אינכם יכולים להגדיר או לבדוק אותו
  בעצמכם.
