WooPilot Bale Notifications
Advanced WooCommerce integration plugin for Bale Messenger with OTP authentication, direct in-chat commerce, order notifications, sales reporting, webhook automation, and modular enterprise-grade architecture for WordPress.
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/iamir-karimi/woopilot-bale/archive/refs/heads/main.zipWooPilot Bale is an advanced WordPress and WooCommerce integration plugin for Bale Messenger. The plugin provides secure authentication, real-time order notifications, direct commerce inside Bale, automated reporting, and enterprise-grade messaging workflows through a modular and scalable architecture.
The project is designed with a modern architecture-first approach using OOP, PSR-4 autoloading, WordPress coding standards, and WooCommerce best practices.
Features
Bale Messenger Integration
- Connect WordPress and WooCommerce to Bale Messenger
- Secure Bale Bot API integration
- Webhook-based real-time communication
- Connection testing and webhook management
- Retry system for failed requests
- Debug mode and logging system
WooCommerce Notifications
- New order notifications
- Customer order updates
- Admin order alerts
- Order status change notifications
- Low stock alerts
- Customizable message templates
- Dynamic template variables
OTP Authentication System
- Login and registration with Bale
- Secure OTP verification
- Bale account connection
- Unique connection token generation
- AJAX-based authentication flow
- WooCommerce account integration
- Persistent user connection management
Direct Commerce Inside Bale
Users can interact with the store directly from Bale Messenger.
Supported Features
- Product search
- Product categories
- Store navigation
- User account access
- Order tracking
- User orders
- Sale products
- Support section
- About section
Configurable Bot Menu
- Enable or disable menu items
- Change menu order
- Fully configurable from WordPress admin panel
Sales Reporting System
- Total sales reports
- Order statistics
- Completed and incomplete orders
- Product sales metrics
- Interactive sales charts
- Jalali date support
- Custom date ranges
- AJAX-powered reports
- Scheduled report delivery to Bale admins
Login Page Customizer
- Custom logo upload
- Dynamic color management
- Border radius controls
- Live style customization
- Fully customizable authentication interface
Architecture
The plugin follows a modular enterprise architecture.
Folder Structure
src/
assets/
languages/
templates/
Main Modules
- Admin
- Api
- Messaging
- WooCommerce
- Auth
- Webhook
- Reports
Technical Standards
- Namespace-based architecture
- PSR-4 autoloading
- SOLID principles
- WordPress coding standards
- OOP architecture
- Secure data handling
- Nonce verification
- Sanitization and escaping
- Performance-focused structure
Requirements
- PHP 8.0+
- WordPress 6.0+
- WooCommerce 7.0+
- Bale Bot API access
Installation
- Upload the plugin to:
/wp-content/plugins/WooPilot-Bale
-
Activate the plugin from WordPress admin panel
-
Configure Bale Bot settings
-
Set webhook URL
-
Enable required modules
Webhook Setup
After configuring the bot token, register the webhook from the plugin settings panel.
Example webhook route:
https://your-domain.com/wp-json/woopilot-bale/v1/webhook
Security
WooPilot Bale is designed with security-first principles.
- Nonce validation
- Sanitized inputs
- Escaped outputs
- Secure OTP generation
- Protected AJAX requests
- Webhook verification
- WordPress capability checks
Roadmap
Planned Features
- Full mini-commerce experience inside Bale
- Product cart management in chat
- In-chat checkout flow
- Persian payment gateway integrations
- Advanced analytics
- Multi-bot support
- AI-assisted automation
- Marketing workflows
License
Private proprietary software.
All rights reserved.