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

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