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

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"
}