---
title: "התחברות מ-Five9"
description: "העבירו שיחות מ-Five9 לסוכן ThunderPhone דרך SIP באמצעות AI Agent Connect, וקבלו אותן בחזרה עם כותרות ניתוב שסקריפט ה-IVR שלכם קורא."
---

סקריפט ה-IVR שלכם ב-Five9 שולח את המתקשר לסוכן עם פרטי השיחה של Five9. כשהסוכן מסיים, הוא מנתק עם כותרות ניתוב ב-`BYE` של SIP, שהסקריפט קורא למשתני שיחה כדי לנתב את המתקשר.

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

- סוכן ThunderPhone ומפתח [API](/he/guides/api-keys) של הארגון.
- התוסף **חיבור סוכן AI** של Five9. Five9 מגבילה אותו לספקי AI שהסמיכה, וצוות ההטמעה של Five9 מגדיר אותו: הוא מייבא את תבנית סקריפט ה-IVR של הספק, יוצר את משתני השיחה ומפנה את מודול **העברה לצד שלישי** של הסקריפט אל הספק. ThunderPhone עדיין אינה ברשימת הספקים המוסמכים של Five9: פנו לצוות החשבון שלכם ב-Five9 או לתמיכת ThunderPhone לפני שתתכננו על בסיס זה.

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

מודול ההעברה לצד שלישי של Five9 מחייג למספר טלפון, ולא לכתובת SIP, ושילובי Five9 של ספקים אחרים מאמתים את Five9 לפי כתובת המקור ולא באמצעות סיסמה. לכן, צרו נקודת קצה מסוג `ip_allowlist` עם המספר ש-Five9 תחייג אליו כמספר חיוג נכנס (ראו
[פלטפורמות שמחייגות למספר טלפון](/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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: טווחי איתות ה-SIP של מרכזי הנתונים שלכם ב-Five9, שאותם תקבלו מ-Five9. כל טווח חייב להיות טווח IPv4 ציבורי של `/16` או צר יותר (IPv6 של `/48` או צר יותר).
- `dial_in_numbers`: המספר שסקריפט Five9 יחייג אליו, כפי ש-Five9 שולחת אותו. הוא לא חייב להיות מספר טלפון אמיתי. הוא לא יכול כבר להיות בשימוש ב-ThunderPhone, כמספר טלפון או בנקודת קצה אחרת: מצב כזה מחזיר `409`.

הכתובות של Five9 משותפות לכל הלקוחות שלה, ולכן כל לקוח אחר של Five9 שמחייג למספר מגיע לסוכן שלכם. במקום שבו אתם בוחרים את המספר, בחרו מספר ארוך שאיש לא ינחש (עד 15 ספרות), ודאו ש-Five9 שולחת אותו ל-ThunderPhone ולא החוצה לרשת הטלפוניה, ואל תפרסמו אותו.

## 2. שליחת שיחות עם הקשר

בקשו מצוות ההטמעה של Five9:

- לשלוח את השיחה ממודול **העברה לצד שלישי** אל
  `sip:+14155550188@sip.thunderphone.com`, עם המספר גם ב-URI של הבקשה וגם בכותרת `To`. המודול מקבל את המספר, עם דומיין ה-SIP של הספק בכותרת.
- לשלוח אותה באמצעות TLS (יציאה 5061) או TCP (יציאה 5060). נקודת הקצה דוחה UDP, ו-Five9 לא מפרסמת באיזו תעבורה היא משתמשת, לכן ודאו שלא מדובר ב-UDP.
- להפעיל את **חזרה לאחר שיחה עם צד שלישי**, כדי שהסקריפט ימשיך כשהסוכן מנתק (Five9 מאפשרת עד 3,600 שניות בשיחה עם צד שלישי).

המדריך של Five9 מפרט את הערכים שהיא שולחת (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` ואחרים), ולא את שמות
הכותרות שלהם. שילובי Five9 של ספקי AI אחרים מתעדים אותם בתעבורה
כ-`X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
ו-`X-AgentID`; בדקו אותם בשיחת הבדיקה הראשונה שלכם. כל אחד מגיע להנחיה כמשתנה, לדוגמה
`{{sip_x_callcampaign}}`. הערך `X-CallID` נשמר בתור
`external_call_id` של השיחה.

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

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

```json
{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
```

- `X-RouteType` ו-`X-RouteValue` מורים לתסריט לאן לשלוח את המתקשר,
  במקרה זה למיומנות התמיכה. ערכים שספקים אחרים מתעדים עבור `X-RouteType` כוללים
  את `SkillTransfer`, `PhoneTransfer`, `Hangup` ו-`DispositionOnly`; תאמו את
  הערכים עם מי שמתחזק את התסריט. עבור כמה יעדים, הוסיפו החזרה אחת
  לכל יעד עם שם שונה ו-`X-RouteValue` שונה.
- `X-RouteReason` כולל את תווית הכוונה של הסוכן, כגון `billing_dispute`.
- `X-CustomMetaData` כולל את מזהה ההעברה. ה-`BYE` כולל אותו גם בתור
  `X-TP-Handoff-Id`, ש-Five9 אינו קורא.

התסריט של Five9 ממפה את ארבע הכותרות למשתני שיחה. כדי לקבל את סיכום
הסוכן, הגדירו את התסריט לקרוא לחיפוש ההעברה באמצעות מודול IVR מסוג **שאילתה**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` ואחריו
`call.call_id`, עם פרופיל הרשאה ששולח
`Authorization: Bearer` ואת מפתח ה-API שלכם. ראו
[חיפוש שיחה שהועברה](/api-reference/calls#look-up-a-handed-off-call).

## בדקו זאת

התקשרו לתסריט ה-IVR, בקשו מהסוכן אדם, ובדקו שהתסריט
מנתב את המתקשר כשמשתני השיחה מלאים. אם השיחה אינה מגיעה לעולם אל
הסוכן, בדקו שהמספר ב-URI של הבקשה ובכותרת `To` תואם למספר החיוג,
שכתובת המקור של Five9 נמצאת ב-`allowed_source_cidrs`, ושהשיחה הגיעה
באמצעות TCP או TLS. לאחר מכן פתחו את השיחה באמצעות
`GET /v1/calls/{call_id}`: ‏`sip_headers` אמור לכלול את `x-callid`, ו-
`external_call_id` אמור להתאים ל-`call.call_id` ב-Five9.

## מגבלות

- המדריך של Five9 מתעד נתוני ניתוב ב-`BYE` ואינו מזכיר
  קבלת `REFER`, לכן ההחזרה היא העברה קרה באמצעות התסריט.
- Five9 קורא את `X-RouteType`, `X-RouteValue`, `X-RouteReason` ו-
  `X-CustomMetaData`, ולא את `User-to-User`. ThunderPhone שולח כל ערך כותרת
  באורך של עד 256 בתים.
- Five9 ממליץ לשמור על כעשר כותרות מותאמות אישית כדי להימנע מפיצול מנות.
