अवलोकन

SurveyAnalytica आपको अपने कैंपेन और वर्कफ़्लो के हिस्से के रूप में SMS भेजने और प्राप्त करने के लिए Telnyx या Twilio से अपना खुद का फ़ोन नंबर कनेक्ट करने देता है। कनेक्ट होने के बाद, संपर्कों के जवाब सीधे आपके कन्वर्सेशन व्यू में आते हैं।

शुरू करने से पहले

• Telnyx या Twilio से खरीदा गया एक फ़ोन नंबर।
• उस नंबर के लिए API क्रेडेंशियल्स (नीचे चरण 2 देखें)।
• SurveyAnalytica के अंदर एक वर्कस्पेस जिसे नंबर असाइन करना है।

चरण 1: फ़ोन नंबर खरीदें

यदि आपके पास अभी तक कोई नंबर नहीं है, तो अपने चुने हुए प्रोवाइडर से एक खरीदें:

• Telnyx — Telnyx पोर्टल में नंबर खोजें और खरीदें
• Twilio — Twilio कंसोल में नंबर खोजें और खरीदें

पूरे नंबर को अंतरराष्ट्रीय फ़ॉर्मैट में नोट कर लें, उदाहरण के लिए +14155551234।

चरण 2: अपने API क्रेडेंशियल्स प्राप्त करें

Telnyx

1. Telnyx पोर्टल में लॉग इन करें।
2. Auth > API Keys पर जाएँ।
3. Create API Key पर क्लिक करें (या KEY... से शुरू होने वाली मौजूदा key कॉपी करें)।
4. पूरी key कॉपी करें — आप इसे SurveyAnalytica में API Key फ़ील्ड में पेस्ट करेंगे।

Twilio

1. Twilio कंसोल में लॉग इन करें।
2. होम डैशबोर्ड पर, अपना Account SID और Auth Token खोजें।
3. उन्हें AccountSID:AuthToken फ़ॉर्मैट में मिलाएँ (कोलन से अलग, बिना स्पेस के)।
4. इस मिले हुए मान को SurveyAnalytica में API Key फ़ील्ड में पेस्ट करें।

चरण 3: SurveyAnalytica में नंबर कनेक्ट करें

1. Account > Domains & Numbers पर जाएँ और SMS टैब खोलें।
2. कनेक्शन फ़ॉर्म भरें:

फ़ील्ड	क्या दर्ज करें
Provider	अपने नंबर से मेल खाने के लिए Telnyx या Twilio चुनें।
Phone Number (E.164)	आपका नंबर अंतरराष्ट्रीय फ़ॉर्मैट में, जैसे +14155551234। + से शुरू होकर उसके बाद कंट्री कोड होना चाहिए।
API Key	आपकी Telnyx API key (KEY...), या आपका Twilio AccountSID:AuthToken।
Display Name (वैकल्पिक)	एक फ्रेंडली लेबल, जैसे Support Line। खाली छोड़ने पर डिफ़ॉल्ट रूप से फ़ोन नंबर दिखेगा।

3. Connect पर क्लिक करें। यदि क्रेडेंशियल्स गलत हैं तो एक एरर मैसेज दिखाई देगा — API key दोबारा जाँचें और फिर से कोशिश करें।

चरण 4: नंबर को वर्कस्पेस में असाइन करें

प्रत्येक कनेक्टेड नंबर को एक वर्कस्पेस में असाइन किया जा सकता है। एक बार नंबर सूची में दिखाई देने पर:

1. नंबर कार्ड पर Assign to workspace ड्रॉपडाउन का उपयोग करें।
2. Save पर क्लिक करें।

अब उस वर्कस्पेस में SMS कैंपेन या कन्वर्सेशन बनाते समय यह नंबर उपलब्ध होगा।

वेबहुक स्थिति

प्रत्येक नंबर कार्ड एक Webhook Active या Webhook Not Configured बैज दिखाता है जो अपने आप रिफ्रेश होता है।

• Webhook Active — इनबाउंड जवाब और डिलीवरी अपडेट सही तरीके से प्राप्त हो रहे हैं।
• Webhook Not Configured — SurveyAnalytica प्रोवाइडर के साथ इनकमिंग मैसेज हैंडलर रजिस्टर नहीं कर सका। जाँचें कि API key अभी भी वैध है, फिर नंबर हटाकर दोबारा जोड़ने की कोशिश करें।

नंबर हटाएँ

नंबर को डिस्कनेक्ट करने के लिए नंबर कार्ड पर Delete पर क्लिक करें। नंबर आपके Telnyx या Twilio अकाउंट में बना रहेगा लेकिन SurveyAnalytica में इनबाउंड मैसेज प्राप्त करना बंद कर देगा।

समस्या निवारण

लक्षण	क्या जाँचें
“Failed to connect number” एरर	सत्यापित करें कि API key सही है और एक्सपायर नहीं हुई है। Twilio के लिए, पुष्टि करें कि फ़ॉर्मैट बिना अतिरिक्त स्पेस के AccountSID:AuthToken है।
फ़ोन नंबर अस्वीकृत	सुनिश्चित करें कि नंबर E.164 फ़ॉर्मैट में है: + से शुरू, फिर कंट्री कोड, फिर नंबर — कोई स्पेस या डैश नहीं।
कनेक्ट करने के बाद Webhook Not Configured	बैज के रिफ्रेश होने का थोड़ा इंतज़ार करें। अगर यह ऑरेंज ही रहता है, तो नंबर को हटाएँ और एक नई API key के साथ दोबारा कनेक्ट करें।
इनबाउंड मैसेज नहीं दिख रहे	पुष्टि करें कि नंबर सही वर्कस्पेस में असाइन है और वेबहुक बैज Active दिखा रहा है।