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

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