WP Manifestindependent plugin directory
manifest / ecommerce / woopilot-bale

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.

by iamir · github.com/iamir-karimi/woopilot-bale · website

2stars
0forks

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.zip

WooPilot 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

  1. Upload the plugin to:
/wp-content/plugins/WooPilot-Bale
  1. Activate the plugin from WordPress admin panel

  2. Configure Bale Bot settings

  3. Set webhook URL

  4. 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.