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

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