Open in
Genesys Cloudમાંથી કનેક્ટ કરો
Genesys Cloud કૉલ્સને conversation id અને UUI સાથે BYOC Cloud ટ્રંક મારફતે ThunderPhone એજન્ટને મોકલો અને UUIમાં હેન્ડ-ઓફ સાથે તેમને પાછા લો.
તમારો Architect ફ્લો કોલરને BYOC Cloud ટ્રંક મારફતે એજન્ટ પાસે મોકલે છે, જેમાં conversation id અને તમે સેટ કરેલ કોઈપણ UUI હોય છે. જ્યારે કોલરને વ્યક્તિની જરૂર પડે છે, ત્યારે એજન્ટ SIP REFER મોકલે છે, Genesys કોલ પાછો લે છે અને હેન્ડ-ઓફ id કોલના UUIમાં આવે છે.
શરૂ કરતા પહેલાં
- ThunderPhone એજન્ટ અને સંસ્થાની API key.
- BYOC Cloud ધરાવતું Genesys Cloud અને નીચેની સેટિંગ્સ ચાલુ કરેલ બાહ્ય ટ્રંક (પ્રકાર BYOC Carrier અથવા PBX)
(બાહ્ય ટ્રંક સેટિંગ્સ):
- વાર્તાલાપ હેડર્સ, જેથી Genesys તેનો conversation id
x-inin-cnvમાં મોકલે. આ ડિફૉલ્ટ રૂપે બંધ હોય છે. - હેડર પ્રકાર
User-To-Userઅને Hex એન્કોડિંગ સાથે UUI પાસથ્રૂ. - ટેક બૅક અને ટ્રાન્સફર, જેથી Genesys એજન્ટનું
REFERસ્વીકારે.
- વાર્તાલાપ હેડર્સ, જેથી Genesys તેનો conversation id
1. SIP એન્ડપોઇન્ટ બનાવો
Genesys digest challengeનો જવાબ આપે છે, તેથી પ્રમાણભૂત એન્ડપોઇન્ટ વાપરો:
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": "Genesys Cloud"}'રિસ્પોન્સમાંથી password તરત જ સાચવી લો; તે એક જ વાર બતાવવામાં આવે છે. ટ્રંક પર:
| સેટિંગ | મૂલ્ય |
|---|---|
| SIP સર્વર | sip.thunderphone.com, પોર્ટ 5061 |
| પ્રોટોકોલ | TLS |
| Digest પ્રમાણીકરણ | એન્ડપોઇન્ટના username અને password |
| કોડેક્સ | PCMU, PCMA અથવા G.722 |
તમારી સાઇટના એવા આઉટબાઉન્ડ રૂટ પર ટ્રંક મૂકો, જેનો નંબર પ્લાન ફ્લો દ્વારા ડાયલ કરાતા સરનામાને આવરી લેતો હોય.
2. સંદર્ભ સાથે કોલ મોકલો
તમારા Architect ફ્લોમાં:
- વૈકલ્પિક રીતે, એજન્ટ માટે સંદર્ભ સાથે UUI ડેટા સેટ કરો ઍક્શન ઉમેરો, જેમ કે
account=12345. Genesys 128 અથવા ઓછા અક્ષરોની ભલામણ કરે છે. - એન્ડપોઇન્ટના
sip_uriસાથે નંબર પર ટ્રાન્સફર કરો ઍક્શન ઉમેરો, ઉદાહરણ તરીકેsip:agent-12-jhxmginwjx@sip.thunderphone.com.
Genesys conversation id x-inin-cnvમાં મોકલે છે. ThunderPhone તેને કોલના external_call_id તરીકે સંગ્રહિત કરે છે. UUI ડીકોડ થયા પછી prompt સુધી {{sip_uui}} તરીકે પહોંચે છે.
Genesysમાં ટ્રંક કસ્ટમ હેડર્સ સ્થિર હોય છે, તેથી પ્રતિ-કોલ મૂલ્યો UUIમાં મૂકો. Genesys x-inin, x-genesys, x-pcv અને x-gcv હેડર પ્રીફિક્સ પોતાના માટે અનામત રાખે છે.
3. કોલ પાછો મેળવો
એજન્ટ Genesys પરના સરનામા માટે REFER વડે ટ્રાન્સફર કરે છે, જેમાં તે સરનામાની અંદર હેન્ડ-ઓફ id hex UUI તરીકે હોય છે. આ ટ્રાન્સફર નંબર ઉમેરો (જુઓ
ટ્રાન્સફર નંબર ઉમેરો
અને ટ્રાન્સફર સરનામાની અંદરના હેડર્સ):
{
"name": "Genesys support",
"number": "sip:support@acme.byoc.mypurecloud.com",
"headers": {"User-to-User": "{{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}સરનામાને એવા સરનામાથી બદલો જે કોલરને લેવા જોઈએ તેવી કતાર અથવા ફ્લો તરફ પાછું રૂટ કરે; તેનું સ્વરૂપ Genesys સાથે ચકાસો. REFER આના જેવું દેખાય છે:
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
ટેક બૅક અને ટ્રાન્સફર ચાલુ હોય ત્યારે Genesys ટ્રંકમાંથી કોલ પાછો લે છે અને તેને તે સરનામા પર રૂટ કરે છે. Genesys દસ્તાવેજીકરણ મુજબ આવતું UUI Call.UUIDataમાં આવે છે; ટેક-બૅક માટે તે આનું દસ્તાવેજીકરણ કરતું નથી, તેથી Genesys સાથે અથવા પરીક્ષણ કોલ પર ખાતરી કરો કે કોલર મેળવતો ફ્લો ત્યાં હેન્ડ-ઓફ id શોધે છે. સારાંશ અને ઇન્ટેન્ટ મેળવવા માટે, Web Services Data Actions ઇન્ટિગ્રેશનમાં કોલ ડેટા ઍક્શન દ્વારા હેન્ડ-ઓફ લુકઅપ કૉલ કરો:
- વિનંતી:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=ત્યારબાદCall.UUIDataમાંથી id. - ઓળખપત્રો: તમારી API key,
Authorization: Bearer sk_live_…તરીકે મોકલવામાં આવે છે. - આઉટપુટ:
handoff.summaryઅનેhandoff.intentને ફ્લો વેરિએબલ્સ સાથે મેપ કરો.
જુઓ હેન્ડ-ઓફ કરેલા કોલને શોધો.
તેને ચકાસો
ફ્લો સુધી પહોંચતા નંબર પર કૉલ કરો, એજન્ટને કોઈ વ્યક્તિ માટે પૂછો અને Genesys કૉલને તમે સેટ કરેલા સરનામે લઈ જાય છે કે નહીં તે તપાસો. તે ફ્લોમાં, Call.UUIData હેન્ડ-ઓફ idને ટેક્સ્ટ તરીકે ધરાવે છે કે નહીં તે તપાસો (જો તે hex અંકો બતાવે, તો ટ્રંકનું UUI એન્કોડિંગ Hex છે કે નહીં તે તપાસો). પછી GET /v1/calls/{call_id} વડે કૉલ ખોલો:
external_call_id conversation id હોવી જોઈએ.
મર્યાદાઓ
- SIP હેડર્સ મેળવો ક્રિયા ફક્ત પ્રારંભિક
INVITEવાંચે છે, તેથી તે એજન્ટનાREFERમાંથી કંઈ વાંચી શકતી નથી. હેન્ડ-ઓફ માત્ર UUI મારફતે Genesys સુધી પહોંચે છે. - જ્યારે કૉલમાં એકથી વધુ UUI હેડર હોય ત્યારે Genesys તમામ UUI કાઢી નાખે છે.
- ટ્રાન્સફર સરનામું 254 અક્ષરો સુધી રાખવામાં આવે છે, તેથી લાંબું UUI ફિટ કરવા માટે કાપવામાં આવે છે. હેન્ડ-ઓફ id હંમેશા ફિટ થાય છે.