WIB WhatsApp Notifier
PRO v1.0.1

WIB WooCommerce WhatsApp Notifier Pro

Advanced WooCommerce WhatsApp notification and automation plugin for order alerts, admin notifications, multi-agent WhatsApp Chat, and customer messaging.

High-Performance Order Storage (HPOS) Ready
This plugin is fully certified and optimized for WooCommerce Custom Order Tables (HPOS), ensuring lightning-fast database queries and enterprise scalability.
Key Capabilities
  • Multi-Gateway Messaging Engine: Instant support for Meta WhatsApp Cloud API, Twilio API, Infobip API, and UltraMsg QR Gateway.
  • Complete Order Lifecycle Alerts: Automated WhatsApp messages for 10 distinct WooCommerce order statuses (Customer & Admin alerts).
  • Dynamic Variable Mapping: Robust 8-variable substitution engine (`{{1}}Name` to `{{8}}Payment`).
  • Built-in Meta Template Creator: Design and submit official WhatsApp templates directly to Meta from your WordPress dashboard.
  • Frontend Conversions: Floating multi-agent WhatsApp Chat Widget and Single Product Page "Buy via WhatsApp" buttons.
  • Per-Domain License Security: Secure CodeCanyon purchase verification with local development fallback support.
  • Advanced Diagnostics: Live AJAX connection testing tools and unified message delivery logs.
Server Requirements
WordPress Version5.8 or higher
WooCommerce Version5.0 or higher
PHP Version7.4 or higher (8.0+ rec.)
DatabaseMySQL 5.7+ / MariaDB

Installation & Setup

Installing WIB WooCommerce WhatsApp Notifier Pro is quick and straightforward. Follow these steps to get started:

1

Download Plugin Archive

Download the latest `wib-whatsapp-notifier-pro.zip` file from your Envato / CodeCanyon downloads dashboard.

2

Upload to WordPress

Log in to your WordPress dashboard, navigate to Plugins > Add New > Upload Plugin, choose the zip file, and click Install Now.

3

Activate Plugin

Once uploaded, click Activate Plugin. The plugin will automatically run a database check and create its custom logging tables.

FTP Installation Alternative
If you prefer installing via FTP, unzip the archive and upload the `wib-whatsapp-notifier-pro` folder to your `/wp-content/plugins/` directory, then activate it from the WordPress Plugins screen.

License Management

To unlock premium features and receive automated updates, you must bind your CodeCanyon purchase code to your active domain.

Activating Your License
  1. Log in to your Envato / CodeCanyon account and go to your Downloads page.
  2. Click the Download button next to the plugin and select License certificate & purchase code.
  3. Open the downloaded PDF/Text file and copy your 36-character Item Purchase Code.
  4. In your WordPress dashboard, navigate to WIB WhatsApp Notifier > License.
  5. Paste your purchase code into the input field and click Activate License.
Plugin License Management
Local Development & Staging Support
The plugin includes a built-in staging fallback mode. If you activate your license on `localhost`, `*.local`, `*.staging`, or `*.test` domains, it will activate instantly without consuming your live production domain quota!

Gateway Configuration

WIB WhatsApp Notifier Pro supports 4 powerful messaging gateways. Choose the tab below that matches your preferred service to see detailed setup instructions:

Meta WhatsApp Cloud API Setup (Official)

The Meta Cloud API is free to access and provides official WhatsApp business verification. Here is how to configure it:

  1. Go to the Meta Developers Portal and create a new Business App.
  2. Add the WhatsApp product to your application.
  3. In the left menu, go to WhatsApp > API Setup. Here you will find your Phone Number ID and WhatsApp Business Account ID (WABA ID).
  4. To generate a permanent access token, go to your Business Manager Settings. Navigate to Users > System Users.
  5. Create a System User, assign them admin permissions for your app, and click Generate New Token (select `whatsapp_business_management` and `whatsapp_business_messaging` permissions).
  6. Paste your Phone Number ID, WABA ID, and Permanent Access Token into the plugin settings at WooCommerce > Settings > WhatsApp > Meta API.
Meta WhatsApp API Settings
Twilio WhatsApp API Setup

Twilio is a robust cloud communications platform. Follow these steps to configure your Twilio credentials:

  1. Log in to your Twilio Console dashboard.
  2. Copy your Account SID and Auth Token from the main console screen.
  3. Navigate to Messaging > Senders > WhatsApp Senders and copy your approved Twilio WhatsApp phone number (e.g., `+14155238886`).
  4. In WordPress, go to WooCommerce > Settings > WhatsApp > Twilio API, enter these credentials, and click Save Changes.
Infobip WhatsApp API Setup

Infobip provides high-deliverability enterprise messaging. Here is how to connect:

  1. Log in to your Infobip Portal.
  2. Generate a new API Key in your developer settings.
  3. Copy your personalized Base URL (e.g., `api.infobip.com` or your custom subdomain).
  4. Go to Channels > WhatsApp > Senders and copy your registered WhatsApp sender number.
  5. Enter these details under the Infobip API tab in the plugin settings.
UltraMsg QR Gateway Setup (No API Approval Needed!)

UltraMsg allows you to link your existing personal or business WhatsApp number instantly via a QR code scan. You do not need Meta template approvals!

  1. Create an account at UltraMsg.com and create a new instance.
  2. Copy your Instance ID (e.g., `instance12345`) and Token.
  3. In WordPress, go to WooCommerce > Settings > WhatsApp > UltraMsg (QR) and save these credentials.
  4. Click the Show Login QR Code button in the plugin settings.
  5. Open WhatsApp on your mobile phone, go to Linked Devices > Link a Device, and scan the QR code displayed on your WordPress screen.
Keep Phone Connected
Since UltraMsg acts as a bridge to your physical WhatsApp device, ensure your phone remains connected to the internet periodically to maintain active session synchronization.

Order Notifications & Triggers

You can configure automated WhatsApp alerts for both customers and store administrators across 10 distinct order lifecycle events.

Enabling Order Triggers

Navigate to WooCommerce > Settings > WhatsApp > Notifications. Here you can select your active primary gateway and check the box next to any order status you wish to enable (e.g., *New Order*, *Order Processing*, *Order Shipped*).

Admin Notification Settings

For the New Order (Admin) trigger, you can specify one or multiple administrator phone numbers separated by commas (e.g., `+1234567890,+0987654321`).

Order Notifications Configuration
Dynamic Variable Cheat Sheet

When creating templates in Meta, Twilio, Infobip, or UltraMsg, use the exact numbered placeholders below. The plugin will automatically substitute them with live order data:

Customer First Name{{1}}
Order Number{{2}}
Total Item Count{{3}}
Formatted Order Total{{4}}
View Order URL{{5}}
Order Status Name{{6}}
Order Creation Date{{7}}
Payment Method Title{{8}}
Sequential Parameter Rule (Meta API)
Meta requires parameters to be strictly sequential (`{{1}}`, `{{2}}`, `{{3}}`). Do not skip numbers in your template body (e.g., jumping from `{{1}}` directly to `{{4}}` will cause Meta API rejection).

Template Management

Managing message templates varies slightly depending on your active gateway. Here is how to handle each:

Built-in Meta Template Creator (NEW!)

You no longer need to log into the Facebook Business Manager to create templates! Navigate to WooCommerce > Settings > WhatsApp > Meta Templates.

  1. Enter a lowercase template name (e.g., `order_shipped_alert`).
  2. Select the Category (`UTILITY` or `MARKETING`) and Language.
  3. Write your message body using the `{{1}}`, `{{2}}` variables. You can also click any of the Quick Sample Chips to auto-fill proven message structures!
  4. Click Submit for Approval. The plugin will push the template directly to Meta. Once approved by Meta (usually within 2-5 minutes), it will appear in your dropdown lists automatically.
Meta Template Creator

Viewing Approved Templates

You can view all currently approved templates and their sync status under the Meta Templates tab:

Meta Approved Templates List
UltraMsg Custom Text Builder

Since UltraMsg uses your linked phone directly, you do not need official template approvals. Under the UltraMsg (QR) settings tab, you can write fully custom text messages for every order status using intuitive named tags like `{name}`, `{order_id}`, `{total}`, and `{url}`.

Floating WhatsApp Chat Widget

Provide exceptional frontend customer support by enabling the multi-agent floating WhatsApp chat widget.

Configuring Support Agents

Go to WooCommerce > Settings > WhatsApp > Chat Widget. Here you can configure:

  • Widget Header: Custom Title (*"Chat with us"*) and Subtitle (*"Choose an agent to start a conversation"*).
  • Agent Repeater: Click Add New Agent to create multiple support profiles.
  • Agent Details: Upload a custom avatar photo, enter their Name, Department/Role (*"Sales"*, *"Technical Support"*), and WhatsApp phone number.
  • Availability Toggle: Switch agents between Online and Offline instantly. Offline agents will display a grey badge and prevent chats outside working hours.
WhatsApp Chat Widget Configuration

Single Product Page Button

Boost your store's direct conversion rate by adding an "Order on WhatsApp" button directly to single product pages.

Button Customization

Navigate to WooCommerce > Settings > WhatsApp > Product Button. You can customize:

  • Target Number: Enter a specific sales phone number. (If left empty, the plugin automatically forwards inquiries to your first online chat agent!).
  • Button Label: Customize the text (e.g., *"Buy via WhatsApp"*, *"Ask a Question"*).
  • Pre-filled Message: Create a customized initial message using `{product_name}` and `{product_url}` tags. When a customer clicks the button, WhatsApp will open with this message pre-typed!
Single Product Page Button Configuration

Logs & Diagnostics

WIB WhatsApp Notifier Pro provides powerful diagnostic tools to ensure your store's messaging runs flawlessly.

Live AJAX Diagnostic Buttons

On every gateway configuration screen, you will find interactive diagnostic buttons:

  • Check API Status: Instantly pings the Meta/Twilio/Infobip/UltraMsg servers and verifies your credentials without needing to send a real message.
  • Send Test Message: Enter your mobile number, select a template, and click send to receive an immediate live test message on your phone.
Unified Message Logs Table

Navigate to WIB WhatsApp Notifier > Logs in your WordPress admin menu. This screen displays a complete audit trail of all outgoing messages, including:

  • Exact delivery timestamp and recipient phone number.
  • Dynamic success or failure status badges.
  • Message body previews and active gateway tracking.
  • Raw API Responses: Examine exact error codes returned by Meta or Twilio for effortless troubleshooting.
Unified Message Logs Table

FAQ & Troubleshooting

Find quick answers to common questions and troubleshooting steps below:

Why are my Meta Cloud API messages failing with "131009 - Parameter count mismatch"?

This occurs when your WooCommerce trigger passes more or fewer variables than your Meta template expects. To fix this, go to WooCommerce > Settings > WhatsApp > Notifications and adjust the Variables Count setting for that trigger to match your template precisely.

Can I use the plugin without official Facebook Business verification?

Yes! If you do not have official Facebook Business verification, select the UltraMsg (QR Gateway). It links directly to your personal or business WhatsApp app via a simple QR code scan and requires zero template approvals.

Why is my Floating Chat Widget not appearing on the frontend?

Ensure you have checked the Enable Chat Widget box in the Chat Widget settings tab. Also, check that you have added at least one support agent and set their status to Online.

How do I resolve "Unlicensed Plugin" admin notices?

Navigate to WIB WhatsApp Notifier > License and enter your valid CodeCanyon Item Purchase Code. If you are developing locally (`localhost`, `*.local`), the plugin will verify and activate automatically.

Need Additional Support?

Our dedicated technical support team is ready to assist you with any advanced configuration or troubleshooting needs.

support@willinfobot.com +91 94886 70077 Support Portal www.wibplugins.com