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

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