Intelligent Alerts is a monitoring and alerting system that uses advanced detection models to identify anomalies in user's messaging traffic. By detecting abnormal changes in error code volumes in real-time, Intelligent Alerts helps you address potential deliverability issues before they escalate into significant incidents.
As of April 2026, Intelligent Alerts is Generally Available (GA) for all users. This platform-wide solution provides actionable insights, impact labeling, and customizable notifications to ensure the health of your messaging ecosystem.
- What is Intelligent Alerts?
- Accessing the Dashboard
- Reviewing Your Alerts
- Intelligent Alert Details Page
- Setting Up Email Notifications
- FAQ’s
What are Intelligent Alerts?
Intelligent Alerts is part of the Messaging Intelligence platform. It monitors outbound messaging traffic for anomalous spikes in specific error codes. Our detection models dynamically calculate thresholds for every account based on 7 days of historical data, ensuring that alerts are tailored to your unique traffic patterns rather than static, "one-size-fits-all" limits.
Key Capabilities
- Real-Time Detection: Monitors traffic in 5-minute aggregation windows.
- Granular Analysis: Detects anomalies at the Sub-account + Mobile Network (MCC/MNC) + Error Code level.
- Impact Labeling: Automatically categorizes alerts by severity (Urgent, Critical, Important, Warning) to help you prioritize your response.
- Noise Reduction: Post-processing models filter out low-impact anomalies to ensure you only receive high-signal notifications.
Accessing the Dashboard
Intelligent Alerts is automatically available within the Twilio Console. No separate sign-up is required for GA.
- Log in to the Twilio Console.
- Navigate to Monitor > Insights > Intelligence.
Reviewing Your Alerts
Intelligent Alerts Summary Page
The main Intelligent Alerts page provides users with an aggregated view of all the Intelligent Alerts identified on their accounts. Global and Page filters are incorporated into the page to help narrow down searches and streamline troubleshooting. This page offers links that allow users to configure their Notification Preferences and drill down into each of the anomalies in the Alert Details page.
Global Filters
In the Intelligent Alerts summary page, you have 2 filter options that carry through any current or future tabs in the Intelligence section.
Time Range
- You can choose from a range of predefined time periods.
- The Intelligent Alerts summary banner and the event table will update based on the user selection.
Sub-Account
- Provide the sub-account SID or the sub-account name
- All the Intelligent Alerts identified for that sub-account will be populated
Alert Impact Levels
Intelligent Alerts automatically categorize anomaly events within 4 groups: Urgent, Critical, Important and Warning. We use metrics such as deliverability rate, data sparsity and traffic volume fluctuations which are calculated in real-time from your most recent period of observation. After comparing them to your historical patterns, we are able to estimate the impact the anomalous event may have on your traffic.
Based on the calculated Impact metrics, we map each anomaly to an Impact Category:
- Urgent: This is a high-severity anomaly, indicating a potentially significant issue. Investigate immediately to identify any abnormal factors impacting your traffic during this period.
- Critical: This high-ranking anomaly is noteworthy compared to others experienced on your account. Review impacted messages to assess any substantial effects on your traffic.
- Important: This moderate-severity anomaly differs from your usual traffic behavior. Examine the affected messages to determine if there are significant impacts on your traffic.
- Warning: This low-severity anomaly often appears in accounts with little to no recent traffic. It might not require immediate action, but review the situation to stay informed.
Some anomalies may be considered Uncategorized as some of the error codes we monitor do not appropriately fit in the logic above.
Understanding the Impact Category Section
Immediately after the global filters, you will find a summary section that provides a snapshot of all the alerts identified based on global filters applied. You will find the total number of anomalies for the time range to the far left and a breakdown of each alert into their specific Impact Category next to it. Below each category, you can see the percentage change from the prior period (based on the global time range filter).
Summary Table
Users are presented with an aggregated view of all of their alerts based on the global filters applied. Users can filter the table by Event types, Error code, or Impact. An option to export a CSV file with the current page content is also available.
Intelligent Alerts Details Page
When selecting one of the alerts in the Summary table, you will be taken to the Alert Details page for that individual alert. The Alert Details page breaks down in the following sections:
-
Event Properties: Specific to each alert.
- Impacted account friendly name: Friendly name configured by the user for the impacted accountSID.
- Impacted account: The AccountSID of the impacted account. monitoring happens at the sub-account level and in most cases sub-account = AccountSID unless a Parent Account has no sub-accounts.
- Alert ID: Unique Alert ID given to the anomalous event.
- Day of anomaly: Date in UTC for when the anomaly occurred.
- Time of occurrence: Time window in UTC for when the anomaly occurred. Currently, anomalies are evaluated based on 5 minute evaluation windows.
- MCC/MNC: Mobile Country Codes (MCC) and Mobile Network Codes (MNC)
- Carrier Route: Carrier Name
- Alert threshold: Dynamic threshold calculated by the Intelligent Alerts platform based on the user's own historical trends.
- Number of errors: The sum of all of the errors in the 5 minute evaluation window for the impacted error code and carrier combination for which the anomaly was identified
- Number of messages: The sum of all of the outbound SMS in the 5 minute evaluation window for the impacted carrier route for which the anomaly was identified.
- Historical graph: Shows the historical trends for the impacted accountSID. Noted that the historical trend is based on the aggregation key - meaning that trends only look at messages and error codes for the carrier route identified as an anomaly.
- Error description: Includes a high level description and possible causes and solutions for the error code where the anomaly was identified.
Monitored Error Codes
Intelligent Alerts currently monitors for volume-based changes in the following high-impact messaging error codes:
| Error Code | Description |
| 30001 | Queue Overflow |
| 30003 | Unreachable Destination Handset |
| 30005 | Unknown Destination Handset |
| 30006 | Landline or Unreachable Carrier |
| 30007 | Message Filtering |
| 30008 | Unknown Error |
Setting Up Notifications & Preferences
You can configure real-time email notifications to stay informed without needing to check the Console manually.
Manage Notifications
Navigate to Monitor > Intelligence > Intelligent Alerts > Manage Notifications.
- Recipients: Add the email addresses that should receive alerts.
- Granular Preferences: You can now select exactly which error codes you want to be notified about. For example, you may choose to only receive emails for 30007 (Filtering) while monitoring 30001 (Queue Overflow) via the dashboard only.
Email Feedback Mechanism
To help us improve our detection models, all notification emails now include a feedback collection option. You can mark an alert as "Helpful" or "Not Helpful" directly from your inbox. This data is used to further refine our FIS (False Intervention Suppression) models to reduce false negatives for both high and low-volume accounts.
FAQ
What metrics are monitored by Intelligent Alerts?
Intelligent Alerts uses advanced monitoring capabilities to detect anomalous changes in volumes of Twilio error codes: 30001, 30003, 30005, 30006, 30007 and 30008.
What notification channels are supported by Intelligent Alerts?
We currently support email notifications with plans to bring more channels over time.
Is there a cost for Intelligent Alerts?
Intelligent Alerts is currently included as part of the Messaging Intelligence platform and not a paid feature. Users will be notified in advance if pricing structures change with the introduction of future premium features.
What is the difference between Alarms and Intelligent Alerts?
Alarms and Intelligent Alerts are complementary. Alarms require you to manually set a static threshold (e.g., "Alert me if 30007 exceeds 10%"). Intelligent Alerts uses AI to learn what "normal" looks like for your specific account and alerts you automatically when traffic deviates from that baseline, even if you haven't set an alarm.
What should I do if I receive an Intelligent Alerts?
The alert is designed to give you a head start. Log in to the Twilio Console and navigate to Monitor > Insights > Intelligence to view your Summary page.
From there, click on the specific alert to open its Details Page, where you can:
- Identify the Source: See exactly which sub-account and carrier route were impacted.
- Analyze the Trend: Use the historical graph to see how the spike compares to your usual traffic.
- Take Action: Review the error code description for a high-level breakdown of what went wrong and follow the recommended steps to resolve the issue and prevent future anomalies.
Why did I receive a "Warning" impact level?
Warning alerts are low-severity and often occur in accounts with fluctuating or low-volume traffic. They may not require immediate action but serve to keep you informed of slight deviations in carrier behavior.
How can I reduce the number of emails I receive?
You can update your Notification Preferences to opt-out of specific error codes or adjust your notification settings in the Console to focus only on "Urgent" or "Critical" impacts.