---
title: "Five9 वरून कनेक्ट करा"
description: "AI Agent Connect वापरून Five9 कॉल SIP द्वारे ThunderPhone एजंटकडे पाठवा आणि तुमची IVR स्क्रिप्ट वाचत असलेल्या राउटिंग हेडर्ससह ते परत मिळवा."
---

तुमची Five9 IVR स्क्रिप्ट Five9 च्या कॉल तपशीलांसह कॉलरला एजंटकडे पाठवते. एजंटचे काम पूर्ण झाल्यावर, तो SIP `BYE` वर रूटिंग हेडर्ससह कॉल समाप्त करतो; स्क्रिप्ट कॉलरचे रूटिंग करण्यासाठी ते कॉल व्हेरिएबल्समध्ये वाचते.

## सुरू करण्यापूर्वी

- ThunderPhone एजंट आणि संस्थेची [API की](/mr/guides/api-keys).
- Five9 चे **AI Agent Connect** अॅड-ऑन. Five9 हे फक्त त्याने मान्यताप्राप्त केलेल्या AI प्रदात्यांपुरते मर्यादित ठेवते आणि Five9 ची अंमलबजावणी टीम ते सेट करते: ती प्रदात्याची IVR स्क्रिप्ट टेम्पलेट आयात करते, कॉल व्हेरिएबल्स तयार करते आणि स्क्रिप्टचे **तृतीय-पक्ष ट्रान्सफर** मॉड्यूल प्रदात्याकडे निर्देशित करते. ThunderPhone अजून Five9 च्या मान्यताप्राप्त यादीत नाही: यावर आधारित योजना करण्यापूर्वी तुमच्या Five9 खाते टीमला किंवा ThunderPhone सपोर्टला विचारा.

## 1. SIP एंडपॉइंट तयार करा

Five9 चे तृतीय-पक्ष ट्रान्सफर मॉड्यूल SIP पत्त्याला नव्हे, तर फोन नंबरला डायल करते आणि इतर प्रदात्यांची Five9 एकत्रीकरणे पासवर्डऐवजी स्त्रोत पत्त्याद्वारे Five9 चे प्रमाणीकरण करतात. त्यामुळे Five9 डायल करेल तो नंबर डायल-इन नंबर म्हणून वापरून `ip_allowlist` एंडपॉइंट तयार करा (पाहा
[फोन नंबर डायल करणारे प्लॅटफॉर्म](/mr/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`: Five9 कडून मिळणाऱ्या तुमच्या Five9 डेटा सेंटरच्या SIP सिग्नलिंग श्रेणी. प्रत्येक सार्वजनिक 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` आणि इतर) सूचीबद्ध आहेत, त्यांची
हेडर नावे नाहीत. इतर AI प्रदात्यांची Five9 एकत्रीकरणे नेटवर्कवर त्यांना
`X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
आणि `X-AgentID` म्हणून दस्तऐवजीकरण करतात; तुमच्या पहिल्या चाचणी कॉलवर ते तपासा. प्रत्येक prompt मध्ये व्हेरिएबल म्हणून पोहोचते, उदाहरणार्थ
`{{sip_x_callcampaign}}`. `X-CallID` कॉलचे
`external_call_id` म्हणून साठवले जाते.

## 3. कॉल परत मिळवा

एजंट कॉल परत करतो: तो निरोप देतो आणि कॉल समाप्त करतो, आणि `BYE` मध्ये Five9 ची स्क्रिप्ट वाचत असलेले
चार हेडर्स असतात. हा हस्तांतरण क्रमांक जोडा (पहा
[हस्तांतरण क्रमांक जोडा](/mr/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` स्क्रिप्टला कॉलरला कुठे पाठवायचे ते सांगतात,
  येथे Support स्किलकडे. इतर प्रदाते `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 की पाठवणाऱ्या
Authorization प्रोफाइलसह. पहा
[हँड-ऑफ केलेला कॉल शोधा](/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` Five9 मधील `call.call_id` शी जुळला पाहिजे.

## मर्यादा

- Five9 च्या मार्गदर्शिकेत `BYE` वर रूटिंग डेटा दस्तऐवजीकृत आहे आणि
  `REFER` स्वीकारण्याचा उल्लेख नाही, त्यामुळे कॉल परत देणे हे स्क्रिप्टद्वारे केलेले कोल्ड ट्रान्सफर आहे.
- Five9 `User-to-User` नव्हे तर `X-RouteType`, `X-RouteValue`, `X-RouteReason` आणि
  `X-CustomMetaData` वाचते. ThunderPhone प्रत्येक हेडर मूल्य जास्तीत जास्त 256 बाइट्स लांबीचे पाठवते.
- पॅकेट फ्रॅगमेंटेशन टाळण्यासाठी Five9 सानुकूल हेडर्सची संख्या सुमारे दहापर्यंत ठेवण्याची शिफारस करते.
