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

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[string, secret]): Twilio Account SID. Visit the Twilio Console to configure the SMS service and retrieve the value..
  • twilio_auth_token (Union[string, secret]): 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"
}