integrations
Updated January 13, 2025
SMS & WhatsApp Integration
Send instant text message alerts and WhatsApp notifications for critical incidents
SMS & WhatsApp Integration
Get instant mobile notifications through SMS text messages and WhatsApp Business messaging for critical incidents. Perfect for immediate attention when other notification channels might not be monitored.
Why SMS & WhatsApp?
✅ Benefits
- •Immediate delivery - messages arrive within seconds
- •Works without internet - SMS reaches any mobile phone
- •High attention-grabbing - mobile notifications are hard to miss
- •Global reach - works with any mobile carrier worldwide
- •No app required - uses built-in messaging capabilities
🎯 Perfect For
- •Critical production systems requiring immediate attention
- •On-call engineer notifications during non-business hours
- •Escalation workflows when email/chat alerts go unnoticed
- •High-priority services with strict SLA requirements
- •Remote team members in different time zones
SMS Integration
SMS Message Format
StatusPageOne sends concise, informative SMS messages optimized for mobile reading:
📱 SMS Incident Alert
🚨 ALERT: API Server DOWN
Error: Connection timeout
Time: 10:30 UTC
Region: us-east-1
- StatusPage One
📱 SMS Recovery Alert
✅ RECOVERED: API Server UP
Downtime: 12m 15s
Time: 10:42 UTC
Response: 180ms
- StatusPage One
SMS Setup Guide
Step 1: Access Integration Settings
- Navigate to your monitor in the StatusPageOne console
- Click the Integrations tab
- Select Add Integration
- Choose SMS from the integration types
Step 2: Configure SMS Settings
Phone Number * [Configuration field]
Include country code (e.g., +1 for US, +44 for UK, +55 for Brazil)
Integration Name [Configuration field]
Descriptive name to identify this integration
[Toggle to enable] Enable notifications
Step 3: Phone Number Format Requirements
📞
Phone Number Formatting
SMS requires phone numbers in international E.164 format with country codes.
Correct formats:
- • +1234567890 (US)
- • +44123456789 (UK)
- • +5511987654321 (Brazil)
- • +81312345678 (Japan)
Incorrect formats:
- • 1234567890 (missing +)
- • (123) 456-7890 (formatted)
- • 123-456-7890 (formatted)
Step 4: Test and Activate
- Click Test Integration to send a sample SMS
- Check your mobile phone for the test message
- Click Save Integration to activate SMS notifications
SMS Usage Limits by Plan
| Plan | SMS Messages/Month | Overage Rate |
|---|---|---|
| Free | Not available | - |
| Pro | 300 SMS included | $0.05 per message |
| Business | 2000 SMS included | $0.04 per message |
Usage resets monthly. Overage charges apply automatically for additional messages.
WhatsApp Business Integration
WhatsApp Message Format
WhatsApp messages include rich formatting and context:
💚 WhatsApp Incident Alert
🚨 Monitor Alert: API Server
Status: DOWN
Error: Connection timeout after 30 seconds
Response Time: 30000ms
Region: us-east-1
Time: 2024-01-15 10:30:15 UTC
StatusPage One Monitoring
WhatsApp Setup Guide
Step 1: WhatsApp Business API Access
💼
WhatsApp Business Requirements
WhatsApp integration uses the WhatsApp Business API, which has different requirements than personal WhatsApp.
- • Requires WhatsApp Business API access (not personal WhatsApp)
- • Available on Pro and Business plans
- • Uses business phone number verification
- • Subject to WhatsApp's messaging policies
Step 2: Configure WhatsApp Integration
- Access integration settings in your monitor
- Select WhatsApp from integration types
- Enter configuration details:
Phone Number * [Configuration field]
WhatsApp-registered phone number with country code
Integration Name [Configuration field]
[Toggle to enable] Enable notifications
Step 3: WhatsApp Verification
Verification Process
- • Phone number must have active WhatsApp account
- • Initial verification message sent to confirm number
- • Business API compliance check may be required
- • 24-48 hour approval process for new business numbers
Advanced Configuration
Multiple Phone Numbers
Set up SMS/WhatsApp for different team members:
Primary On-Call
SMS: +1234567890
WhatsApp: +1234567890
Critical production alerts
Backup Engineer
SMS: +1987654321
WhatsApp: +1987654321
Escalation after 5 minutes
Team Manager
WhatsApp: +44123456789
High-priority incidents only
International Team
WhatsApp: +5511987654321
Regional coverage (Brazil)
Strategic Usage Guidelines
⚠️
SMS Usage Strategy
SMS has usage limits. Plan your strategy carefully to maximize effectiveness.
Recommended Usage:
- • Reserve for critical production systems only
- • Use for escalation after email/chat alerts
- • Configure for high-priority monitors with strict SLAs
- • Set up for on-call rotation phone numbers
Usage Optimization:
- • Combine with email for detailed incident information
- • Use descriptive monitor names to identify services quickly
- • Monitor monthly usage to avoid overages
- • Set up WhatsApp for international team members
Message Delivery Details
SMS Delivery Infrastructure
SMS Technical Details
Delivery Network:
- • Global SMS provider network
- • Direct carrier connections
- • 99.9% delivery reliability
- • 1-5 second delivery times
Message Features:
- • 160 character standard SMS
- • Unicode support for international
- • Delivery status tracking
- • Automatic retry logic
WhatsApp Delivery Infrastructure
WhatsApp Technical Details
Business API Features:
- • Rich text formatting
- • Delivery and read receipts
- • End-to-end encryption
- • Cross-platform compatibility
Compliance:
- • WhatsApp Business Policy compliant
- • Automated system notifications allowed
- • No promotional content
- • 24-hour conversation window
Troubleshooting
Common Issues
❌ Messages Not Received
Phone Number Issues:
- • Verify phone number includes country code (+)
- • Check number is active and can receive messages
- • Ensure number is not blocked by carrier spam filters
- • Test with a different phone number to isolate issue
Carrier Issues:
- • Some carriers may delay or block automated SMS
- • International numbers may have higher delivery latency
- • Check mobile phone signal strength and connectivity
⚠️ WhatsApp Delivery Problems
Account Issues:
- • Verify WhatsApp is installed and active on target number
- • Check WhatsApp Business API approval status
- • Ensure number hasn't blocked business messages
- • Verify account compliance with WhatsApp policies
💰 Usage and Billing
SMS Limits:
- • Monitor usage in billing section of console
- • Set up usage alerts to avoid overages
- • Review monthly SMS allocation and usage patterns
- • Consider upgrading plan for higher message limits
Testing Guidelines
🧪 SMS/WhatsApp Testing
1Use Test Integration to send sample message
2Check mobile device for message receipt
3Verify message formatting and readability
4Test with international numbers if applicable
5Monitor delivery status in integration settings
Best Practices
📱 SMS/WhatsApp Best Practices
Strategic Usage
- • Reserve SMS for critical systems with strict SLAs
- • Use WhatsApp for international team members
- • Set up escalation chains with time delays
- • Monitor usage to stay within plan limits
Message Optimization
- • Use clear, descriptive monitor names
- • Include essential information only
- • Test message format on different devices
- • Keep messages concise for SMS character limits
Team Coordination
- • Set up on-call rotation with different numbers
- • Document escalation procedures
- • Train team on mobile alert response
- • Use separate integrations for different severity levels
Technical Setup
- • Always include country codes in phone numbers
- • Test integrations after phone number changes
- • Set up backup notification methods
- • Monitor delivery success rates
Global Coverage
SMS Country Support
🌍 Worldwide SMS Coverage
StatusPageOne SMS works in 200+ countries with direct carrier connections for reliable delivery.
North America:
- • United States (+1)
- • Canada (+1)
- • Mexico (+52)
Europe:
- • United Kingdom (+44)
- • Germany (+49)
- • France (+33)
Asia Pacific:
- • Japan (+81)
- • Australia (+61)
- • Singapore (+65)
For complete country coverage, check delivery rates in your region.
International Considerations
International SMS Tips
- • Delivery Times: May be 1-10 seconds for international messages
- • Character Encoding: Unicode support for non-Latin characters
- • Carrier Policies: Some carriers may block automated messages
- • Time Zones: Messages delivered immediately regardless of local time
- • Costs: International rates may apply for cross-border delivery
Integration Management
Usage Monitoring
Track your SMS and WhatsApp usage in the console:
Usage Metrics Available:
- • Monthly Usage: Current month SMS count and limit
- • Delivery Success: Rate of successful message deliveries
- • Usage Trends: Historical usage patterns
- • Cost Tracking: Overage charges and billing details
- • Per-Integration Stats: Usage breakdown by phone number
Bulk Management
Efficiently manage multiple SMS/WhatsApp integrations:
- Enable/Disable: Toggle multiple integrations across monitors
- Update Numbers: Change phone numbers in bulk
- Usage Allocation: Distribute SMS quota across different services
- Test Multiple: Send test messages to verify all numbers
Cost Management
Optimizing SMS Costs
💰
SMS Cost Optimization
Strategic Allocation:
- • Prioritize critical production systems
- • Use email/chat for non-urgent alerts
- • Set up escalation delays to reduce duplicate messages
- • Monitor usage weekly to avoid overages
Cost-Effective Alternatives:
- • Use WhatsApp for international team members
- • Combine with push notifications where possible
- • Consider upgrading plan if regularly exceeding limits
- • Use webhooks to trigger custom notification logic
Next Steps
After setting up SMS/WhatsApp notifications:
- Configure Email Integration - Add detailed incident documentation
- Set Up Team Chat - Enable team coordination
- Add Webhook Automation - Trigger automated responses
- Optimize Monitor Settings - Fine-tune alert sensitivity
SMS and WhatsApp provide critical immediate notification capabilities. Use strategically for high-priority systems and combine with other channels for comprehensive coverage.
Support
Need help with SMS/WhatsApp integration?
- Verify phone number format includes country code
- Test integration function to confirm delivery
- Monitor usage in billing section to avoid overages
- Contact support for delivery issues or WhatsApp Business setup
Improve this page
Found an error or want to contribute? Edit this page on GitHub.