Twilio SMS/MMS सूचना

Twilio के माध्यम से SMS/MMS सूचनाएँ भेजें।

यह Twilio SMS/MMS सूचना यह ब्लॉक उपयोगकर्ताओं को वर्कफ़्लो के हिस्से के रूप में पाठ और मल्टीमीडिया संदेश भेजने की अनुमति देता है।

SMS प्रदाता विकल्प

यह ब्लॉक एक ड्रॉपडाउन चयनकर्ता के माध्यम से दो SMS वितरण विधियों का समर्थन करता है:

1. Roboflow प्रबंधित API कुंजी (डिफ़ॉल्ट) - किसी Twilio कॉन्फ़िगरेशन की आवश्यकता नहीं है। संदेश Roboflow की प्रॉक्सी सेवा के माध्यम से भेजे जाते हैं:

   • सरल सेटअप - बस संदेश, प्राप्तकर्ता, और वैकल्पिक मीडिया दें

   • सुरक्षित - प्रमाणीकरण के लिए आपकी वर्कफ़्लो API कुंजी का उपयोग किया जाता है

   • Twilio खाता आवश्यक नहीं

   • मूल्य निर्धारण: अमेरिका/कनाडा: प्रति क्रेडिट 30 संदेश। अंतरराष्ट्रीय: प्रति क्रेडिट 10 संदेश। (SMS और MMS की कीमत समान है)

2. कस्टम Twilio - अपना स्वयं का Twilio खाता उपयोग करें:

   • संदेश डिलीवरी पर पूर्ण नियंत्रण

   • Twilio क्रेडेंशियल्स (Account SID, Auth Token, Phone Number) की आवश्यकता है

   • आप मैसेजिंग के लिए सीधे Twilio को भुगतान करते हैं

संदेश सामग्री

• प्राप्तकर्ता नंबर: संदेश प्राप्त करने के लिए फ़ोन नंबर (E.164 प्रारूप में होना चाहिए, जैसे [phone])

• संदेश: SMS/MMS का मुख्य संदेश. संदेश को वर्कफ़्लो रन के दौरान उत्पन्न डेटा के साथ पैरामीटराइज़ किया जा सकता है। देखें गतिशील पैरामीटर अनुभाग।

• मीडिया URL (वैकल्पिक): MMS संदेशों के लिए, छवि URL या विज़ुअलाइज़ेशन ब्लॉक्स के छवि आउटपुट प्रदान करें

गतिशील पैरामीटर

संदेश सामग्री को Workflow निष्पादन परिणामों के साथ पैरामीटराइज़ किया जा सकता है। उदाहरण:

message = "चेतावनी! {{ $parameters.num_detections }} ऑब्जेक्ट्स मिले"

संदेश पैरामीटर इसके माध्यम से सेट किए जाते हैं message_parameters:

message_parameters = {
    "num_detections": "$steps.model.predictions"
}

डेटा को इसके माध्यम से रूपांतरित करें message_parameters_operations:

message_parameters_operations = {
    "predictions": [
        {"type": "DetectionsPropertyExtract", "property_name": "class_name"}
    ]
}

MMS समर्थन

प्रदान करके अपने संदेश के साथ छवियाँ भेजें media_url:

• छवि URL: सार्वजनिक रूप से सुलभ छवि URL को एक स्ट्रिंग या सूची के रूप में प्रदान करें

• वर्कफ़्लो छवियाँ: विज़ुअलाइज़ेशन ब्लॉक्स से छवि आउटपुट का संदर्भ दें

• Base64 छवियाँ: छवियाँ स्वचालित रूप से ट्रांसमिशन के लिए परिवर्तित हो जाती हैं

उदाहरण:

media_url = "$steps.bounding_box_visualization.image"

या कई छवियाँ:

media_url = ["https://example.com/image1.jpg", "https://example.com/image2.jpg"]

नोट: MMS मुख्य रूप से अमेरिका/कनाडा में समर्थित है। अंतरराष्ट्रीय MMS उपलब्धता कैरियर के अनुसार भिन्न होती है।

कस्टम Twilio का उपयोग

अपना स्वयं का Twilio खाता उपयोग करने के लिए, "Custom Twilio" चुनें और कॉन्फ़िगर करें:

• twilio_account_sid - Twilio Console से आपका Twilio Account SID Twilio Console

• twilio_auth_token - आपका Twilio Auth Token

• sender_number - आपका Twilio फ़ोन नंबर (E.164 प्रारूप में होना चाहिए)

कूलडाउन

ब्लॉक cooldown_seconds (डिफ़ॉल्ट रूप से 5 सेकंड) ताकि सूचनाओं की बौछार रोकी जा सके। सेट करें 0 बिना कूलडाउन के लिए।

कूलडाउन के दौरान, throttling_status आउटपुट को सेट किया जाता है True और कोई संदेश नहीं भेजा जाता।

कूलडाउन सीमाएँ

कूलडाउन केवल वीडियो प्रोसेसिंग तक सीमित है। HTTP सेवा वर्कफ़्लो (Roboflow Hosted API, Dedicated Deployment) में इस ब्लॉक का उपयोग करने पर HTTP अनुरोधों के लिए कोई कूलडाउन प्रभाव नहीं होता।

असिंक्रोनस निष्पादन

सेट करें fire_and_forget=True पृष्ठभूमि में संदेश भेजने के लिए, जिससे Workflow आगे बढ़ सके. असिंक्रोनस मोड में, error_status हमेशा False. सेट करें fire_and_forget=False डीबगिंग के लिए।

सूचनाएँ निष्क्रिय करना

सेट करें disable_sink वर्कफ़्लो इनपुट के माध्यम से नोटिफ़ायर ब्लॉक को मैन्युअल रूप से निष्क्रिय करने के लिए फ़्लैग।

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

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

गुण

नाम	प्रकार	विवरण	संदर्भ
name	str	इस स्टेप के लिए एक विशिष्ट पहचानकर्ता दर्ज करें..	❌
sms_provider	str	SMS वितरण विधि चुनें: Roboflow की प्रबंधित सेवा का उपयोग करें या अपना स्वयं का Twilio खाता कॉन्फ़िगर करें..	❌
receiver_number	str	संदेश प्राप्त करने के लिए फ़ोन नंबर (E.164 प्रारूप, जैसे [phone])।	✅
message	str	भेजे जाने वाले संदेश की सामग्री..	❌
message_parameters	Dict[str, Union[bool, float, int, str]]	संदेश के भीतर उपयोग किया जाने वाला डेटा..	✅
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]]]	संदेश पैरामीटरों पर किए जाने वाले पूर्व-प्रसंस्करण ऑपरेशन..	❌
media_url	Optional[List[str], str]	MMS के लिए वैकल्पिक मीडिया URL(स)। सार्वजनिक रूप से सुलभ छवि URL या वर्कफ़्लो ब्लॉक्स के छवि आउटपुट प्रदान करें..	✅
twilio_account_sid	str	Twilio Console से Twilio Account SID..	✅
twilio_auth_token	str	Twilio Console से Twilio Auth Token..	✅
sender_number	str	प्रेषक फ़ोन नंबर (E.164 प्रारूप, जैसे [phone])।	✅
fire_and_forget	bool	तेज़ वर्कफ़्लोज़ के लिए ब्लॉक को असमकालिक रूप से (True) या डिबगिंग और त्रुटि प्रबंधन के लिए समकालिक रूप से (False) चलाने वाला बूलियन फ़्लैग..	✅
disable_sink	bool	ब्लॉक निष्पादन को अक्षम करने वाला बूलियन फ़्लैग..	✅
cooldown_seconds	int	फॉलो-अप सूचना भेजे जाने तक के सेकंडों की संख्या..	✅

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

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

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/MMS सूचना संस्करण v2 है।

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

• इनपुट

  • receiver_number (string): संदेश प्राप्त करने के लिए फ़ोन नंबर (E.164 प्रारूप, जैसे [phone])।

  • message_parameters (*): संदेश के भीतर उपयोग किया जाने वाला डेटा..

  • media_url (Union[list_of_values, छवि, string]): MMS के लिए वैकल्पिक मीडिया URL(स)। सार्वजनिक रूप से सुलभ छवि URL या वर्कफ़्लो ब्लॉक्स के छवि आउटपुट प्रदान करें..

  • twilio_account_sid (Union[secret, string]): Twilio Console से Twilio Account SID..

  • twilio_auth_token (Union[secret, string]): Twilio Console से Twilio Auth Token..

  • sender_number (string): प्रेषक फ़ोन नंबर (E.164 प्रारूप, जैसे [phone])।

  • fire_and_forget (boolean): तेज़ वर्कफ़्लोज़ के लिए ब्लॉक को असमकालिक रूप से (True) या डिबगिंग और त्रुटि प्रबंधन के लिए समकालिक रूप से (False) चलाने वाला बूलियन फ़्लैग..

  • disable_sink (boolean): ब्लॉक निष्पादन को अक्षम करने वाला बूलियन फ़्लैग..

  • cooldown_seconds (पूर्णांक): फॉलो-अप सूचना भेजे जाने तक के सेकंडों की संख्या..

• आउटपुट

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

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

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

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

{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/twilio_sms_notification@v2",
	    "sms_provider": "Roboflow प्रबंधित API कुंजी",
	    "receiver_number": "[phone]",
	    "message": "चेतावनी! {{ $parameters.num_detections }} ऑब्जेक्ट्स मिले",
	    "message_parameters": {
	        "num_detections": "$steps.model.predictions",
	        "reference": "$inputs.reference_class_names"
	    },
	    "message_parameters_operations": {
	        "predictions": [
	            {
	                "property_name": "class_name",
	                "type": "DetectionsPropertyExtract"
	            }
	        ]
	    },
	    "media_url": "$steps.visualization.image",
	    "twilio_account_sid": "$inputs.twilio_account_sid",
	    "twilio_auth_token": "$inputs.twilio_auth_token",
	    "sender_number": "[phone]",
	    "fire_and_forget": "$inputs.fire_and_forget",
	    "disable_sink": false,
	    "cooldown_seconds": "$inputs.cooldown_seconds"
	}