---
title: "Five9માંથી કનેક્ટ કરો"
description: "AI Agent Connect સાથે SIP મારફતે Five9 કૉલ્સને ThunderPhone એજન્ટ પાસે મોકલો અને તમારા IVR સ્ક્રિપ્ટ વાંચે તેવા રૂટિંગ હેડર્સ સાથે તેમને પાછા મેળવો."
---

તમારી Five9 IVR સ્ક્રિપ્ટ કૉલરને Five9ની કૉલ વિગતો સાથે એજન્ટ પાસે મોકલે છે. એજન્ટનું કાર્ય પૂર્ણ થાય ત્યારે તે SIP `BYE` પર રૂટિંગ હેડર્સ સાથે કૉલ સમાપ્ત કરે છે, જેને સ્ક્રિપ્ટ કૉલરને રૂટ કરવા માટે કૉલ વેરિએબલ્સમાં વાંચે છે.

## શરૂ કરતા પહેલાં

- એક ThunderPhone એજન્ટ અને સંસ્થાની [API કી](/gu/guides/api-keys).
- Five9નું **AI Agent Connect** ઍડ-ઑન. Five9 તેને તેના દ્વારા માન્યતાપ્રાપ્ત AI પ્રદાતાઓ સુધી મર્યાદિત રાખે છે, અને Five9ની અમલીકરણ ટીમ તેને સેટ અપ કરે છે: તે પ્રદાતાની IVR સ્ક્રિપ્ટ ટેમ્પલેટ આયાત કરે છે, કૉલ વેરિએબલ્સ બનાવે છે અને સ્ક્રિપ્ટના **ત્રીજા પક્ષનું ટ્રાન્સફર** મોડ્યુલને પ્રદાતા તરફ નિર્દેશિત કરે છે. ThunderPhone હજી Five9ની માન્યતાપ્રાપ્ત સૂચિમાં નથી: તેના આધારે આયોજન કરતાં પહેલાં તમારી Five9 એકાઉન્ટ ટીમ અથવા ThunderPhone સપોર્ટને પૂછો.

## 1. SIP એન્ડપોઇન્ટ બનાવો

Five9નું ત્રીજા પક્ષનું ટ્રાન્સફર મોડ્યુલ SIP સરનામું નહીં પરંતુ ફોન નંબર ડાયલ કરે છે, અને અન્ય પ્રદાતાઓના Five9 ઇન્ટિગ્રેશનો પાસવર્ડને બદલે સ્રોત સરનામા દ્વારા Five9ને પ્રમાણિત કરે છે. તેથી Five9 જે નંબર ડાયલ કરશે તેને ડાયલ-ઇન નંબર તરીકે રાખીને `ip_allowlist` એન્ડપોઇન્ટ બનાવો (જુઓ
[ફોન નંબર ડાયલ કરતા પ્લેટફોર્મ્સ](/gu/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ની સ્ક્રિપ્ટ વાંચે છે તે ચાર હેડર હોય છે. આ ટ્રાન્સફર નંબર ઉમેરો (જુઓ
[ટ્રાન્સફર નંબર ઉમેરો](/gu/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` હેન્ડ-ઓફ id ધરાવે છે. `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 Profile સાથે. જુઓ
[હેન્ડ-ઓફ કરાયેલ કૉલ શોધો](/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 પેકેટ ફ્રેગમેન્ટેશન ટાળવા માટે કસ્ટમ હેડરને લગભગ દસ સુધી મર્યાદિત રાખવાની ભલામણ કરે છે.
