> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Five9

> **Note**
>
> इस गाइड को अपनाने से पहले, यह समझने के लिए कि ElevenLabs SIP
> ट्रंक्स और कस्टम SIP हेडर्स को कैसे सपोर्ट करता है, [SIP ट्रंकिंग गाइड](/docs/hi/eleven-agents/phone-numbers/sip-trunking) पढ़ें।

## परिचय

यह गाइड बताती है कि Five9 AI Agent Connect का इस्तेमाल करके ElevenAgents को Five9 Virtual Contact Center (VCC) के साथ कैसे इंटीग्रेट करें। Five9 एक लाइव कॉल को ElevenLabs फ़ोन नंबर पर ट्रांसफ़र करता है, ElevenLabs एजेंट बातचीत संभालता है, और ElevenLabs रूटिंग या डिस्पोज़िशन डेटा वापस Five9 को भेजता है, ताकि Five9 फ़्लो जारी रह सके।

## Five9 इंटीग्रेशन कैसे काम करता है

Five9 AI Agent Connect, SIP के ज़रिए बाहरी ट्रांसफ़र का इस्तेमाल करता है। कॉल कॉन्टेक्स्ट दोनों दिशाओं में कस्टम SIP `X-` हेडर्स से एक्सचेंज होता है:

1. **इनबाउंड ट्रांसफ़र**: Five9 IVR External Transfer Module, INVITE पर SIP `X-` हेडर्स के रूप में कॉल कॉन्टेक्स्ट भेजते हुए कॉल को ElevenLabs फ़ोन नंबर पर ट्रांसफ़र करता है।
2. **बातचीत**: ElevenLabs कॉल का जवाब देता है और उसे सही एजेंट तक रूट करता है, ज़रूरत पड़ने पर राउटर एजेंट के माध्यम से, फिर कॉलर के साथ बातचीत संभालता है।
3. **वापसी पथ**: बातचीत समाप्त होने पर, ElevenLabs SIP BYE में रूटिंग और डिस्पोज़िशन डेटा को `X-` हेडर्स के रूप में जोड़ता है।
4. **AI के बाद रूटिंग**: Five9 लौटाए गए हेडर्स को कॉल वेरिएबल्स में मैप करता है और कॉल फ़्लो जारी रखता है, जैसे लाइव एजेंट को ट्रांसफ़र करना, कॉल समाप्त करना या डिस्पोज़िशन रिकॉर्ड करना।

## आवश्यकताएं

Five9 इंटीग्रेशन सेट अप करने से पहले, सुनिश्चित करें कि आपके पास ये चीज़ें हैं:

1. AI Agent Connect सक्षम वाला एक सक्रिय Five9 VCC डोमेन।
2. Five9 कॉन्फ़िगरेशन का एडमिनिस्ट्रेटर एक्सेस, या बदलाव करने के लिए Five9 इम्प्लीमेंटेशन टीम।
3. ट्रांसफ़र की गई कॉल संभालने के लिए एक ElevenLabs अकाउंट और एक [एजेंट](/docs/hi/eleven-agents/quickstart)।
4. Five9 ट्रांसफ़र डेस्टिनेशन के रूप में इस्तेमाल करने के लिए ElevenLabs में इंपोर्ट किया गया एक [SIP ट्रंक फ़ोन नंबर](/docs/hi/eleven-agents/phone-numbers/sip-trunking)।

> **Note**
>
> AI Agent Connect, Five9 VCC का एक पेड ऐड-ऑन है और डिफ़ॉल्ट रूप से सक्षम नहीं होता। यह इंटीग्रेशन
> शुरू करने से पहले अपने डोमेन के लिए इसे सक्षम कराने हेतु अपने Five9 Account Manager से संपर्क करें।

> **Note**
>
> कॉन्फ़िगरेशन शुरू होने से पहले, दोनों टीमों को ट्रांसफ़र फ़ोन नंबर, हर दिशा में भेजे जाने वाले हेडर नामों,
> रूटिंग वैल्यूज़ और टेस्ट प्लान पर सहमति बनानी चाहिए।

## ElevenLabs सेटअप

#### ट्रांसफ़र फ़ोन नंबर इंपोर्ट करें

जिस फ़ोन नंबर पर Five9 कॉल ट्रांसफ़र करेगा उसे इंपोर्ट करने के लिए [SIP ट्रंकिंग गाइड](/docs/hi/eleven-agents/phone-numbers/sip-trunking) का पालन करें। कस्टम SIP हेडर्स और BYE हेडर्स के लिए SIP ट्रंक फ़ोन नंबर आवश्यक है।

नंबर को `+1` कंट्री कोड के साथ E.164 फ़ॉर्मेट में इंपोर्ट करें (उदाहरण के लिए, `+18005550100`)। Five9 ट्रांसफ़र इसी फ़ॉर्मेट में भेजता है, और फ़ॉर्मेट मेल न खाने पर ट्रांसफ़र विफल हो जाएगा।

#### एजेंट असाइन करें

अगर Five9 से आने वाली सभी कॉल एक ही एजेंट संभालता है, तो उसे [फ़ोन नंबर डैशबोर्ड](https://elevenlabs.io/app/agents/phone-numbers) में सीधे फ़ोन नंबर पर असाइन करें।

अगर कई एजेंट एक ही ट्रांसफ़र नंबर इस्तेमाल करते हैं, तो इसके बजाय एक राउटर एजेंट असाइन करें और [एक नंबर से कई एजेंट रूट करना](#routing-multiple-agents-through-one-number) का पालन करें।

#### लौटाए जाने वाले हेडर्स कॉन्फ़िगर करें

बातचीत के दौरान आपका एजेंट जिन डायनामिक वेरिएबल्स को सेट करता है, उन्हें Five9 द्वारा अपेक्षित SIP BYE हेडर नामों से मैप करें। [BYE हेडर्स कॉन्फ़िगर करना](#configuring-bye-headers) देखें।

#### टेस्ट कॉल चलाएं

Five9 के साथ टेस्ट कॉल करें और पुष्टि करें कि इनबाउंड हेडर्स डायनामिक वेरिएबल्स के रूप में आ रहे हैं और BYE हेडर्स उम्मीद के मुताबिक लौटाए जा रहे हैं। इनबाउंड हेडर वैल्यू बातचीत इतिहास में **Phone Call** टैब के अंतर्गत दिखती हैं।

## एक नंबर से कई एजेंट रूट करना

एक ही Five9 ट्रांसफ़र नंबर के ज़रिए कई ElevenLabs एजेंटों तक कॉल रूट करने के लिए, फ़ोन नंबर पर एक **राउटर एजेंट** असाइन करें और Five9 से `X-AgentID` जैसे हेडर में टारगेट एजेंट भेजने को कहें।

इनबाउंड `X-` हेडर्स [डायनामिक वेरिएबल्स](/docs/hi/eleven-agents/customization/personalization/dynamic-variables) के रूप में उपलब्ध होते हैं, इसलिए राउटर एजेंट के लिए `X-AgentID`, `{{sip_agentid}}` के रूप में उपलब्ध होता है। राउटर एजेंट को [एजेंट ट्रांसफ़र](/docs/hi/eleven-agents/customization/tools/system-tools/agent-transfer) टूल के साथ कॉन्फ़िगर करें और हर अपेक्षित `X-AgentID` वैल्यू के लिए एक ट्रांसफ़र नियम जोड़ें, उसे उस एजेंट से मैप करते हुए जिसे कॉल संभालनी चाहिए।

इससे हर एजेंट के लिए अलग फ़ोन नंबर प्रोविज़न करने की ज़रूरत नहीं पड़ती।

## Five9 से ElevenLabs को भेजे गए हेडर्स

Five9, INVITE पर SIP `X-` हेडर्स के रूप में कॉल मेटाडेटा भेज सकता है। हेडर नामों को `X-` प्रीफ़िक्स हटाकर, लोअरकेस में बदलकर, हाइफ़न को अंडरस्कोर से बदलकर और `sip_` प्रीफ़िक्स जोड़कर सामान्यीकृत किया जाता है।

| हेडर              | डायनामिक वेरिएबल        | विवरण                                                                   |
| ----------------- | ----------------------- | ----------------------------------------------------------------------- |
| `X-CallANI`       | `{{sip_callani}}`       | कॉलर का फ़ोन नंबर।                                                      |
| `X-CallDNIS`      | `{{sip_calldnis}}`      | डायल किया गया फ़ोन नंबर।                                                |
| `X-CallID`        | `{{sip_callid}}`        | यूनिक Five9 कॉल आइडेंटिफ़ायर।                                           |
| `X-CallSessionID` | `{{sip_callsessionid}}` | मौजूदा सेशन का आइडेंटिफ़ायर।                                            |
| `X-CallCampaign`  | `{{sip_callcampaign}}`  | Five9 कैंपेन का नाम।                                                    |
| `X-AgentID`       | `{{sip_agentid}}`       | टारगेट ElevenLabs एजेंट, राउटर एजेंट से रूटिंग के लिए इस्तेमाल होता है। |

बातचीत को व्यक्तिगत बनाने के लिए इन वेरिएबल्स का इस्तेमाल एजेंट प्रॉम्प्ट्स, पहले मैसेज और टूल्स में करें।

> **Note**
>
> रिज़र्व्ड हेडर्स `X-Call-ID` और `X-Caller-ID`, `system__call_sid` और
> `system__caller_id` [सिस्टम डायनामिक वेरिएबल्स](/docs/hi/eleven-agents/customization/personalization/dynamic-variables#system-dynamic-variables) से मैप होते हैं।
> Five9 बिना हाइफ़न वाले `X-CallID` और `X-CallANI` भेजता है, जो क्रमशः `sip_callid` और
> `sip_callani` में सामान्यीकृत होते हैं। प्रॉम्प्ट्स में उनका इस्तेमाल करने से पहले टेस्ट कॉल के दौरान
> पुष्टि करें कि कौन-से वेरिएबल्स भरे गए हैं।

## ElevenLabs से Five9 को लौटाए गए हेडर्स

ElevenLabs, SIP BYE पर रूटिंग और रिपोर्टिंग डेटा लौटाता है। Five9 AI Agent Connect के लिए निम्न हेडर नाम सुझाया गया नियम हैं:

| हेडर               | विवरण                                                 |
| ------------------ | ----------------------------------------------------- |
| `X-RouteType`      | Five9 को की जाने वाली कार्रवाई, जैसे `SkillTransfer`। |
| `X-RouteValue`     | कार्रवाई का टारगेट, जैसे Five9 स्किल नाम।             |
| `X-RouteReason`    | रूटिंग निर्णय का कॉन्टेक्स्ट, जैसे ग्राहक का इरादा।   |
| `X-ConversationId` | लॉग को जोड़ने के लिए ElevenLabs बातचीत आइडेंटिफ़ायर।  |

आप अपने Five9 फ़्लो के लिए आवश्यक कोई भी अतिरिक्त `X-` हेडर लौटा सकते हैं। हर हेडर वैल्यू एजेंट के एक डायनामिक वेरिएबल से आती है, इसलिए एजेंट को बातचीत के दौरान ये वेरिएबल्स सेट करने होंगे।

## BYE हेडर्स कॉन्फ़िगर करना

BYE हेडर्स एजेंट के डायनामिक वेरिएबल्स की अंतिम वैल्यू Five9 को लौटाते हैं। `inbound_trunk_config` में फ़ोन नंबर के `attributes_to_headers` का उपयोग करके हर डायनामिक वेरिएबल नाम को एक हेडर नाम से मैप करें। आपके एजेंट द्वारा सेट किए गए वेरिएबल्स और `system__conversation_id` जैसे [सिस्टम डायनामिक वेरिएबल्स](/docs/hi/eleven-agents/customization/personalization/dynamic-variables#system-dynamic-variables), दोनों मैप किए जा सकते हैं:

**`Python`**

```python title="Python"
import os
from dotenv import load_dotenv
from elevenlabs import ElevenLabs, InboundSipTrunkConfigRequestModel

load_dotenv()

elevenlabs = ElevenLabs(api_key=os.getenv("ELEVENLABS_API_KEY"))

elevenlabs.conversational_ai.phone_numbers.update(
    phone_number_id="phnum_8901k4t9z5defmb8vh3e9361y7nj",
    inbound_trunk_config=InboundSipTrunkConfigRequestModel(
        attributes_to_headers={
            "route_type": "X-RouteType",
            "route_value": "X-RouteValue",
            "route_reason": "X-RouteReason",
            "system__conversation_id": "X-ConversationId",
        }
    ),
)
```

**`JavaScript`**

```typescript title="JavaScript"
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.phoneNumbers.update("phnum_8901k4t9z5defmb8vh3e9361y7nj", {
  inboundTrunkConfig: {
    attributesToHeaders: {
      route_type: "X-RouteType",
      route_value: "X-RouteValue",
      route_reason: "X-RouteReason",
      system__conversation_id: "X-ConversationId",
    },
  },
});
```

**`cURL`**

```bash title="cURL"
curl -X PATCH "https://api.elevenlabs.io/v1/convai/phone-numbers/phnum_8901k4t9z5defmb8vh3e9361y7nj" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inbound_trunk_config": {
      "attributes_to_headers": {
        "route_type": "X-RouteType",
        "route_value": "X-RouteValue",
        "route_reason": "X-RouteReason",
        "system__conversation_id": "X-ConversationId"
      }
    }
  }'
```

हेडर वैल्यू, बातचीत के अंत में डायनामिक वेरिएबल की वैल्यू होती है, जिसमें एजेंट टूल्स या वेबहुक ओवरराइड्स के ज़रिए कॉल के दौरान सेट की गई वैल्यूज़ भी शामिल होती हैं। जिस कॉल में एजेंट अंत में `route_type` को `SkillTransfer` और `route_value` को `billing_support` पर सेट करता है, वह निम्न BYE हेडर्स बनाती है:

```
X-RouteType: SkillTransfer
X-RouteValue: billing_support
X-RouteReason: Customer needs help with an invoice
X-ConversationId: conv_7401k6a2b8cxyzmn9pq3r5s7t1uv
```

इसके बाद Five9 कॉलर को `billing_support` स्किल पर रूट करता है।

## सुझाई गई रूटिंग वैल्यूज़

`X-RouteType` वैल्यूज़ को सरल और अनुमानित रखें, ताकि Five9 फ़्लो सीधे उनके आधार पर ब्रांच कर सके।

| `X-RouteType`     | उदाहरण `X-RouteValue` | विवरण                                                |
| ----------------- | --------------------- | ---------------------------------------------------- |
| `SkillTransfer`   | `billing_support`     | कॉल को किसी खास Five9 स्किल क्यू में ट्रांसफ़र करें। |
| `PhoneTransfer`   | `+18005550199`        | कॉल को किसी बाहरी फ़ोन नंबर पर ट्रांसफ़र करें।       |
| `Hangup`          | खाली                  | AI इंटरैक्शन के बाद कॉल समाप्त करें।                 |
| `DispositionOnly` | `Resolved`            | कॉल समाप्त करें और एक खास डिस्पोज़िशन रिकॉर्ड करें।  |

## Five9 सेटअप

आपकी Five9 इम्प्लीमेंटेशन टीम आमतौर पर ये काम करेगी:

1. आपके Five9 डोमेन के लिए AI Agent Connect सक्षम करेगी।
2. Five9 IVR ट्रांसफ़र फ़्लो कॉन्फ़िगर करेगी।
3. ट्रांसफ़र डेस्टिनेशन के रूप में ElevenLabs फ़ोन नंबर जोड़ेगी।
4. External Transfer Module कॉन्फ़िगर करेगी।
5. ElevenLabs को भेजे जाने वाले आउटबाउंड `X-` हेडर्स कॉन्फ़िगर करेगी।
6. ElevenLabs से लौटाए जाने वाले इनबाउंड `X-` हेडर्स कॉन्फ़िगर करेगी।
7. लौटाए गए हेडर्स को Five9 कॉल वेरिएबल्स में मैप करेगी।
8. इन वेरिएबल्स के आधार पर ब्रांच होने वाला AI के बाद का रूटिंग लॉजिक कॉन्फ़िगर करेगी।
9. शुरू से अंत तक टेस्ट कॉल करेगी।

## समस्या निवारण

#### ट्रांसफ़र की गई कॉल कनेक्ट नहीं हो रही हैं

* पुष्टि करें कि ElevenLabs फ़ोन नंबर SIP ट्रंक नंबर के रूप में इंपोर्ट किया गया है और उस पर एक एजेंट असाइन है।
* जांचें कि Five9 External Transfer Module में कॉन्फ़िगर किया गया ट्रांसफ़र डेस्टिनेशन इंपोर्ट किए गए नंबर से मेल खाता है।
* जांचें कि आपका फ़ायरवॉल कॉन्फ़िगर किए गए ट्रांसपोर्ट और पोर्ट पर SIP सिग्नलिंग ट्रैफ़िक की अनुमति देता है और RTP पोर्ट्स ब्लॉक नहीं हैं।

#### इनबाउंड हेडर्स डायनामिक वेरिएबल्स के रूप में उपलब्ध नहीं हैं

* पुष्टि करें कि Five9 INVITE पर `X-` प्रीफ़िक्स के साथ हेडर्स भेजता है।
* सामान्यीकृत वेरिएबल नाम जांचें। `X-AgentID`, `{{sip_agentid}}` बनता है, `{{X-AgentID}}` या `{{agent_id}}` नहीं।
* कौन-से हेडर्स आए हैं, यह देखने के लिए **Phone Call** टैब के अंतर्गत बातचीत इतिहास देखें।
* कस्टम हेडर्स `system__call_sid` और `system__caller_id` सिस्टम वेरिएबल्स को ओवरराइड नहीं कर सकते।

#### BYE हेडर्स मौजूद नहीं हैं या खाली हैं

* पुष्टि करें कि कॉल पाने वाले फ़ोन नंबर के लिए `inbound_trunk_config` पर `attributes_to_headers` सेट है।
* पुष्टि करें कि कीज़ डायनामिक वेरिएबल नाम हैं और वैल्यूज़ हेडर नाम हैं, इसका उल्टा नहीं।
* सुनिश्चित करें कि एजेंट बातचीत के दौरान वास्तव में वे डायनामिक वेरिएबल्स सेट करता है। अनसेट वेरिएबल कोई हेडर वैल्यू नहीं बनाता।

#### राउटर एजेंट गलत एजेंट को ट्रांसफ़र करता है

* पुष्टि करें कि Five9 हर ट्रांसफ़र की गई कॉल पर `X-AgentID` भेजता है।
* जांचें कि हर `X-AgentID` वैल्यू के लिए राउटर एजेंट पर उससे मेल खाता ट्रांसफ़र नियम है।
* पुष्टि करें कि राउटर एजेंट के ट्रांसफ़र नियम `{{sip_agentid}}` को रेफ़र करते हैं।

## उपयोगी लिंक

* [SIP ट्रंकिंग गाइड](/docs/hi/eleven-agents/phone-numbers/sip-trunking)
* [SIP रेफ़रेंस](/docs/hi/eleven-agents/phone-numbers/sip-reference)
* [एजेंट ट्रांसफ़र टूल](/docs/hi/eleven-agents/customization/tools/system-tools/agent-transfer)
* [डायनामिक वेरिएबल्स](/docs/hi/eleven-agents/customization/personalization/dynamic-variables)
* [फ़ोन नंबर अपडेट API रेफ़रेंस](/docs/hi/api-reference/phone-numbers/update)