Open in
Five9માંથી કનેક્ટ કરો
AI Agent Connect સાથે SIP મારફતે Five9 કૉલ્સને ThunderPhone એજન્ટ પાસે મોકલો અને તમારા IVR સ્ક્રિપ્ટ વાંચે તેવા રૂટિંગ હેડર્સ સાથે તેમને પાછા મેળવો.
તમારી Five9 IVR સ્ક્રિપ્ટ કૉલરને Five9ની કૉલ વિગતો સાથે એજન્ટ પાસે મોકલે છે. એજન્ટનું કાર્ય પૂર્ણ થાય ત્યારે તે SIP BYE પર રૂટિંગ હેડર્સ સાથે કૉલ સમાપ્ત કરે છે, જેને સ્ક્રિપ્ટ કૉલરને રૂટ કરવા માટે કૉલ વેરિએબલ્સમાં વાંચે છે.
શરૂ કરતા પહેલાં
- એક ThunderPhone એજન્ટ અને સંસ્થાની API કી.
- Five9નું AI Agent Connect ઍડ-ઑન. Five9 તેને તેના દ્વારા માન્યતાપ્રાપ્ત AI પ્રદાતાઓ સુધી મર્યાદિત રાખે છે, અને Five9ની અમલીકરણ ટીમ તેને સેટ અપ કરે છે: તે પ્રદાતાની IVR સ્ક્રિપ્ટ ટેમ્પલેટ આયાત કરે છે, કૉલ વેરિએબલ્સ બનાવે છે અને સ્ક્રિપ્ટના ત્રીજા પક્ષનું ટ્રાન્સફર મોડ્યુલને પ્રદાતા તરફ નિર્દેશિત કરે છે. ThunderPhone હજી Five9ની માન્યતાપ્રાપ્ત સૂચિમાં નથી: તેના આધારે આયોજન કરતાં પહેલાં તમારી Five9 એકાઉન્ટ ટીમ અથવા ThunderPhone સપોર્ટને પૂછો.
1. SIP એન્ડપોઇન્ટ બનાવો
Five9નું ત્રીજા પક્ષનું ટ્રાન્સફર મોડ્યુલ SIP સરનામું નહીં પરંતુ ફોન નંબર ડાયલ કરે છે, અને અન્ય પ્રદાતાઓના Five9 ઇન્ટિગ્રેશનો પાસવર્ડને બદલે સ્રોત સરનામા દ્વારા Five9ને પ્રમાણિત કરે છે. તેથી Five9 જે નંબર ડાયલ કરશે તેને ડાયલ-ઇન નંબર તરીકે રાખીને ip_allowlist એન્ડપોઇન્ટ બનાવો (જુઓ
ફોન નંબર ડાયલ કરતા પ્લેટફોર્મ્સ):
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ની સ્ક્રિપ્ટ વાંચે છે તે ચાર હેડર હોય છે. આ ટ્રાન્સફર નંબર ઉમેરો (જુઓ
ટ્રાન્સફર નંબર ઉમેરો):
{
"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 સાથે. જુઓ
હેન્ડ-ઓફ કરાયેલ કૉલ શોધો.
તેનું પરીક્ષણ કરો
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 પેકેટ ફ્રેગમેન્ટેશન ટાળવા માટે કસ્ટમ હેડરને લગભગ દસ સુધી મર્યાદિત રાખવાની ભલામણ કરે છે.