🔧 System Requirements
Before installing the Ecommerce Webhook Notifications Addon, ensure your system meets the following requirements for optimal performance and compatibility.
🖥️ Server Requirements
Minimum Requirements
| Component | Requirement | Details |
|---|---|---|
| PHP Version | 8.1+ | PHP 8.1, 8.2, or 8.3 recommended |
| Laravel Framework | 10.x or 11.x | WhatsMarkSaaS compatibility |
| Memory Limit | 128MB | Additional memory for webhook processing |
| Storage Space | 50MB | For addon files and logs |
| MySQL | 5.7+ or 8.0+ | Database requirements |
| Web Server | Apache/Nginx | Standard web server setup |
Recommended Requirements
| Component | Recommended | Benefits |
|---|---|---|
| PHP Version | 8.3+ | Better performance and security |
| Memory Limit | 256MB+ | Handle high-volume notifications |
| Storage Space | 200MB+ | Extended logging and media storage |
| CPU | 2+ cores | Concurrent webhook processing |
| SSL Certificate | Required | Secure webhook endpoints |
📱 WhatsMarkSaaS Compatibility
Required WhatsMarkSaaS Version
⚠️ Important Compatibility Notice
- Minimum Version: WhatsMarkSaaS 2.0.0 or higher
- Recommended Version: WhatsMarkSaaS 2.1.0 or latest
- Legacy Support: WhatsMarkSaaS 1.x is NOT supported
WhatsMarkSaaS Features Required
- ✅ WhatsApp Business API Integration: Active connection required
- ✅ Template Management System: For creating notification templates
- ✅ Admin Panel Access: Super admin privileges for installation
- ✅ Webhook Support: Built-in webhook handling capabilities
- ✅ Multi-tenant Architecture: For SaaS environment support
🔌 WhatsApp Business API Requirements
API Access Requirements
- WhatsApp Business API Account: Verified and approved
- Template Message Approval: Templates must be approved by Meta
- Phone Number Verification: Business phone number verification
- Webhook Verification: Ability to receive webhook calls
Message Limits & Compliance
- Rate Limits: Respect WhatsApp API rate limits
- Template Categories: Use appropriate template categories
- Opt-in Compliance: Users must opt-in to receive notifications
- 24-hour Window: Follow WhatsApp messaging window rules
🛒 Ecommerce Platform Requirements
WooCommerce Requirements
| Requirement | Version | Notes |
|---|---|---|
| WordPress | 6.0+ | Latest stable version recommended |
| WooCommerce | 7.0+ | Active WooCommerce installation |
| PHP | 8.1+ | Matches server requirements |
| Webhook Support | Built-in | WooCommerce webhook functionality |
Shopify Requirements
| Requirement | Details | Notes |
|---|---|---|
| Shopify Plan | Any plan | Basic, Shopify, Advanced, or Plus |
| Admin Access | Store owner or staff | Webhook creation permissions |
| App Permissions | Read/Write orders | Access to order and customer data |
| Webhook Limits | Standard limits | Shopify webhook limitations apply |
Magento Requirements
| Requirement | Version | Notes |
|---|---|---|
| Magento | 2.4.0+ | Magento Open Source or Commerce |
| PHP | 8.1+ | Magento compatibility requirements |
| Composer | 2.0+ | For module installation |
| Admin Access | Full access | System configuration permissions |
Custom Platform Requirements
For custom ecommerce platforms:
- REST API Support: Ability to send HTTP POST requests
- Webhook Capability: Send real-time event notifications
- JSON Format: Support for JSON data formatting
- Authentication: API key or token-based authentication
- SSL/TLS: Secure HTTPS connections
🌐 Network & Security Requirements
Network Configuration
- Outbound HTTPS: Port 443 access for WhatsApp API
- Webhook Endpoints: Public URL accessible by ecommerce platforms
- SSL Certificate: Valid SSL certificate for secure connections
- Firewall Rules: Allow webhook traffic from platforms
Security Requirements
- HTTPS Only: All webhook endpoints must use HTTPS
- Webhook Validation: Signature validation for incoming webhooks
- Rate Limiting: Configure appropriate rate limiting
- Access Control: Secure admin panel access
📊 Performance Considerations
High-Volume Stores
For stores processing high order volumes:
| Order Volume/Day | Recommended Setup |
|---|---|
| < 100 orders | Standard requirements sufficient |
| 100-500 orders | 256MB RAM, SSD storage |
| 500-1000 orders | 512MB RAM, dedicated queue worker |
| 1000+ orders | Load balancer, multiple workers |
Optimization Tips
- Queue Workers: Use Laravel queue workers for background processing
- Database Optimization: Regular database maintenance and indexing
- Caching: Implement Redis or Memcached for better performance
- CDN Usage: Use CDN for static assets and images
🔍 Testing Environment
Development Setup
For testing before production deployment:
- Staging Environment: Mirror of production environment
- Test WhatsApp Number: Separate test phone number
- Sample Data: Test orders and customer data
- Webhook Testing: Tools like ngrok for local testing
Recommended Testing Tools
- Postman: API endpoint testing
- ngrok: Local webhook testing
- Laravel Telescope: Application debugging
- WhatsApp Business API Testing: Meta's testing tools
✅ Pre-installation Checklist
Before proceeding with installation, verify:
System Verification
- [ ] PHP version 8.1+ installed and configured
- [ ] WhatsMarkSaaS 2.0+ running and functional
- [ ] Database backup completed
- [ ] SSL certificate installed and working
- [ ] Admin access credentials available
WhatsApp Setup
- [ ] WhatsApp Business API account active
- [ ] Phone number verified and approved
- [ ] Template messages created and approved
- [ ] Webhook URL accessible and secure
Ecommerce Platform
- [ ] Platform admin access available
- [ ] Webhook functionality tested
- [ ] API credentials obtained (if required)
- [ ] Test order data available
Security & Compliance
- [ ] Webhook signature validation configured
- [ ] Rate limiting rules in place
- [ ] Privacy policy updated for notifications
- [ ] Customer opt-in process implemented
🚫 Known Limitations
Platform Limitations
- Shared Hosting: May have limitations with webhook processing
- Free SSL: Some free SSL providers may have restrictions
- Rate Limits: WhatsApp API has strict rate limiting
- Template Approval: Meta approval required for all templates
Regional Restrictions
- Country Availability: WhatsApp Business API availability varies
- Local Regulations: Comply with local messaging regulations
- Language Support: Template language must match customer locale
🆘 Support for Requirements
If you need help verifying system requirements or encounter compatibility issues:
Technical Support
- 🎫 Requirements Check: Submit a ticket
- 💬 Community Help: Technical Forum
- 📧 Email Support: [email protected]
- 📱 Phone Support: +1-555-CORBITAL
Professional Services
- Server Setup: Professional server configuration
- Platform Integration: Custom platform integration services
- Performance Optimization: Speed and reliability improvements
- Security Audit: Comprehensive security assessment
Ensure all requirements are met before installation to avoid compatibility issues and ensure optimal performance.