ThunderPhone v3 आता लाइव्ह आहे.स्वतःच सुरू करा—2¢/मिनिटपासून.घोषणा वाचा

Contact centers

Zoom Contact Center वरून कनेक्ट करा

तृतीय-पक्ष व्हॉइसबॉट कनेक्टरद्वारे Zoom Contact Center कॉल ThunderPhone एजंटकडे पाठवा आणि SIP REFER वापरून ते पुन्हा मानवी एजंटकडे हस्तांतरित करा.

Zoom Contact Center फ्लोमधील बॉट विजेट कॉलरला Zoom च्या कॉल sid सह एजंटकडे पाठवते. कॉलरला एखाद्या व्यक्तीची आवश्यकता असल्यास, एजंट Zoom च्या मानवी-एजंट पत्त्यावर SIP REFER पाठवतो आणि तुमचा फ्लो कॉल sid द्वारे हस्तांतरण मिळवतो.

सुरू करण्यापूर्वी

  • ThunderPhone एजंट आणि संस्थेची API की.
  • तुमच्या प्रशासकाद्वारे व्यवस्थापित आणि Contact Center साठी उपलब्ध केलेले Zoom Marketplace सामान्य अॅप, ज्यामध्ये बॉट विजेटसाठी कनेक्टर आहे (Zoom चे तृतीय-पक्ष व्हॉइसबॉट मार्गदर्शक).
  • Zoom कडून बॉट प्रदात्याकडे SIP ट्रंक. Zoom ची ISV टीम ते टप्प्याटप्प्याने तयार करते (शोध, स्टेजिंग ट्रंक, नंतर उत्पादन), आणि अॅपचे कंपनीचे नाव ट्रंक रेकॉर्डशी अचूक जुळले पाहिजे. ही मांडणी केवळ तुमच्या Zoom खात्यातून नव्हे, तर ThunderPhone समर्थन आणि Zoom सह सुरू होते.

1. SIP एंडपॉइंट तयार करा

Zoom चा कनेक्टर SIP पत्त्याऐवजी 999 ने सुरू होणारा 15-अंकी क्रमांक डायल करतो. कनेक्टर जतन केल्यावर हा क्रमांक तयार होतो. Zoom चा ट्रंक पोर्ट 5061 वर TLS 1.2 आणि ऑडिओसाठी SRTP वापरतो, तसेच पासवर्डऐवजी Zoom च्या सबनेटद्वारे अनुमती-सूचीत ठेवला जातो. त्यामुळे कनेक्टरचा क्रमांक डायल-इन क्रमांक म्हणून आणि SRTP आवश्यक ठेवून 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": "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 सिग्नलिंग सबनेट. प्रत्येक सार्वजनिक IPv4 श्रेणी /16 किंवा त्यापेक्षा अरुंद असणे आवश्यक आहे (IPv6 /48 किंवा त्यापेक्षा अरुंद).
  • dial_in_numbers: Zoom ज्या प्रकारे पाठवते त्याच प्रकारे कनेक्टरचा क्रमांक, + शिवाय.
  • srtp: required, कारण Zoom चा ट्रंक नेहमी SRTP वापरतो.

Zoom चे पत्ते त्याच्या सर्व ग्राहकांमध्ये सामायिक असतात, त्यामुळे क्रमांक डायल करणारा इतर कोणताही Zoom ग्राहक तुमच्या एजंटकडे पोहोचतो. Zoom हा क्रमांक नियुक्त करते; तो प्रकाशित करू नका.

2. संदर्भासह कॉल पाठवा

तुमच्या फ्लोमध्ये बॉट विजेट जोडा आणि ते कनेक्टरशी जोडा. Zoom च्या ISV टीमला ट्रंक sip.thunderphone.com कडे, पोर्ट 5061 वर TLS सह, विनंती URI आणि To हेडर या दोन्हीमध्ये कनेक्टरचा क्रमांक ठेवून निर्देशित करण्यास सांगा. एंडपॉइंट UDP नाकारतो, त्यामुळे ट्रंक त्यावर परत जाणार नाही याची खात्री करा.

Zoom पाठवते:

  • X-ZOOM-Call-Sid, कॉलचा external_call_id म्हणून संचयित केला जातो. Zoom च्या स्वतःच्या डेटा मॅपिंग पृष्ठावर तो सूचीबद्ध नाही; दुसऱ्या AI प्रदात्याच्या Zoom एकीकरणाच्या दस्तऐवजीकरणात तो आहे, म्हणून तुमच्या पहिल्या चाचणी कॉलमध्ये तो तपासा.
  • X-ZOOM-DNIS, कॉलरने डायल केलेला क्रमांक, {{sip_x_zoom_dnis}} म्हणून.
  • X-ZOOM-WEBHOOK, कनेक्टरचा स्थिर URL.

3. कॉल परत मिळवा

एजंट Zoom च्या SBC वरील मानवी-एजंट पत्त्यावर REFER पाठवतो. Zoom तुम्हाला देत असलेल्या SBC पत्त्यासह हा हस्तांतरण क्रमांक जोडा (पहा हस्तांतरण क्रमांक जोडा):

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

Zoom च्या मार्गदर्शिकेत बॉट संदर्भ पुढे पाठवण्याचे दोन मार्ग वर्णन केले आहेत: REFER पूर्वी कनेक्टरच्या स्थिर URL वर POST करणे (voicebot_metadata आणि तत्सम इव्हेंट), आणि बॉटकडून येणारे अंतर्गत मॅप केलेले SIP हेडर. ThunderPhone स्थिर URL वर POST पाठवत नाही. Zoom च्या मार्गदर्शिकेत ते REFER मधून मॅप केलेले हेडर वाचते की नाही हे सांगितलेले नाही; तुम्हाला प्रयत्न करायचा असल्यास, एंट्रीमध्ये "X-Handoff-Id": "{{handoff_id}}" सारखे headers जोडा आणि चाचणी कॉलवर तपासा. तसेच Zoom कडून पुष्टी करून घ्या की ते त्यापूर्वी मेटाडेटा POST नसलेला REFER स्वीकारते.

या दोन्हींवर अवलंबून न राहता हस्तांतरण मिळवण्यासाठी, 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 वर POST पाठवत नाही, त्यामुळे Zoom ला हस्तांतरण लुकअपद्वारे मिळते किंवा तुमच्या चाचणीत Zoom REFER मधून ते वाचते असे दिसल्यास मॅप केलेल्या हेडरद्वारे मिळते.
  • ट्रंक Zoom च्या ISV टीमने तयार केलेला आहे, त्यामुळे तुम्ही तो स्वतः सेट अप किंवा चाचणी करू शकत नाही.