---
title: "Five9 ਤੋਂ ਕਨੈਕਟ ਕਰੋ"
description: "AI Agent Connect ਨਾਲ Five9 ਕਾਲਾਂ ਨੂੰ SIP ਰਾਹੀਂ ThunderPhone ਏਜੰਟ ਕੋਲ ਭੇਜੋ, ਅਤੇ ਉਨ੍ਹਾਂ ਨੂੰ ਉਹਨਾਂ ਰੂਟਿੰਗ ਹੈਡਰਾਂ ਨਾਲ ਵਾਪਸ ਪ੍ਰਾਪਤ ਕਰੋ ਜੋ ਤੁਹਾਡੀ IVR ਸਕ੍ਰਿਪਟ ਪੜ੍ਹਦੀ ਹੈ।"
---

ਤੁਹਾਡੀ Five9 IVR ਸਕ੍ਰਿਪਟ ਕਾਲਰ ਨੂੰ Five9 ਦੇ ਕਾਲ ਵੇਰਵਿਆਂ ਨਾਲ ਏਜੰਟ ਕੋਲ ਭੇਜਦੀ ਹੈ। ਜਦੋਂ ਏਜੰਟ ਦਾ ਕੰਮ ਮੁੱਕ ਜਾਂਦਾ ਹੈ, ਤਾਂ ਇਹ SIP `BYE` ਉੱਤੇ ਰੂਟਿੰਗ ਹੈਡਰਾਂ ਨਾਲ ਕਾਲ ਬੰਦ ਕਰਦਾ ਹੈ, ਜਿਨ੍ਹਾਂ ਨੂੰ ਸਕ੍ਰਿਪਟ ਕਾਲਰ ਨੂੰ ਰੂਟ ਕਰਨ ਲਈ ਕਾਲ ਵੇਰੀਏਬਲਾਂ ਵਿੱਚ ਪੜ੍ਹਦੀ ਹੈ।

## ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ

- ਇੱਕ ThunderPhone ਏਜੰਟ ਅਤੇ ਇੱਕ ਸੰਗਠਨ [API ਕੁੰਜੀ](/pa/guides/api-keys)।
- Five9 ਦਾ **AI ਏਜੰਟ ਕਨੈਕਟ** ਐਡ-ਆਨ। Five9 ਇਸਨੂੰ ਆਪਣੇ ਮਾਨਤਾ-ਪ੍ਰਾਪਤ AI ਪ੍ਰਦਾਤਾਵਾਂ ਤੱਕ ਸੀਮਿਤ ਰੱਖਦਾ ਹੈ ਅਤੇ Five9 ਦੀ ਇੰਪਲੀਮੈਂਟੇਸ਼ਨ ਟੀਮ ਇਸਨੂੰ ਸੈੱਟ ਅੱਪ ਕਰਦੀ ਹੈ: ਇਹ ਪ੍ਰਦਾਤਾ ਦਾ IVR ਸਕ੍ਰਿਪਟ ਟੈਂਪਲੇਟ ਇੰਪੋਰਟ ਕਰਦੀ ਹੈ, ਕਾਲ ਵੇਰੀਏਬਲ ਬਣਾਉਂਦੀ ਹੈ ਅਤੇ ਸਕ੍ਰਿਪਟ ਦੇ **ਥਰਡ ਪਾਰਟੀ ਟ੍ਰਾਂਸਫਰ** ਮੋਡੀਊਲ ਨੂੰ ਪ੍ਰਦਾਤਾ ਵੱਲ ਪੌਇੰਟ ਕਰਦੀ ਹੈ। ThunderPhone ਹਾਲੇ Five9 ਦੀ ਮਾਨਤਾ-ਪ੍ਰਾਪਤ ਸੂਚੀ ਵਿੱਚ ਨਹੀਂ ਹੈ: ਇਸ ਦੇ ਆਧਾਰ 'ਤੇ ਯੋਜਨਾ ਬਣਾਉਣ ਤੋਂ ਪਹਿਲਾਂ ਆਪਣੀ Five9 ਅਕਾਊਂਟ ਟੀਮ ਜਾਂ ThunderPhone ਸਹਾਇਤਾ ਨਾਲ ਪੁੱਛੋ।

## 1. SIP ਐਂਡਪੁਆਇੰਟ ਬਣਾਓ

Five9 ਦਾ ਥਰਡ ਪਾਰਟੀ ਟ੍ਰਾਂਸਫਰ ਮੋਡੀਊਲ SIP ਪਤਾ ਨਹੀਂ, ਸਗੋਂ ਇੱਕ ਫ਼ੋਨ ਨੰਬਰ ਡਾਇਲ ਕਰਦਾ ਹੈ, ਅਤੇ ਹੋਰ ਪ੍ਰਦਾਤਾਵਾਂ ਦੇ Five9 ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਪਾਸਵਰਡ ਦੀ ਬਜਾਏ ਸਰੋਤ ਪਤੇ ਰਾਹੀਂ Five9 ਦੀ ਪ੍ਰਮਾਣਿਕਤਾ ਕਰਦੇ ਹਨ। ਇਸ ਲਈ Five9 ਜਿਸ ਨੰਬਰ ਨੂੰ ਡਾਇਲ ਕਰੇਗਾ, ਉਸਨੂੰ ਡਾਇਲ-ਇਨ ਨੰਬਰ ਵਜੋਂ ਵਰਤ ਕੇ ਇੱਕ `ip_allowlist` ਐਂਡਪੁਆਇੰਟ ਬਣਾਓ ([ਫ਼ੋਨ ਨੰਬਰ ਡਾਇਲ ਕਰਨ ਵਾਲੇ ਪਲੇਟਫਾਰਮ](/pa/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` ਵਜੋਂ ਦਸਤਾਵੇਜ਼ ਕਰਦੇ ਹਨ; ਆਪਣੀ ਪਹਿਲੀ ਟੈਸਟ ਕਾਲ 'ਤੇ ਉਹਨਾਂ ਦੀ ਜਾਂਚ ਕਰੋ। ਹਰ ਇੱਕ ਪ੍ਰੌਮਪਟ ਤੱਕ ਇੱਕ ਵੇਰੀਏਬਲ ਵਜੋਂ ਪਹੁੰਚਦਾ ਹੈ, ਜਿਵੇਂ ਕਿ
`{{sip_x_callcampaign}}`। `X-CallID` ਕਾਲ ਦੇ
`external_call_id` ਵਜੋਂ ਸਟੋਰ ਹੁੰਦਾ ਹੈ।

## 3. ਕਾਲ ਵਾਪਸ ਲਓ

ਏਜੰਟ ਕਾਲ ਵਾਪਸ ਕਰਦਾ ਹੈ: ਇਹ ਅਲਵਿਦਾ ਕਹਿੰਦਾ ਹੈ ਅਤੇ ਕਾਲ ਬੰਦ ਕਰਦਾ ਹੈ, ਅਤੇ `BYE` ਵਿੱਚ ਉਹ ਚਾਰ ਹੈਡਰ ਹੁੰਦੇ ਹਨ ਜੋ Five9 ਦੀ ਸਕ੍ਰਿਪਟ ਪੜ੍ਹਦੀ ਹੈ। ਇਹ ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ (ਵੇਖੋ
[ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ](/pa/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 ਪੈਕੇਟ ਫ੍ਰੈਗਮੈਂਟੇਸ਼ਨ ਤੋਂ ਬਚਣ ਲਈ ਕਸਟਮ ਹੈਡਰਾਂ ਦੀ ਗਿਣਤੀ ਲਗਭਗ ਦਸ ਤੱਕ ਰੱਖਣ ਦੀ
  ਸਿਫਾਰਸ਼ ਕਰਦਾ ਹੈ।
