π§ 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.