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

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