---
title: "Five9 ನಿಂದ ಸಂಪರ್ಕಿಸಿ"
description: "AI Agent Connect ಜೊತೆಗೆ SIP ಮೂಲಕ Five9 ಕರೆಗಳನ್ನು ThunderPhone ಏಜೆಂಟ್‌ಗೆ ಕಳುಹಿಸಿ ಮತ್ತು ನಿಮ್ಮ IVR ಸ್ಕ್ರಿಪ್ಟ್ ಓದುವ ರೂಟಿಂಗ್ ಹೆಡರ್‌ಗಳೊಂದಿಗೆ ಅವುಗಳನ್ನು ಮರಳಿ ಪಡೆಯಿರಿ."
---

ನಿಮ್ಮ Five9 IVR ಸ್ಕ್ರಿಪ್ಟ್ Five9 ನ ಕರೆ ವಿವರಗಳೊಂದಿಗೆ ಕರೆ ಮಾಡುವವರನ್ನು ಏಜೆಂಟ್‌ಗೆ ಕಳುಹಿಸುತ್ತದೆ. ಏಜೆಂಟ್‌ನ ಕಾರ್ಯ ಮುಗಿದಾಗ, ಅದು SIP `BYE` ನಲ್ಲಿ ರೌಟಿಂಗ್ ಹೆಡರ್‌ಗಳೊಂದಿಗೆ ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸುತ್ತದೆ; ಕರೆ ಮಾಡುವವರನ್ನು ರೌಟ್ ಮಾಡಲು ಸ್ಕ್ರಿಪ್ಟ್ ಅವುಗಳನ್ನು ಕರೆ ವೇರಿಯಬಲ್‌ಗಳಿಗೆ ಓದುತ್ತದೆ.

## ಆರಂಭಿಸುವ ಮೊದಲು

- ThunderPhone ಏಜೆಂಟ್ ಮತ್ತು ಸಂಸ್ಥೆಯ [API ಕೀ](/kn/guides/api-keys).
- Five9 ನ **AI Agent Connect** ಆಡ್-ಆನ್. Five9 ಇದನ್ನು ತಾನು ಮಾನ್ಯತೆ ನೀಡಿರುವ AI ಪೂರೈಕೆದಾರರಿಗೆ ಮಾತ್ರ ಮಿತಿಗೊಳಿಸುತ್ತದೆ ಮತ್ತು Five9 ನ ಅನುಷ್ಠಾನ ತಂಡವು ಇದನ್ನು ಹೊಂದಿಸುತ್ತದೆ: ಅದು ಪೂರೈಕೆದಾರರ IVR ಸ್ಕ್ರಿಪ್ಟ್ ಟೆಂಪ್ಲೇಟ್ ಅನ್ನು ಆಮದು ಮಾಡುತ್ತದೆ, ಕರೆ ವೇರಿಯಬಲ್‌ಗಳನ್ನು ರಚಿಸುತ್ತದೆ ಮತ್ತು ಸ್ಕ್ರಿಪ್ಟ್‌ನ **ಮೂರನೇ ಪಕ್ಷ ವರ್ಗಾವಣೆ** ಮಾಡ್ಯೂಲ್ ಅನ್ನು ಪೂರೈಕೆದಾರರತ್ತ ನಿರ್ದೇಶಿಸುತ್ತದೆ. ThunderPhone ಇನ್ನೂ Five9 ನ ಮಾನ್ಯತೆ ಪಡೆದ ಪಟ್ಟಿಯಲ್ಲಿಲ್ಲ: ಇದನ್ನು ಆಧರಿಸಿ ಯೋಜಿಸುವ ಮೊದಲು ನಿಮ್ಮ Five9 ಖಾತೆ ತಂಡವನ್ನು ಅಥವಾ ThunderPhone ಬೆಂಬಲವನ್ನು ಕೇಳಿ.

## 1. SIP ಎಂಡ್‌ಪಾಯಿಂಟ್ ರಚಿಸಿ

Five9 ನ ಮೂರನೇ ಪಕ್ಷ ವರ್ಗಾವಣೆ ಮಾಡ್ಯೂಲ್ SIP ವಿಳಾಸವಲ್ಲ, ಫೋನ್ ಸಂಖ್ಯೆಯನ್ನು ಡಯಲ್ ಮಾಡುತ್ತದೆ, ಮತ್ತು ಇತರ ಪೂರೈಕೆದಾರರ Five9 ಏಕೀಕರಣಗಳು ಪಾಸ್‌ವರ್ಡ್ ಬದಲಿಗೆ ಮೂಲ ವಿಳಾಸದ ಮೂಲಕ Five9 ಅನ್ನು ದೃಢೀಕರಿಸುತ್ತವೆ. ಆದ್ದರಿಂದ Five9 ಡಯಲ್ ಮಾಡುವ ಸಂಖ್ಯೆಯನ್ನು ಡಯಲ್-ಇನ್ ಸಂಖ್ಯೆಯಾಗಿ ಹೊಂದಿಸಿ `ip_allowlist` ಎಂಡ್‌ಪಾಯಿಂಟ್ ರಚಿಸಿ ([ಫೋನ್ ಸಂಖ್ಯೆಯನ್ನು ಡಯಲ್ ಮಾಡುವ ಪ್ಲಾಟ್‌ಫಾರ್ಮ್‌ಗಳು](/kn/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 ಸಿಗ್ನಲಿಂಗ್ ಶ್ರೇಣಿಗಳು. ಪ್ರತಿಯೊಂದೂ `/16` ಅಥವಾ ಅದಕ್ಕಿಂತ ಕಿರಿದಾದ ಸಾರ್ವಜನಿಕ IPv4 ಶ್ರೇಣಿಯಾಗಿರಬೇಕು (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` ಎಂದು ದಾಖಲಿಸುತ್ತವೆ; ನಿಮ್ಮ ಮೊದಲ ಪರೀಕ್ಷಾ ಕರೆಯಲ್ಲಿ ಅವುಗಳನ್ನು ಪರಿಶೀಲಿಸಿ. ಪ್ರತಿಯೊಂದೂ `{{sip_x_callcampaign}}` ನಂತಹ ವೇರಿಯಬಲ್ ಆಗಿ prompt ಅನ್ನು ತಲುಪುತ್ತದೆ. `X-CallID` ಅನ್ನು ಕರೆಯ `external_call_id` ಆಗಿ ಸಂಗ್ರಹಿಸಲಾಗುತ್ತದೆ.

## 3. ಕರೆಯನ್ನು ಮರಳಿ ಪಡೆಯಿರಿ

ಏಜೆಂಟ್ ಕರೆಯನ್ನು ಮರಳಿ ಮಾಡುತ್ತದೆ: ಅದು ವಿದಾಯ ಹೇಳಿ ಸಂಪರ್ಕ ಕಡಿತಗೊಳಿಸುತ್ತದೆ, ಮತ್ತು `BYE` ಯಲ್ಲಿ Five9 ನ ಸ್ಕ್ರಿಪ್ಟ್ ಓದುವ ನಾಲ್ಕು ಹೆಡರ್‌ಗಳು ಇರುತ್ತವೆ. ಈ ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ (ನೋಡಿ
[ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ](/kn/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` Five9 ನಲ್ಲಿರುವ `call.call_id` ಗೆ ಹೊಂದಿಕೆಯಾಗಬೇಕು.

## ಮಿತಿಗಳು

- Five9 ನ ಮಾರ್ಗದರ್ಶಿ `BYE` ಯಲ್ಲಿನ ಮಾರ್ಗನಿರ್ದೇಶನ ಡೇಟಾವನ್ನು ದಾಖಲಿಸುತ್ತದೆ ಮತ್ತು
  `REFER` ಸ್ವೀಕರಿಸುವುದನ್ನು ಉಲ್ಲೇಖಿಸುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ ಮರಳಿ ಹಸ್ತಾಂತರಿಸುವುದು ಸ್ಕ್ರಿಪ್ಟ್ ಮೂಲಕದ ಕೋಲ್ಡ್ ವರ್ಗಾವಣೆಯಾಗಿದೆ.
- Five9 `X-RouteType`, `X-RouteValue`, `X-RouteReason` ಮತ್ತು
  `X-CustomMetaData` ಅನ್ನು ಓದುತ್ತದೆ, `User-to-User` ಅನ್ನು ಅಲ್ಲ. ThunderPhone ಪ್ರತಿ ಹೆಡರ್ ಮೌಲ್ಯವನ್ನು ಗರಿಷ್ಠ 256 ಬೈಟ್‌ಗಳ ಉದ್ದಕ್ಕೆ ಕಳುಹಿಸುತ್ತದೆ.
- ಪ್ಯಾಕೆಟ್ ವಿಘಟನೆಯನ್ನು ತಪ್ಪಿಸಲು ಕಸ್ಟಮ್ ಹೆಡರ್‌ಗಳನ್ನು ಸುಮಾರು ಹತ್ತಕ್ಕೆ ಮಿತಿಗೊಳಿಸಲು Five9 ಶಿಫಾರಸು ಮಾಡುತ್ತದೆ.
