वर्कस्पेस
Bird में आपका वर्कस्पेस काम की इकाई है। इसमें आपके डोमेन, API कुंजियाँ, भेजे गए संदेश और टीम एक्सेस रहते हैं। डैशबोर्ड वर्कस्पेस को केंद्र में रखकर बना है, और हर कार्रवाई आपके वर्कस्पेस के भीतर होती है। आपका अकाउंट एक ही क्षेत्र से जुड़ा होता है और उसमें आपकी बिलिंग जानकारी रहती है।
मौजूदा वर्कस्पेस का नाम बदलने के लिए Settings > General खोलें, Name संपादित करें, फिर सहेजने के लिए फ़ील्ड से बाहर निकलें। संपादन के लिए आपके पास उस वर्कस्पेस को प्रबंधित करने की अनुमति होनी चाहिए।
नया वर्कस्पेस बनाने के लिए अपने संगठन का Workspaces पेज खोलें और Create workspace चुनें। Workspace name दर्ज करें और पुष्टि करें। यह विकल्प आपके संगठन की एक्सेस और वर्कस्पेस सीमा पर निर्भर करता है। अगर बनाने का विकल्प बंद है, तो वहाँ दिखाया गया कारण देखें। किसी मौजूदा वर्कस्पेस पर स्विच करने से नया वर्कस्पेस नहीं बनता।
क्षेत्र
आपका अकाउंट ठीक एक क्षेत्र से जुड़ा होता है: us1 (संयुक्त राज्य अमेरिका) या eu1 (यूरोपीय संघ)। क्षेत्र साइनअप के समय चुना जाता है और बाद में बदला नहीं जा सकता, क्योंकि आपका डेटा और भेजने का इन्फ्रास्ट्रक्चर वहीं रहता है। API ट्रैफ़िक उसी क्षेत्र के होस्ट, https://us1.platform.bird.com या https://eu1.platform.bird.com, पर जाता है। हर API कुंजी के प्रीफ़िक्स (bk_us1_...) में क्षेत्र शामिल होता है, इसलिए अनुरोध अपने आप सही जगह पहुँचते हैं। रूटिंग के नियमों और गलत क्षेत्र में पहुँचे अनुरोध के साथ क्या होता है, यह जानने के लिए बेस URL और क्षेत्र देखें।
अनुरोध आपके वर्कस्पेस तक कैसे पहुँचता है
Bird का API सपाट रूट (/v1/email/messages, /v1/sms/messages) इस्तेमाल करता है, जिनके पाथ में वर्कस्पेस का कोई हिस्सा नहीं होता। इसके बजाय संदर्भ क्रेडेंशियल में होता है। API कुंजी आपके वर्कस्पेस से बंधी होती है, और इसी से उसका संगठन और क्षेत्र भी तय हो जाता है। इसलिए अनुरोध को कुंजी के अलावा कुछ और नहीं चाहिए। अगर कोई अनुरोध ऐसा संदर्भ बताता है जो उसकी कुंजी से मेल नहीं खाता, तो उसे चुपचाप दूसरे अर्थ में लेने के बजाय गलत बनावट वाला मानकर अस्वीकार किया जाता है (400)।
उसके बाद अनुरोध की अनुमति है या नहीं, यह अलग सवाल है। API कुंजियों के लिए इसका जवाब कुंजी स्कोप देते हैं, और डैशबोर्ड में काम करने वाले लोगों के लिए भूमिकाएँ।
संगठन बंद करना
संगठन बंद करना स्थायी है, और इसे जानबूझकर ऐसा बनाया गया है कि यह गलती से न हो। मालिक इसका अनुरोध करता है, और Bird एक पुष्टि लिंक ईमेल करता है। जब तक आप उस लिंक पर जाकर पुष्टि नहीं करते, तब तक कुछ नहीं बदलता। किसी संगठन के बजाय अपना उपयोगकर्ता अकाउंट बंद करने के लिए अपना अकाउंट बंद करें देखें।
पुष्टि होने के बाद:
- लॉकआउट तुरंत होता है। आपका अकाउंट डैशबोर्ड से गायब हो जाता है, उसकी API कुंजियाँ प्रमाणीकरण करना बंद कर देती हैं और रद्द कर दी जाती हैं, भेजना बंद हो जाता है, और कोई भी सक्रिय सदस्यता रद्द कर दी जाती है।
- इसके बाद 7 दिन की छूट अवधि मिलती है। डेटा, कॉन्फ़िगरेशन और टीम सदस्यताएँ बिना किसी बदलाव के बनी रहती हैं। बंद करने की सूचना वाले ईमेल में रद्द करने का लिंक होता है, और इस अवधि के भीतर उस लिंक पर जाने से पहुँच बहाल हो जाती है। API कुंजियों को छोड़कर सब कुछ वापस आ जाता है। ये कुंजियाँ लॉकआउट के समय रद्द कर दी गई थीं, इसलिए इन्हें फिर से जारी करना होगा।
- फिर डेटा स्थायी रूप से मिटा दिया जाता है। अवधि खत्म होने के बाद सफ़ाई प्रक्रिया चलती है और सब कुछ हटा देती है: डोमेन, सप्रेशन, वेबहुक एंडपॉइंट, टेम्पलेट, सदस्यताएँ और डेटा। मिटाना शुरू होने के बाद कुछ भी वापस नहीं पाया जा सकता।
अगले कदम
- प्रमाणीकरण और API कुंजियाँ: कुंजियाँ किसी वर्कस्पेस से कैसे जुड़ती हैं
- उपयोगकर्ता, टीमें और भूमिकाएँ: वर्कस्पेस भूमिकाएँ और एक्सेस नियंत्रण, जिसमें बिलिंग के लिए अकाउंट-स्तर की भूमिकाएँ भी शामिल हैं
- बेस URL और क्षेत्र: क्षेत्रीय होस्ट और रूटिंग
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।