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

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