Twilio SMS Notification

Class: TwilioSMSNotificationBlockV1

Source: inference.core.workflows.core_steps.sinks.twilio.sms.v1.TwilioSMSNotificationBlockV1

The 📲 Twilio SMS Notification ✉️ block enables sending text message notifications via the Twilio SMS service, with flexible features such as dynamic content, message truncation, and cooldown management.

The block requires Twilio setup - this article may help you configuring everything properly.

✨ Key Features

• 📢 Send SMS: Deliver SMS messages to designated recipients.

• 🔗 Dynamic Content: Craft notifications based on outputs from other Workflow steps.

• ✂️ Message Truncation: Automatically truncate messages exceeding the character limit.

• 🕒 Cooldown Control: Prevent duplicate notifications within a set time frame.

• ⚙️ Flexible Execution: Execute in the background or block Workflow execution for debugging.

Type identifier

Use the following identifier in step "type" field: roboflow_core/twilio_sms_notification@v1to add the block as as step in your workflow.

Properties

Name	Type	Description	Refs
name	str	Enter a unique identifier for this step..	❌
twilio_account_sid	str	Twilio Account SID. Visit the Twilio Console to configure the SMS service and retrieve the value..	✅
twilio_auth_token	str	Twilio Auth Token. Visit the Twilio Console to configure the SMS service and retrieve the value..	✅
sender_number	str	Sender phone number.	✅
receiver_number	str	Receiver phone number.	✅
message	str	Content of the message to be sent..	❌
message_parameters	Dict[str, Union[bool, float, int, str]]	Data to be used in the message content..	✅
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]]]	Preprocessing operations to be performed on message parameters..	❌
fire_and_forget	bool	Boolean flag to run the block asynchronously (True) for faster workflows or synchronously (False) for debugging and error handling..	✅
disable_sink	bool	Boolean flag to disable block execution..	✅
cooldown_seconds	int	Number of seconds until a follow-up notification can be sent. Maximum value: 900 seconds (15 minutes).	✅
cooldown_session_key	str	Unique key used internally to implement cooldown. Must be unique for each step in your Workflow..	❌
length_limit	int	Maximum number of characters in SMS notification (longer messages will be truncated)..	✅

The Refs column marks possibility to parametrise the property with dynamic values available in workflow runtime. See Bindings for more info.

Available Connections

Compatible Blocks

Check what blocks you can connect to Twilio SMS Notification in version v1.

• inputs: Size Measurement, CogVLM, Image Slicer, Clip Comparison, Webhook Sink, Pixelate Visualization, Image Threshold, SmolVLM2, Twilio SMS Notification, Image Slicer, Moondream2, Image Blur, Detections Consensus, Morphological Transformation, Polygon Visualization, Single-Label Classification Model, Florence-2 Model, Time in Zone, Single-Label Classification Model, Background Color Visualization, VLM as Detector, Stability AI Image Generation, Overlap Filter, Line Counter, Cache Set, Environment Secrets Store, Detections Merge, Detections Classes Replacement, Trace Visualization, Qwen2.5-VL, LMM, Detections Stitch, Ellipse Visualization, Instance Segmentation Model, Velocity, Reference Path Visualization, Object Detection Model, First Non Empty Or Default, Time in Zone, Anthropic Claude, Image Preprocessing, Template Matching, Triangle Visualization, Keypoint Detection Model, SIFT, Depth Estimation, Email Notification, Gaze Detection, Property Definition, VLM as Detector, Crop Visualization, Image Contours, Segment Anything 2 Model, Contrast Equalization, Instance Segmentation Model, Google Vision OCR, Time in Zone, OpenAI, SIFT Comparison, Detections Combine, Barcode Detection, Roboflow Dataset Upload, Classification Label Visualization, CLIP Embedding Model, OpenAI, Keypoint Visualization, Perspective Correction, Bounding Rectangle, Pixel Color Count, Polygon Zone Visualization, Llama 3.2 Vision, Dynamic Zone, Image Convert Grayscale, Detections Stabilizer, Circle Visualization, Icon Visualization, Stability AI Inpainting, Detections Transformation, Path Deviation, Dominant Color, Rate Limiter, EasyOCR, Google Gemini, Relative Static Crop, Expression, Buffer, Stability AI Outpainting, VLM as Classifier, SIFT Comparison, Blur Visualization, Cache Get, VLM as Classifier, Byte Tracker, Camera Calibration, Delta Filter, OpenAI, Dot Visualization, Identify Changes, PTZ Tracking (ONVIF).md), Distance Measurement, Multi-Label Classification Model, Roboflow Dataset Upload, Corner Visualization, Halo Visualization, CSV Formatter, Mask Visualization, OCR Model, Model Monitoring Inference Aggregator, Camera Focus, Color Visualization, Clip Comparison, Continue If, Identify Outliers, Cosine Similarity, Model Comparison Visualization, Roboflow Custom Metadata, Data Aggregator, Detections Filter, Dynamic Crop, Line Counter Visualization, Multi-Label Classification Model, Dimension Collapse, Perception Encoder Embedding Model, Grid Visualization, QR Code Detection, Stitch Images, Byte Tracker, Absolute Static Crop, Path Deviation, Keypoint Detection Model, Stitch OCR Detections, YOLO-World Model, QR Code Generator, Local File Sink, Slack Notification, Object Detection Model, Florence-2 Model, Bounding Box Visualization, LMM For Classification, Detection Offset, JSON Parser, Label Visualization, Byte Tracker, Line Counter
• outputs: Stability AI Outpainting, Size Measurement, CogVLM, Pixelate Visualization, Webhook Sink, Image Threshold, Blur Visualization, Cache Get, Twilio SMS Notification, Moondream2, Image Blur, Detections Consensus, Morphological Transformation, OpenAI, Polygon Visualization, Single-Label Classification Model, Dot Visualization, Florence-2 Model, Time in Zone, Single-Label Classification Model, PTZ Tracking (ONVIF).md), Background Color Visualization, Distance Measurement, Stability AI Image Generation, Multi-Label Classification Model, Roboflow Dataset Upload, Corner Visualization, Line Counter, Cache Set, Halo Visualization, Mask Visualization, Detections Classes Replacement, Trace Visualization, Model Monitoring Inference Aggregator, Color Visualization, Clip Comparison, LMM, Detections Stitch, Ellipse Visualization, Instance Segmentation Model, Model Comparison Visualization, Object Detection Model, Time in Zone, Triangle Visualization, Template Matching, Image Preprocessing, Anthropic Claude, Roboflow Custom Metadata, Keypoint Detection Model, Email Notification, Gaze Detection, Line Counter Visualization, Dynamic Crop, Crop Visualization, Multi-Label Classification Model, Segment Anything 2 Model, Contrast Equalization, Perception Encoder Embedding Model, Instance Segmentation Model, Google Vision OCR, Time in Zone, OpenAI, SIFT Comparison, Classification Label Visualization, Roboflow Dataset Upload, CLIP Embedding Model, Keypoint Visualization, OpenAI, Perspective Correction, Pixel Color Count, Path Deviation, Polygon Zone Visualization, Keypoint Detection Model, Dynamic Zone, Llama 3.2 Vision, Stitch OCR Detections, YOLO-World Model, QR Code Generator, Local File Sink, Slack Notification, Circle Visualization, Icon Visualization, Object Detection Model, Stability AI Inpainting, Florence-2 Model, Bounding Box Visualization, LMM For Classification, Path Deviation, Label Visualization, Reference Path Visualization, Google Gemini, Line Counter

Input and Output Bindings

The available connections depend on its binding kinds. Check what binding kinds Twilio SMS Notification in version v1 has.

Bindings

• input

  • twilio_account_sid (Union[secret, string]): Twilio Account SID. Visit the Twilio Console to configure the SMS service and retrieve the value..
  • twilio_auth_token (Union[secret, string]): Twilio Auth Token. Visit the Twilio Console to configure the SMS service and retrieve the value..
  • sender_number (string): Sender phone number.
  • receiver_number (string): Receiver phone number.
  • message_parameters (*): Data to be used in the message content..
  • fire_and_forget (boolean): Boolean flag to run the block asynchronously (True) for faster workflows or synchronously (False) for debugging and error handling..
  • disable_sink (boolean): Boolean flag to disable block execution..
  • cooldown_seconds (integer): Number of seconds until a follow-up notification can be sent. Maximum value: 900 seconds (15 minutes).
  • length_limit (integer): Maximum number of characters in SMS notification (longer messages will be truncated)..

• output

  • error_status (boolean): Boolean flag.
  • throttling_status (boolean): Boolean flag.
  • message (string): String value.

Example JSON definition of step Twilio SMS Notification in version v1

{
    "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": "+1234567890",
    "receiver_number": "+1234567890",
    "message": "During last 5 minutes detected {{ $parameters.num_instances }} 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"
}