Twilio SMS सूचना

Twilio SMS सेवा के माध्यम से सूचना भेजें।

Twilio SMS सेवा के माध्यम से SMS टेक्स्ट संदेश सूचनाएँ भेजें, जिसमें अनुकूलन योग्य संदेश सामग्री, डायनेमिक वर्कफ़्लो डेटा पैरामीटर, SMS लंबाई सीमाओं के लिए स्वचालित संदेश ट्रंकेशन, कैश-आधारित सत्र ट्रैकिंग का उपयोग करके कूलडाउन थ्रॉटलिंग, और मोबाइल अलर्ट, तात्कालिक सूचनाओं तथा रीयल-टाइम संचार वर्कफ़्लो के लिए वैकल्पिक async बैकग्राउंड निष्पादन शामिल है।

यह ब्लॉक कैसे काम करता है

यह ब्लॉक Twilio SMS API का उपयोग करके फ़ोन नंबरों पर SMS टेक्स्ट संदेश भेजता है और वर्कफ़्लो निष्पादन परिणामों को संदेश सामग्री में एकीकृत करता है। यह ब्लॉक:

1. जांचता है कि disable_sink फ़्लैग के माध्यम से सिंक अक्षम है या नहीं (यदि अक्षम है, तो बिना भेजे तुरंत लौटता है)

2. Twilio क्रेडेंशियल्स (Account SID और Auth Token) के हैश का उपयोग करके कूलडाउन ट्रैकिंग के लिए एक कैश कुंजी जनरेट करता है और cooldown_session_key (प्रत्येक वर्कफ़्लो चरण के लिए अद्वितीय)

3. कैश में अंतिम सूचना टाइमस्टैम्प की जाँच करके कूलडाउन अवधि को सत्यापित करता है (यदि सक्षम है, तो सूचनाओं को भीतर थ्रॉटल करता है cooldown_seconds अंतिम भेजे गए SMS के, थ्रॉटलिंग स्थिति लौटाता है)

4. प्रदान किए गए क्रेडेंशियल्स के लिए एक Twilio Client instance बनाता है या प्राप्त करता है (दक्षता के लिए क्लाइंट्स को क्रेडेंशियल हैश के आधार पर कैश करता है)

5. डायनेमिक पैरामीटरों को प्रोसेस करके संदेश को फ़ॉर्मैट करता है (जैसे प्लेसहोल्डर्स को प्रतिस्थापित करता है {{ $parameters.parameter_name }} को इससे प्राप्त वास्तविक वर्कफ़्लो डेटा से message_parameters)

6. सम्मिलन से पहले पैरामीटर मानों को परिवर्तित करने के लिए वैकल्पिक UQL ऑपरेशन लागू करता है (उदाहरण के लिए, डिटेक्शन से वर्ग नाम निकालना, मेट्रिक्स की गणना करना, डेटा फ़िल्टर करना) message_parameters_operations

7. यदि यह इससे अधिक हो जाता है तो संदेश को ट्रंकेट करता है length_limit अक्षर (ट्रंकेशन मार्कर जोड़ता है [...] ट्रंकेशन को दर्शाने के लिए)

8. Twilio के messages.create API

9. कैश को वर्तमान सूचना टाइमस्टैम्प से अद्यतन करता है (15 मिनट बाद समाप्त हो जाता है)

10. इस पर आधारित होकर समकालिक या असमकालिक रूप से निष्पादित करता है fire_and_forget सेटिंग:

    • समकालिक मोड (fire_and_forget=False): Twilio API कॉल के पूर्ण होने की प्रतीक्षा करता है, डिबगिंग के लिए वास्तविक त्रुटि स्थिति लौटाता है

    • असमकालिक मोड (fire_and_forget=True): बैकग्राउंड टास्क में SMS भेजता है, वर्कफ़्लो तुरंत जारी रहता है, त्रुटि स्थिति हमेशा False रहती है

11. सफलता, थ्रॉटलिंग, या त्रुटियों को दर्शाने वाले स्थिति आउटपुट लौटाता है (उपलब्ध होने पर Twilio API त्रुटि विवरण शामिल हैं)

यह ब्लॉक पैरामीटर प्लेसहोल्डर्स के माध्यम से डायनेमिक संदेश सामग्री का समर्थन करता है, जिन्हें रनटाइम पर वर्कफ़्लो डेटा से प्रतिस्थापित किया जाता है। संदेश पैरामीटर कच्चे वर्कफ़्लो आउटपुट हो सकते हैं या UQL ऑपरेशनों (उदा., गुण निकालना, गणनाएँ करना, मान फ़िल्टर करना) का उपयोग करके रूपांतरित किए जा सकते हैं। SMS मानकों के अनुपालन और संदेश डिलीवरी समस्याओं को रोकने के लिए, यदि SMS संदेश वर्ण सीमा से अधिक हो जाते हैं, तो उन्हें स्वचालित रूप से ट्रंकेट कर दिया जाता है। कूलडाउन सत्र कुंजियों के साथ कैश-आधारित ट्रैकिंग का उपयोग करके भेजने के बीच न्यूनतम समय लागू करके SMS स्पैम को रोकता है, जिससे वितरित या मल्टी-इंस्टेंस वातावरणों में प्रति-चरण थ्रॉटलिंग सक्षम होती है।

आवश्यकताएँ

Twilio खाता कॉन्फ़िगरेशन: SMS क्षमताओं वाला Twilio खाता आवश्यक है:

• twilio_account_sid: Twilio Account SID (में पाया जाता है Twilio Console)

• twilio_auth_token: Twilio Auth Token (Twilio Console में पाया जाता है, सुरक्षा के लिए निजी के रूप में चिह्नित)

• क्रेडेंशियल्स को वर्कफ़्लो इनपुट्स के माध्यम से (सुरक्षा के लिए अनुशंसित) SECRET_KIND selectors का उपयोग करके प्रदान किया जा सकता है, बजाय इसे वर्कफ़्लो परिभाषाओं में संग्रहीत करने के

• देखें Twilio SMS ट्यूटोरियल सेटअप निर्देशों के लिए

फ़ोन नंबर कॉन्फ़िगरेशन: E.164 फ़ॉर्मेट में मान्य फ़ोन नंबर आवश्यक हैं (जैसे, [phone]):

• sender_number: भेजने के लिए Twilio फ़ोन नंबर (यह आपके खाते में Twilio से खरीदा गया नंबर या सत्यापित नंबर होना चाहिए)

• receiver_number: SMS प्राप्त करने के लिए गंतव्य फ़ोन नंबर

कूलडाउन सत्र कुंजी: यह cooldown_session_key आपके वर्कफ़्लो में प्रत्येक Twilio SMS Notification चरण के लिए अद्वितीय होना चाहिए ताकि उचित प्रति-चरण कूलडाउन ट्रैकिंग सक्षम हो सके। कूलडाउन तंत्र 15 मिनट की समाप्ति समय वाली कैश-आधारित संग्रहण प्रणाली का उपयोग करता है, और कूलडाउन सेकंड 0 और 900 (15 मिनट) के बीच होने चाहिए।

संदेश लंबाई सीमा: SMS संदेशों की डिफ़ॉल्ट लंबाई सीमा 160 वर्ण है। इससे अधिक वाले संदेश length_limit को स्वचालित रूप से ट्रंकेशन मार्कर के साथ छोटा कर दिया जाता है ([...]). समायोजित करें length_limit अपनी आवश्यकताओं के अनुसार, लेकिन ध्यान दें कि SMS मानक आमतौर पर एकल-भाग संदेशों के लिए 160 वर्ण या बहु-भाग संदेशों के प्रत्येक खंड के लिए 153 वर्ण का समर्थन करते हैं।

सामान्य उपयोग के मामले

• तात्कालिक चेतावनी सूचनाएँ: जब महत्वपूर्ण स्थितियाँ पता चलें, तो मोबाइल उपकरणों पर SMS अलर्ट भेजें (उदा., अनधिकृत वस्तुएँ मिलने पर सुरक्षा कर्मियों को सूचित करें, सिस्टम में असामान्यताएँ होने पर ऑपरेटरों को सूचित करें, जब पहचान की संख्या महत्वपूर्ण सीमाओं से अधिक हो जाए तब अलर्ट भेजें), जिससे समय-संवेदनशील घटनाओं के लिए तत्काल मोबाइल सूचना सक्षम होती है

• मोबाइल वर्कफ़्लो अपडेट: वर्कफ़्लो निष्पादन स्थिति और महत्वपूर्ण परिणामों के बारे में SMS सूचनाएँ भेजें (उदा., बैच प्रोसेसिंग पूरी होने पर ऑपरेटरों को सूचित करें, तत्काल विफलता अलर्ट भेजें, सिस्टम स्वास्थ्य समस्याओं के बारे में अलर्ट करें), जिससे स्वचालित प्रक्रियाओं में मोबाइल दृश्यता मिलती है

• डिटेक्शन सारांश: पहचान परिणामों और प्रमुख आँकड़ों के साथ SMS संदेश भेजें (उदा., पहचानी गई वस्तुओं की संख्या साझा करें, वर्गीकरण सारांश भेजें, महत्वपूर्ण पहचान अलर्ट शामिल करें), जिससे हितधारक अपने मोबाइल उपकरणों पर महत्वपूर्ण वर्कफ़्लो आउटपुट प्राप्त कर सकें

• आपातकालीन सूचनाएँ: आपातकालीन स्थितियों और महत्वपूर्ण घटनाओं के लिए तत्काल SMS अलर्ट भेजें (उदा., आपातकालीन responders को सूचित करें, रखरखाव टीमों को महत्वपूर्ण समस्याओं के बारे में सूचित करें, तुरंत सिस्टम विफलता सूचनाएँ भेजें), जिससे आपातकालीन प्रतिक्रिया के लिए तेज़ मोबाइल संचार सक्षम होता है

• रीयल-टाइम मोबाइल मॉनिटरिंग: रीयल-टाइम मॉनिटरिंग और स्थिति सूचनाओं के लिए निरंतर SMS अपडेट भेजें (उदा., सिस्टम स्वास्थ्य समस्याओं के बारे में सूचित करें, समय-समय पर प्रदर्शन अलर्ट भेजें, प्रोसेसिंग उपलब्धियों के बारे में अलर्ट करें), जिससे परिचालन मॉनिटरिंग के लिए मोबाइल दृश्यता मिलती है

• ऑन-कॉल अलर्ट: आफ्टर-आवर्स या महत्वपूर्ण समस्याओं के लिए ऑन-कॉल कर्मियों को SMS सूचनाएँ भेजें (उदा., सिस्टम समस्याओं के बारे में ऑन-कॉल इंजीनियरों को अलर्ट करें, पहचाने गए खतरों के बारे में ऑन-कॉल सुरक्षा को सूचित करें, आफ्टर-आवर्स घटना सूचनाएँ भेजें), जिससे ऑन-कॉल स्टाफ के लिए मोबाइल संचार सक्षम होता है

अन्य ब्लॉक्स से कनेक्ट करना

यह ब्लॉक वर्कफ़्लो चरणों से डेटा प्राप्त करता है और SMS सूचनाएँ भेजता है:

• detection या analysis ब्लॉकों के बाद (उदा., Object Detection, Instance Segmentation, Classification) ताकि वस्तुएँ पहचानी जाने, वर्गीकरण होने, या सीमा से अधिक होने पर तत्काल मोबाइल अलर्ट या सारांश भेजे जा सकें, जिससे महत्वपूर्ण घटनाओं के लिए रीयल-टाइम मोबाइल सूचनाएँ सक्षम हों

• डेटा प्रोसेसिंग ब्लॉकों के बाद (उदा., Expression, Property Definition, Detections Filter) ताकि गणना किए गए मेट्रिक्स, रूपांतरित डेटा, या फ़िल्टर किए गए परिणाम SMS सूचनाओं में शामिल किए जा सकें, जिससे संसाधित डेटा के साथ अनुकूलित मोबाइल रिपोर्टिंग सक्षम हो

• सशर्त वर्कफ़्लोज़ में (उदा., Continue If) ताकि SMS सूचनाएँ केवल तब भेजी जाएँ जब विशिष्ट शर्तें पूरी हों, जिससे event-driven मोबाइल अलर्टिंग और तत्काल सूचनाएँ सक्षम हों

• समेकन ब्लॉकों के बाद (उदा., Data Aggregator) ताकि SMS के माध्यम से समय-समय पर विश्लेषणात्मक सारांश और सांख्यिकीय रिपोर्ट भेजी जा सकें, जिससे निर्धारित मोबाइल अपडेट और ट्रेंड विश्लेषण सक्षम हो

• निगरानी वर्कफ़्लोज़ में मोबाइल उपकरणों पर स्थिति अपडेट, त्रुटि सूचनाएँ, या स्वास्थ्य जाँच रिपोर्ट भेजने के लिए, जिससे SMS के माध्यम से स्वचालित सिस्टम मॉनिटरिंग और घटना प्रबंधन सक्षम होता है

• आपातकालीन वर्कफ़्लो के लिए जहाँ तत्काल मोबाइल सूचना महत्वपूर्ण है (उदा., सुरक्षा अलर्ट, सिस्टम विफलताएँ, महत्वपूर्ण पहचान), जिससे समय-संवेदनशील स्थितियों के लिए तेज़ मोबाइल संचार सक्षम होता है

प्रकार पहचानकर्ता

स्टेप में निम्नलिखित पहचानकर्ता का उपयोग करें "type" फ़ील्ड: roboflow_core/twilio_sms_notification@v1 अपने वर्कफ़्लो में ब्लॉक को एक स्टेप के रूप में जोड़ने के लिए।

गुण

नाम	प्रकार	विवरण	संदर्भ
name	str	इस स्टेप के लिए एक विशिष्ट पहचानकर्ता दर्ज करें..	❌
twilio_account_sid	str	Twilio API के साथ प्रमाणित करने के लिए Twilio Account SID। में पाया जाता है Twilio Console Account Info के अंतर्गत। सुरक्षा के लिए इस फ़ील्ड को निजी के रूप में चिह्नित किया गया है। इसे वर्कफ़्लो इनपुट्स के माध्यम से SECRET_KIND selectors का उपयोग करके प्रदान करने की अनुशंसा की जाती है, बजाय इसे वर्कफ़्लो परिभाषाओं में संग्रहीत करने के। SMS संदेश भेजने के लिए Twilio API अनुरोधों को प्रमाणित करने हेतु इसे twilio_auth_token के साथ उपयोग किया जाता है..	✅
twilio_auth_token	str	Twilio API के साथ प्रमाणित करने के लिए Twilio Auth Token। में पाया जाता है Twilio Console Account Info के अंतर्गत (दिखाने के लिए 'show' पर क्लिक करें)। सुरक्षा के लिए इस फ़ील्ड को निजी के रूप में चिह्नित किया गया है। इसे वर्कफ़्लो इनपुट्स के माध्यम से SECRET_KIND selectors का उपयोग करके प्रदान करने की अनुशंसा की जाती है, बजाय इसे वर्कफ़्लो परिभाषाओं में संग्रहीत करने के। SMS संदेश भेजने के लिए Twilio API अनुरोधों को प्रमाणित करने हेतु इसे twilio_account_sid के साथ उपयोग किया जाता है..	✅
sender_number	str	SMS संदेश भेजने के लिए Twilio फ़ोन नंबर। यह E.164 फ़ॉर्मेट में होना चाहिए (उदा., '[phone]') और Twilio से खरीदा गया फ़ोन नंबर या आपके Twilio खाते में सत्यापित नंबर होना चाहिए। यह नंबर प्राप्तकर्ताओं को मिलने वाले SMS संदेशों में प्रेषक के रूप में दिखाई देता है। आप Twilio Console में नंबर खरीद सकते हैं या परीक्षण के लिए trial नंबरों का उपयोग कर सकते हैं..	✅
receiver_number	str	SMS संदेश प्राप्त करने के लिए गंतव्य फ़ोन नंबर। यह E.164 फ़ॉर्मेट में होना चाहिए (उदा., '[phone]')। Twilio trial खातों के लिए, प्राप्तकर्ता नंबरों का आपके Twilio खाते में सत्यापन होना चाहिए। भुगतान किए गए खातों के लिए, आप किसी भी मान्य फ़ोन नंबर पर भेज सकते हैं। यही वह मोबाइल नंबर है जो सूचना प्राप्त करेगा..	✅
message	str	SMS संदेश सामग्री (सादा पाठ)। प्लेसहोल्डर सिंटैक्स का उपयोग करके डायनेमिक पैरामीटरों का समर्थन करता है: {{ $parameters.parameter_name }}. प्लेसहोल्डर्स को रनटाइम पर message_parameters के मानों से प्रतिस्थापित किया जाता है। संदेश बहु-पंक्ति पाठ हो सकता है लेकिन इसे एकल SMS के रूप में भेजा जाएगा। length_limit से अधिक होने वाले संदेशों को स्वचालित रूप से एक ट्रंकेशन मार्कर के साथ छोटा कर दिया जाएगा। उदाहरण: 'पता चला {{ $parameters.num_objects }} वस्तुएँ। अलर्ट: {{ $parameters.classes }}.'.	❌
message_parameters	Dict[str, Union[bool, float, int, str]]	संदेश प्लेसहोल्डरों में उपयोग किए जाने वाले पैरामीटर नामों को वर्कफ़्लो डेटा स्रोतों के साथ मैप करने वाला शब्दकोश। कुंजियाँ संदेश में संदर्भित पैरामीटर नाम हैं जैसे {{ $parameters.key }}; मान वर्कफ़्लो चरण आउटपुट या प्रत्यक्ष मानों के चयनकर्ता हैं। इन मानों को रनटाइम पर संदेश प्लेसहोल्डरों में प्रतिस्थापित किया जाता है। वैकल्पिक रूप से, substitution से पहले पैरामीटर मानों को रूपांतरित करने के लिए message_parameters_operations का उपयोग किया जा सकता है..	✅
message_parameters_operations	Dict[str, List[Union[ClassificationPropertyExtract, ConvertDictionaryToJSON, ConvertImageToBase64, ConvertImageToJPEG, DetectionsFilter, DetectionsOffset, DetectionsPropertyExtract, DetectionsRename, DetectionsSelection, DetectionsShift, DetectionsToDictionary, Divide, ExtractDetectionProperty, ExtractFrameMetadata, ExtractImageProperty, LookupTable, Multiply, NumberRound, NumericSequenceAggregate, PickDetectionsByParentClass, RandomNumber, SequenceAggregate, SequenceApply, SequenceElementsCount, SequenceLength, SequenceMap, SortDetections, StringMatches, StringSubSequence, StringToLowerCase, StringToUpperCase, TimestampToISOFormat, ToBoolean, ToNumber, ToString]]]	message_parameters से पैरामीटर नामों को वैकल्पिक रूप से UQL ऑपरेशन चेन से मैप करने वाला वैकल्पिक शब्दकोश, जो उन्हें संदेश में सम्मिलित करने से पहले पैरामीटर मानों को रूपांतरित करता है। ऑपरेशन क्रम में लागू होते हैं (उदाहरण के लिए, डिटेक्शन से वर्ग नाम निकालना, गिनती की गणना करना, मान फ़िल्टर करना)। कुंजियाँ message_parameters में पैरामीटर नामों से मेल खानी चाहिए। खाली छोड़ें या उन पैरामीटरों को छोड़ दें जिन्हें रूपांतरण की आवश्यकता नहीं है..	❌
fire_and_forget	bool	निष्पादन मोड: असमकालिक बैकग्राउंड भेजने के लिए True (वर्कफ़्लो तुरंत जारी रहता है, error_status हमेशा False, तेज़ निष्पादन), समकालिक भेजने के लिए False (Twilio API कॉल के पूर्ण होने की प्रतीक्षा करता है, डिबगिंग के लिए वास्तविक त्रुटि स्थिति लौटाता है)। Twilio API त्रुटियों को पकड़ने के लिए विकास और डिबगिंग के दौरान इसे False पर सेट करें। जब SMS डिलीवरी का समय महत्वपूर्ण न हो, तो तेज़ वर्कफ़्लो निष्पादन के लिए प्रोडक्शन में इसे True पर सेट करें..	✅
disable_sink	bool	रनटाइम पर SMS सूचना भेजने को निष्क्रिय करने वाला फ़्लैग। जब True हो, तो ब्लॉक SMS भेजना छोड़ देता है और एक निष्क्रिय संदेश लौटाता है। वर्कफ़्लो इनपुट्स के माध्यम से सशर्त सूचना नियंत्रण के लिए उपयोगी (उदा., परीक्षण के लिए कॉलरों को सूचनाएँ निष्क्रिय करने देना, कॉन्फ़िगरेशन के आधार पर सक्षम/अक्षम करना)। रनटाइम नियंत्रण के लिए वर्कफ़्लो इनपुट्स के माध्यम से सेट करें..	✅
cooldown_seconds	int	SMS स्पैम को रोकने के लिए लगातार SMS सूचनाओं के बीच न्यूनतम सेकंड। डिफ़ॉल्ट 5 सेकंड। कूलडाउन को निष्क्रिय करने के लिए 0 पर सेट करें (कोई थ्रॉटलिंग नहीं)। यह 0 और 900 (15 मिनट) के बीच होना चाहिए। कूलडाउन अवधि के दौरान, ब्लॉक throttling_status=True लौटाता है और भेजना छोड़ देता है। कूलडाउन को प्रति चरण cooldown_session_key का उपयोग करके कैश-आधारित संग्रहण (15 मिनट की समाप्ति) के साथ ट्रैक किया जाता है। किसी वर्कफ़्लो में प्रत्येक Twilio SMS Notification चरण के पास उचित प्रति-चरण ट्रैकिंग के लिए एक अद्वितीय cooldown_session_key होना चाहिए..	✅
cooldown_session_key	str	इस Twilio SMS Notification चरण के कूलडाउन ट्रैकिंग सत्र के लिए अद्वितीय पहचानकर्ता। आपके वर्कफ़्लो में प्रत्येक Twilio SMS Notification चरण के लिए यह अद्वितीय होना चाहिए ताकि उचित प्रति-चरण कूलडाउन पृथक्करण सक्षम हो सके। अंतिम सूचना टाइमस्टैम्प को ट्रैक करने के लिए कैश कुंजी बनाने हेतु Twilio क्रेडेंशियल्स हैश के साथ उपयोग किया जाता है। वितरित या मल्टी-इंस्टेंस वातावरणों में, यह सुनिश्चित करता है कि कूलडाउन प्रत्येक चरण पर सही ढंग से काम करे। आम तौर पर स्वचालित रूप से जनरेट किया जाता है या वर्कफ़्लो इनपुट के रूप में दिया जाता है..	❌
length_limit	int	ट्रंकेशन से पहले SMS संदेश में अनुमत अधिकतम वर्णों की संख्या। डिफ़ॉल्ट 160 वर्ण (मानक एकल-भाग SMS लंबाई)। इस सीमा से अधिक संदेशों को स्वचालित रूप से छोटा कर दिया जाता है, और अंतिम वर्णों को एक ट्रंकेशन मार्कर ('[...]') से बदल दिया जाता है। यह 0 से अधिक होना चाहिए। नोट: SMS मानक एकल-भाग संदेशों के लिए 160 वर्ण या बहु-भाग संदेशों के प्रति सेगमेंट 153 वर्ण का समर्थन करते हैं। अपनी आवश्यकताओं के अनुसार समायोजित करें, लेकिन लंबे संदेशों पर Twilio के साथ अतिरिक्त लागत आ सकती है..	✅

यह संदर्भ स्तंभ यह इंगित करता है कि संपत्ति को वर्कफ़्लो रनटाइम में उपलब्ध गतिशील मानों के साथ पैरामीटराइज़ किया जा सकता है वर्कफ़्लो रनटाइम। देखें बाइंडिंग्स अधिक जानकारी के लिए।

रनटाइम संगतता

requires_internet - air-gapped / offline deployments : यह ब्लॉक ऐसी सेवा पर निर्भर करता है जो पूरी तरह ऑफ़लाइन / air-gapped deployments से पहुँचा नहीं जा सकता।

सॉफ्ट - रनटाइम hosted_serverless, dedicated_deployment; निष्पादन दूरस्थ : Cooldown / rate-limit timer process memory में संग्रहीत होता है। stateless या multi-replica HTTP runtimes पर remote step execution के साथ प्रत्येक अनुरोध को एक नया worker मिलता है, इसलिए cooldown throttling नहीं करता। Cooldown केवल persistent WebRTC session में local step execution के साथ दस्तावेज़ के अनुसार काम करता है।

इनपुट और आउटपुट बाइंडिंग्स

उपलब्ध कनेक्शन उसके बाइंडिंग प्रकारों पर निर्भर करते हैं। देखें कि कौन-से बाइंडिंग प्रकार Twilio SMS सूचना संस्करण v1 है।

इनपुट और आउटपुट बाइंडिंग्स

• इनपुट

  • twilio_account_sid (Union[secret, string]): Twilio API के साथ प्रमाणित करने के लिए Twilio Account SID। में पाया जाता है Twilio Console Account Info के अंतर्गत। सुरक्षा के लिए इस फ़ील्ड को निजी के रूप में चिह्नित किया गया है। इसे वर्कफ़्लो इनपुट्स के माध्यम से SECRET_KIND selectors का उपयोग करके प्रदान करने की अनुशंसा की जाती है, बजाय इसे वर्कफ़्लो परिभाषाओं में संग्रहीत करने के। SMS संदेश भेजने के लिए Twilio API अनुरोधों को प्रमाणित करने हेतु इसे twilio_auth_token के साथ उपयोग किया जाता है..

  • twilio_auth_token (Union[secret, string]): Twilio API के साथ प्रमाणित करने के लिए Twilio Auth Token। में पाया जाता है Twilio Console Account Info के अंतर्गत (दिखाने के लिए 'show' पर क्लिक करें)। सुरक्षा के लिए इस फ़ील्ड को निजी के रूप में चिह्नित किया गया है। इसे वर्कफ़्लो इनपुट्स के माध्यम से SECRET_KIND selectors का उपयोग करके प्रदान करने की अनुशंसा की जाती है, बजाय इसे वर्कफ़्लो परिभाषाओं में संग्रहीत करने के। SMS संदेश भेजने के लिए Twilio API अनुरोधों को प्रमाणित करने हेतु इसे twilio_account_sid के साथ उपयोग किया जाता है..

  • sender_number (string): SMS संदेश भेजने के लिए Twilio फ़ोन नंबर। यह E.164 फ़ॉर्मेट में होना चाहिए (उदा., '[phone]') और Twilio से खरीदा गया फ़ोन नंबर या आपके Twilio खाते में सत्यापित नंबर होना चाहिए। यह नंबर प्राप्तकर्ताओं को मिलने वाले SMS संदेशों में प्रेषक के रूप में दिखाई देता है। आप Twilio Console में नंबर खरीद सकते हैं या परीक्षण के लिए trial नंबरों का उपयोग कर सकते हैं..

  • receiver_number (string): SMS संदेश प्राप्त करने के लिए गंतव्य फ़ोन नंबर। यह E.164 फ़ॉर्मेट में होना चाहिए (उदा., '[phone]')। Twilio trial खातों के लिए, प्राप्तकर्ता नंबरों का आपके Twilio खाते में सत्यापन होना चाहिए। भुगतान किए गए खातों के लिए, आप किसी भी मान्य फ़ोन नंबर पर भेज सकते हैं। यही वह मोबाइल नंबर है जो सूचना प्राप्त करेगा..

  • message_parameters (*): संदेश प्लेसहोल्डरों में उपयोग किए जाने वाले पैरामीटर नामों को वर्कफ़्लो डेटा स्रोतों के साथ मैप करने वाला शब्दकोश। कुंजियाँ संदेश में संदर्भित पैरामीटर नाम हैं जैसे {{ $parameters.key }}; मान वर्कफ़्लो चरण आउटपुट या प्रत्यक्ष मानों के चयनकर्ता हैं। इन मानों को रनटाइम पर संदेश प्लेसहोल्डरों में प्रतिस्थापित किया जाता है। वैकल्पिक रूप से, substitution से पहले पैरामीटर मानों को रूपांतरित करने के लिए message_parameters_operations का उपयोग किया जा सकता है..

  • fire_and_forget (boolean): निष्पादन मोड: असमकालिक बैकग्राउंड भेजने के लिए True (वर्कफ़्लो तुरंत जारी रहता है, error_status हमेशा False, तेज़ निष्पादन), समकालिक भेजने के लिए False (Twilio API कॉल के पूर्ण होने की प्रतीक्षा करता है, डिबगिंग के लिए वास्तविक त्रुटि स्थिति लौटाता है)। Twilio API त्रुटियों को पकड़ने के लिए विकास और डिबगिंग के दौरान इसे False पर सेट करें। जब SMS डिलीवरी का समय महत्वपूर्ण न हो, तो तेज़ वर्कफ़्लो निष्पादन के लिए प्रोडक्शन में इसे True पर सेट करें..

  • disable_sink (boolean): रनटाइम पर SMS सूचना भेजने को निष्क्रिय करने वाला फ़्लैग। जब True हो, तो ब्लॉक SMS भेजना छोड़ देता है और एक निष्क्रिय संदेश लौटाता है। वर्कफ़्लो इनपुट्स के माध्यम से सशर्त सूचना नियंत्रण के लिए उपयोगी (उदा., परीक्षण के लिए कॉलरों को सूचनाएँ निष्क्रिय करने देना, कॉन्फ़िगरेशन के आधार पर सक्षम/अक्षम करना)। रनटाइम नियंत्रण के लिए वर्कफ़्लो इनपुट्स के माध्यम से सेट करें..

  • cooldown_seconds (पूर्णांक): SMS स्पैम को रोकने के लिए लगातार SMS सूचनाओं के बीच न्यूनतम सेकंड। डिफ़ॉल्ट 5 सेकंड। कूलडाउन को निष्क्रिय करने के लिए 0 पर सेट करें (कोई थ्रॉटलिंग नहीं)। यह 0 और 900 (15 मिनट) के बीच होना चाहिए। कूलडाउन अवधि के दौरान, ब्लॉक throttling_status=True लौटाता है और भेजना छोड़ देता है। कूलडाउन को प्रति चरण cooldown_session_key का उपयोग करके कैश-आधारित संग्रहण (15 मिनट की समाप्ति) के साथ ट्रैक किया जाता है। किसी वर्कफ़्लो में प्रत्येक Twilio SMS Notification चरण के पास उचित प्रति-चरण ट्रैकिंग के लिए एक अद्वितीय cooldown_session_key होना चाहिए..

  • length_limit (पूर्णांक): ट्रंकेशन से पहले SMS संदेश में अनुमत अधिकतम वर्णों की संख्या। डिफ़ॉल्ट 160 वर्ण (मानक एकल-भाग SMS लंबाई)। इस सीमा से अधिक संदेशों को स्वचालित रूप से छोटा कर दिया जाता है, और अंतिम वर्णों को एक ट्रंकेशन मार्कर ('[...]') से बदल दिया जाता है। यह 0 से अधिक होना चाहिए। नोट: SMS मानक एकल-भाग संदेशों के लिए 160 वर्ण या बहु-भाग संदेशों के प्रति सेगमेंट 153 वर्ण का समर्थन करते हैं। अपनी आवश्यकताओं के अनुसार समायोजित करें, लेकिन लंबे संदेशों पर Twilio के साथ अतिरिक्त लागत आ सकती है..

• आउटपुट

  • error_status (boolean): बूलियन फ़्लैग.

  • throttling_status (boolean): बूलियन फ़्लैग.

  • message (string): स्ट्रिंग मान.

उदाहरण JSON परिभाषा

{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/twilio_sms_notification@v1",
	    "twilio_account_sid": "$inputs.twilio_account_sid",
	    "twilio_auth_token": "$inputs.twilio_auth_token",
	    "sender_number": "[phone]",
	    "receiver_number": "[phone]",
	    "message": "पिछले 5 मिनट के दौरान {{ $parameters.num_instances }} उदाहरणों का पता चला",
	    "message_parameters": {
	        "predictions": "$steps.model.predictions",
	        "reference": "$inputs.reference_class_names"
	    },
	    "message_parameters_operations": {
	        "predictions": [
	            {
	                "property_name": "class_name",
	                "type": "DetectionsPropertyExtract"
	            }
	        ]
	    },
	    "fire_and_forget": "$inputs.fire_and_forget",
	    "disable_sink": false,
	    "cooldown_seconds": "$inputs.cooldown_seconds",
	    "cooldown_session_key": "session-1v73kdhfse",
	    "length_limit": "$inputs.sms_length_limit"
	}