ThunderPhone v3 இப்போது கிடைக்கிறது.நீங்களே தொடங்கலாம்; நிமிடத்திற்கு 2¢ முதல்.அறிவிப்பைப் படிக்கவும்

Contact centers

Zoom Contact Center இலிருந்து இணைக்கவும்

மூன்றாம் தரப்பு voicebot கனெக்டரைப் பயன்படுத்தி Zoom Contact Center அழைப்புகளை ThunderPhone ஏஜென்டுக்கு அனுப்புங்கள்; SIP REFER மூலம் அவற்றை மீண்டும் மனித ஏஜென்டிடம் மாற்றுங்கள்.

Zoom Contact Center ஃப்ளோவில் உள்ள ஒரு Bot விட்ஜெட், Zoom-இன் call sid உடன் அழைப்பாளரை ஏஜென்ட்டிற்கு அனுப்புகிறது. அழைப்பாளருக்கு ஒரு நபர் தேவைப்படும்போது, ஏஜென்ட் Zoom-இன் மனித ஏஜென்ட் முகவரிக்கு SIP REFER அனுப்புகிறது; உங்கள் ஃப்ளோ call sid மூலம் hand-off-ஐப் பெறுகிறது.

தொடங்குவதற்கு முன்

  • ஒரு ThunderPhone ஏஜென்ட் மற்றும் ஒரு நிறுவன API key.
  • உங்கள் நிர்வாகியால் நிர்வகிக்கப்பட்டு Contact Center-க்கு கிடைக்கச் செய்யப்பட்ட, Bot விட்ஜெட்டிற்கான கனெக்டரைக் கொண்ட Zoom Marketplace பொது ஆப் (Zoom-இன் மூன்றாம் தரப்பு voicebot வழிகாட்டி).
  • Zoom-இலிருந்து bot வழங்குநருக்கான ஒரு SIP trunk. Zoom-இன் ISV குழு இதை கட்டங்களாக உருவாக்கும் (கண்டறிதல், staging trunk, பின்னர் production), மேலும் ஆப்பின் Company Name trunk பதிவுடன் துல்லியமாகப் பொருந்த வேண்டும். இந்த அமைப்பு உங்கள் Zoom கணக்கில் மட்டும் அல்லாமல், ThunderPhone ஆதரவு மற்றும் Zoom உடன் தொடங்குகிறது.

1. SIP endpoint-ஐ உருவாக்கவும்

Zoom-இன் கனெக்டர் SIP முகவரியை அல்லாமல், 999 என்று தொடங்கும் 15 இலக்க எண்ணை அழைக்கிறது. கனெக்டரைச் சேமிப்பது அந்த எண்ணை உருவாக்கும். Zoom-இன் trunk, ஆடியோவிற்கு SRTP உடன் port 5061-ல் TLS 1.2-ஐப் பயன்படுத்துகிறது; கடவுச்சொல்லுக்கு பதிலாக Zoom-இன் துணைநெட்வொர்க்குகளால் அனுமதிப்பட்டியலில் சேர்க்கப்படுகிறது. ஆகவே, கனெக்டரின் எண்ணை dial-in எண்ணாகவும் SRTP கட்டாயமாகவும் கொண்டு ஒரு ip_allowlist endpoint-ஐ உருவாக்கவும் (பார்க்கவும் தொலைபேசி எண்ணை அழைக்கும் தளங்கள்):

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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
  • allowed_source_cidrs: Zoom-இலிருந்து பெறப்படும் Zoom-இன் SIP signalling துணைநெட்வொர்க்குகள். ஒவ்வொன்றும் /16 அல்லது அதைவிடக் குறுகலான பொது IPv4 வரம்பாக இருக்க வேண்டும் (IPv6 /48 அல்லது அதைவிடக் குறுகலாக).
  • dial_in_numbers: + இல்லாமல், Zoom அனுப்பும் விதத்திலேயே கனெக்டரின் எண்.
  • srtp: Zoom-இன் trunk எப்போதும் SRTP-ஐப் பயன்படுத்துவதால், required.

Zoom-இன் முகவரிகள் அதன் அனைத்து வாடிக்கையாளர்களாலும் பகிரப்படுகின்றன; எனவே எண்ணை அழைக்கும் வேறு எந்த Zoom வாடிக்கையாளரும் உங்கள் ஏஜென்ட்டை அடைவார். எண்ணை Zoom ஒதுக்குகிறது; அதை வெளியிட வேண்டாம்.

2. சூழலுடன் அழைப்புகளை அனுப்பவும்

உங்கள் ஃப்ளோவில் ஒரு Bot விட்ஜெட்டைச் சேர்த்து, அதை கனெக்டருடன் இணைக்கவும். trunk-ஐ sip.thunderphone.com நோக்கி, port 5061-ல் TLS உடன், request URI மற்றும் To header இரண்டிலும் கனெக்டரின் எண்ணுடன் அமைக்க Zoom-இன் ISV குழுவிடம் கேட்கவும். endpoint UDP-ஐ மறுக்கிறது; எனவே trunk அதற்கு மீண்டும் மாறாமல் இருப்பதை உறுதிசெய்யவும்.

Zoom அனுப்புவது:

  • அழைப்பின் external_call_id ஆகச் சேமிக்கப்படும் X-ZOOM-Call-Sid. Zoom-இன் சொந்த தரவு mapping பக்கத்தில் இது பட்டியலிடப்படவில்லை; மற்றொரு AI வழங்குநரின் Zoom ஒருங்கிணைப்பு இதை ஆவணப்படுத்துகிறது, எனவே உங்கள் முதல் சோதனை அழைப்பில் இதைச் சரிபார்க்கவும்.
  • அழைப்பாளர் அழைத்த எண்ணான X-ZOOM-DNIS, இது {{sip_x_zoom_dnis}} ஆக இருக்கும்.
  • கனெக்டரின் நிலையான URL ஆன X-ZOOM-WEBHOOK.

3. அழைப்பை மீண்டும் பெறுங்கள்

ஏஜென்ட், Zoom-இன் SBC-யில் உள்ள மனித ஏஜென்ட் முகவரிக்கு REFER அனுப்புகிறது. Zoom உங்களுக்கு வழங்கும் SBC முகவரியுடன், இந்த பரிமாற்ற எண்ணைச் சேர்க்கவும் (பார்க்கவும் பரிமாற்ற எண்ணைச் சேர்க்கவும்):

{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}

ஒரு பாட் சூழலை அனுப்ப இரண்டு வழிகள் உள்ளதாக Zoom-இன் வழிகாட்டி விளக்குகிறது: REFER-க்கு முன் கனெக்டரின் நிலையான URL-க்கு ஒரு POST (voicebot_metadata மற்றும் இதுபோன்ற நிகழ்வுகள்), மற்றும் Bot-லிருந்து உள்வரும் என்பதன் கீழ் மேப் செய்யப்பட்ட SIP தலைப்புகள். ThunderPhone நிலையான URL-க்கு பதிவிடாது. REFER-இலிருந்து மேப் செய்யப்பட்ட தலைப்புகளை அது படிக்கிறதா என்பதை Zoom-இன் வழிகாட்டி கூறவில்லை; முயற்சிக்க விரும்பினால், பதிவில் "X-Handoff-Id": "{{handoff_id}}" போன்ற headers-ஐச் சேர்த்து, சோதனை அழைப்பில் சரிபார்க்கவும். அதற்கு முன் மெட்டாடேட்டா POST இல்லாத REFER-ஐ Zoom ஏற்றுக்கொள்கிறதா என்பதையும் Zoom-இடம் உறுதிப்படுத்தவும்.

இரண்டையும் சாராமல் ஹேண்ட்-ஆஃப்பைப் பெற, Bot விட்ஜெட்டுக்குப் பிறகு உங்கள் ஃப்ளோ அதைத் தேடுமாறு அமைக்கவும்; இதற்கு HTTP அழைப்பு அல்லது ஸ்கிரிப்ட் விட்ஜெட்டைப் பயன்படுத்தவும்:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= என்பதற்குப் பிறகு அழைப்பு sid-ஐச் சேர்க்கவும்.
  • தலைப்பு Authorization: Bearer sk_live_….
  • அழைப்பாளரை வழிமாற்றவும் அழைப்பை ஏற்கும் நபருக்கு சுருக்கமாகத் தெரிவிக்கவும் handoff.summary மற்றும் handoff.intent-ஐப் பயன்படுத்தவும்.

இந்த விட்ஜெட்களுக்கான புல-நிலை ஆவணங்களை Zoom வெளியிடவில்லை; எனவே உங்கள் கணக்கில் விட்ஜெட் Authorization தலைப்பை அனுப்ப முடியும் என்பதை உறுதிப்படுத்தவும். பார்க்கவும் ஹேண்ட்-ஆஃப் செய்யப்பட்ட அழைப்பைத் தேடவும்.

இதைச் சோதிக்கவும்

Bot விட்ஜெட்டை அடையும் ஒரு எண்ணுக்கு அழையுங்கள், ஏஜென்டிடம் ஒரு நபரைக் கேளுங்கள், பின்னர் அழைப்பாளர் மனித ஏஜென்டை அடைவதையும் விட்ஜெட் ஹேண்ட்-ஆஃப்பைத் திருப்பி அனுப்புவதையும் சரிபார்க்கவும். அதன் பிறகு GET /v1/calls/{call_id} மூலம் அழைப்பைத் திறக்கவும்: sip_headers-இல் x-zoom-call-sid பட்டியலிடப்பட்டிருக்க வேண்டும்; external_call_id, உங்கள் ஃப்ளோ பயன்படுத்தும் அழைப்பு sid-உடன் பொருந்த வேண்டும்.

வரம்புகள்

  • ThunderPhone கனெக்டரின் நிலையான URL-க்கு பதிவிடாது; எனவே Zoom ஹேண்ட்-ஆஃப்பை தேடல் மூலம் அல்லது உங்கள் சோதனையில் Zoom அவற்றை REFER-இலிருந்து படிப்பதாகத் தெரிந்தால் மேப் செய்யப்பட்ட தலைப்புகள் மூலம் பெறுகிறது.
  • டிரங்கை Zoom-இன் ISV குழு உருவாக்குகிறது; எனவே அதை நீங்களே அமைக்கவோ சோதிக்கவோ முடியாது.