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

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