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