ThunderPhone v3 હવે લાઇવ છે.સેલ્ફ-સર્વ, 2¢/મિનિટથી.જાહેરાત વાંચો

Contact centers

Talkdesk માંથી કનેક્ટ કરો

Connect to Autopilot Voice સાથે Talkdesk કૉલ્સને ThunderPhone એજન્ટ પાસે મોકલો અને UUI માં hand-off id સાથે તેમને પાછા એસ્કેલેટ કરો.

તમારો Talkdesk Studio ફ્લો કૉલરને ઇન્ટરૅક્શન id અને UUI સાથે એજન્ટ સુધી મોકલે છે. જ્યારે કૉલરને વ્યક્તિની જરૂર હોય, ત્યારે એજન્ટ Talkdesk પર SIP REFER વડે એસ્કેલેટ કરે છે અને હેન્ડ-ઑફ id Studio વેરિએબલમાં આવે છે.

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

  • ThunderPhone એજન્ટ અને સંસ્થાની API કી.
  • Talkdesk વાર્તાલાપ ઑર્કેસ્ટ્રેટર લાઇસન્સ, જે બાહ્ય વોઇસ સ્ટ્રીમ મોડમાં Studioના ઑટોપાઇલટ વોઇસ સાથે જોડો કમ્પોનન્ટને આવરી લે છે (Talkdeskનો લેખ). એજન્ટ કૉલ જાળવી રાખે તે દરમિયાન Talkdesk પ્રતિ મિનિટ બિલ કરે છે.

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

Talkdesk માત્ર IP એલાઉલિસ્ટનું દસ્તાવેજીકરણ કરે છે, તેથી સ્રોત સરનામા દ્વારા કૉલ સ્વીકારતો એન્ડપોઇન્ટ બનાવો:

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": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'

Talkdeskનો લેખ કહે છે કે તે SRTP મારફતે ઑડિયો મોકલે છે અને "srtp": "optional" Talkdesk ઓફર કરે ત્યારે SRTPથી જવાબ આપે છે. લેખમાં એ નથી જણાવાયું કે Talkdeskને SRTP જરૂરી છે કે નહીં; જો Talkdesk તમને કહે કે તે જરૂરી છે, તો srtpને required પર સેટ કરો, જે તેના વિના કૉલ નકારે છે.

Talkdesk પાસેથી Talkdeskની SIP સિગ્નલિંગ રેન્જ મેળવો. દરેક જાહેર IPv4 રેન્જ /16 અથવા તેનાથી સાંકડી હોવી જોઈએ (IPv6 /48 અથવા તેનાથી સાંકડી). જુઓ સ્રોત IP દ્વારા પ્રમાણીકરણ કરતા પ્લેટફોર્મ્સ. Talkdesk Twilioના નેટવર્કમાંથી SIP મોકલે છે, જેના સરનામા દરેક Twilio ગ્રાહક વહેંચે છે, તેથી એન્ડપોઇન્ટનું સરનામું જ અન્ય કૉલરોને બહાર રાખે છે: તેને પ્રકાશિત કરશો નહીં. પ્રતિસાદનું sip_uri રાખો, ઉદાહરણ તરીકે sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. સંદર્ભ સાથે કૉલ મોકલો

તમારા Studio ફ્લોમાં, બાહ્ય વોઇસ સ્ટ્રીમ મોડમાં ઑટોપાઇલટ વોઇસ સાથે જોડો ઉમેરો અને તેના લક્ષ્યને એન્ડપોઇન્ટના sip_uri પર ;transport=tls ઉમેરીને સેટ કરો, ઉદાહરણ sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. એન્ડપોઇન્ટ UDP પરના કૉલ નકારે છે, જે અન્યથા જણાવવામાં ન આવે તો Twilioનું SIP વાપરે છે.

Talkdesk આ મોકલે છે:

  • X-Talkdesk-Interaction-Id, જે કૉલના external_call_id તરીકે સંગ્રહિત થાય છે;
  • User-to-User, હેક્સ-એન્કોડેડ, જેમ કે business_hours=open. તે {{sip_uui}} તરીકે ડીકોડ થઈને prompt સુધી પહોંચે છે.

કમ્પોનન્ટનું વર્ઝન 2.1 નિર્ધારિત હેડર્સ પણ મોકલી શકે છે. Talkdeskનું પસંદગીઓ પૃષ્ઠ તેમને WebSocket મારફતે મોકલાતા JSON તરીકે વર્ણવે છે, તેથી તેના પર આધાર રાખતા પહેલાં Talkdesk સાથે પુષ્ટિ કરો કે તેઓ SIP હેડર્સ તરીકે પહોંચે છે કે નહીં.

3. કૉલ પાછો મેળવો

એજન્ટ Talkdeskના એસ્કેલેશન સરનામા પર REFER સાથે એસ્કેલેટ કરે છે, જેમાં હસ્તાંતરણ ID તે સરનામાની અંદર હેક્સ UUI તરીકે હોય છે, જે એકમાત્ર સ્થાન છે જ્યાં Talkdesk તેને વાંચે છે. આ ટ્રાન્સફર નંબર ઉમેરો (જુઓ ટ્રાન્સફર નંબર ઉમેરો અને ટ્રાન્સફર સરનામાની અંદરના હેડર્સ):

{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

સરનામું Talkdeskના લેખમાં આપેલું છે. ઘટકનું સંસ્કરણ 2.1 autopilot_result= વાંચે છે; સંસ્કરણ 1.7 escalate_to= વાંચે છે, તેથી 1.7 પર તે કી વાપરો. REFER આના જેવું દેખાય છે:

Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>

Talkdesk મૂલ્યને Studio વેરિએબલમાં મૂકે છે. સારાંશ અને ઇન્ટેન્ટ મેળવવા માટે, Connections વડે બનાવેલા કસ્ટમ ઇન્ટિગ્રેશન પર ક્રિયા ચલાવો પગલું ઉમેરો:

  • ઑથ પ્રકાર API કી, હેડરનું નામ Authorization, મૂલ્ય Bearer sk_live_….
  • વિનંતી: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= પછી વેરિએબલમાંથી મળતી ID. તમે ઇન્ટરૅક્શન ID સાથે external_call_id દ્વારા પણ કૉલ શોધી શકો છો.
  • handoff.intentના આધારે રૂટ કરો અને કૉલ લેનાર વ્યક્તિને handoff.summary બતાવો.

જુઓ હસ્તાંતરિત કૉલ શોધો.

તેનું પરીક્ષણ કરો

Studio પ્રવાહ દ્વારા કૉલ શરૂ કરો, એજન્ટને કોઈ વ્યક્તિ સાથે વાત કરાવવાનું કહો અને ચકાસો કે પ્રવાહ તેના વેરિએબલમાં હસ્તાંતરણ ID સાથે ઘટકની આગળ ચાલુ રહે છે. પછી GET /v1/calls/{call_id} વડે કૉલ ખોલો: external_call_id Talkdesk ઇન્ટરૅક્શન ID હોવી જોઈએ.

મર્યાદાઓ

  • Talkdesk વધુમાં વધુ 256 બાઇટ UUI વાંચે છે અને | અથવા ;થી અલગ કરેલા મૂલ્યોને મંજૂરી આપતું નથી, તેથી એક જ મૂલ્ય મોકલો. હસ્તાંતરણ ID તેમાં સમાઈ જાય છે.
  • Talkdeskના APIs એજન્ટનો ટ્રાન્સક્રિપ્ટ વાંચી શકતા નથી. તેના બદલે હસ્તાંતરણ લુકઅપ અથવા GET /v1/calls/{call_id} વાપરો.