Skip to main content
ThunderPhoneWidget कंपोनेंट म्यूट करने, कॉल समाप्त करने और कनेक्शन स्टेटस दिखाने के लिए बिल्ट-इन कंट्रोल्स के साथ एक ग्लासमॉर्फिक कॉल बार रेंडर करता है। React ऐप में वॉइस AI जोड़ने का यह सबसे तेज़ तरीका है।

इंस्टॉलेशन

बुनियादी उपयोग

विजेट को सही ढंग से रेंडर करने के लिए आपको CSS फ़ाइल ज़रूर इंपोर्ट करनी होगी। इसके बिना, विजेट बिना स्टाइल के होगा।

प्रॉप्स

कंपोनेंट ThunderPhoneWidgetProps के माध्यम से निम्न प्रॉप्स स्वीकार करता है:

उदाहरण

कस्टम रंग के साथ डार्क थीम

कस्टम पोज़िशन

प्रति-सेशन भाषा, वॉइस और कॉन्टेक्स्ट

कॉल शुरू होने पर language, voice, और context props को सेशन रिक्वेस्ट (POST /widget/session) में फॉरवर्ड किया जाता है, जिससे उस सेशन के लिए एजेंट के कॉन्फ़िगर किए गए डिफ़ॉल्ट ओवरराइड हो जाते हैं:
विज़िटर जिस पेज पर है, उसके बारे में एजेंट को तथ्यात्मक नॉलेज देने के लिए context का उपयोग करें — प्रोडक्ट विवरण, मूल्य निर्धारण या पेज-विशिष्ट FAQs। इसे सर्वर-साइड पर 12,000 कैरेक्टर तक ट्रंकेट किया जाता है।

इवेंट कॉलबैक के साथ

कस्टम स्टाइलिंग के साथ

सभी उपलब्ध CSS क्लास और कस्टम प्रॉपर्टी के लिए स्टाइलिंग गाइड देखें।

रिंगटोन के साथ

कनेक्शन स्थापित होने के दौरान फ़ोन की घंटी बजने की आवाज़ चलाएं:
ऑडियो फ़ाइल URL पास करके कस्टम रिंगटोन का उपयोग करें:
विजेट connecting स्टेट में होने पर रिंगटोन लूप होती है और एजेंट के कनेक्ट होने पर धीरे-धीरे फेड आउट हो जाती है।

कस्टम API बेस के साथ

आपको apiBase केवल तब सेट करना होगा जब आप सेल्फ़-होस्टेड या प्रॉक्सी API एंडपॉइंट का उपयोग कर रहे हों। डिफ़ॉल्ट रूप से यह https://api.thunderphone.com/v1 पर पॉइंट करता है।

एरर हैंडलिंग

जब onError कॉलबैक फायर होता है, तो उसे दो फ़ील्ड वाला एक एरर ऑब्जेक्ट मिलता है: सामान्य एरर कोड में डोमेन की अनुमति नहीं है, एजेंट नहीं मिला, और अमान्य API key शामिल हैं।

अगले चरण

हेडलेस हुक

UI पर पूरा नियंत्रण चाहिए? इसके बजाय useThunderPhone हुक का उपयोग करें।

स्टाइलिंग

CSS कस्टम प्रॉपर्टीज़ के साथ रंग, आकार और लेआउट कस्टमाइज़ करें।