Documentation
Everything you need to set up and use Mujteknify Chat Pro.
Installation
System Requirements
- WordPress 6.0+
- WooCommerce 5.0+
- PHP 7.4+
- SSL Certificate (HTTPS)
Upload Plugin
Go to WordPress Admin → Plugins → Add New → Upload Plugin
and select Mujteknify Chat-pro.zip.
Activate
Click "Activate Plugin" after upload completes.
Configure
Navigate to the new Mujteknify Chat menu item in your sidebar to start setup.
License Activation
Your License Key: You received this via email after purchase. Check your inbox for the subject "Mujteknify Chat Pro - License Key"
Step-by-Step Activation:
Go to License Settings
In your WordPress dashboard, navigate to:
Enter Your License Key
- • Copy the license key from your purchase email
- • Paste it into the "License Key" field
- • The key looks like:
WWPRO-XXXX-XXXX-XXXX-XXXX
Click "Activate License"
Click the green "Activate" button and wait for confirmation.
✅ A success message will appear: "License activated successfully!"
Verify Activation
After activation, you should see:
- • ✅ License Status: Active
- • 📅 Expiry Date: Lifetime (No expiry)
- • 🔄 Updates: Enabled
Common License Issues
❌ "Invalid License Key"
• Double-check you copied the entire key correctly (including dashes)
• Make sure there are no extra spaces
❌ "License already used on another domain"
• Standard licenses work on one domain only
• Contact support to transfer or upgrade to multi-site license
❌ "Cannot connect to activation server"
• Check your server has outbound internet connection
• Contact your hosting provider if issue persists
Need help? Contact support at support@mujteknify.com
API Configuration
Meta Business Account Required
You need a Meta Business account to use the WhatsApp Cloud API. It's free to create.
Follow these steps to get your API credentials:
- Go to Meta for Developers and create a "Business" app.
- Add "WhatsApp" as a product to your app.
- In the WhatsApp > API Setup panel, you will find your credentials.
New to Meta Developer? Follow the detailed walkthrough below for step-by-step instructions.
Detailed Step-by-Step Walkthrough:
Create Your Meta Business App
- • Go to developers.facebook.com and log in
- • Click "My Apps" in the top right corner
- • Click green "Create App" button
- • Select "Other" as use case → Click "Next"
- • Select "Business" as app type → Click "Next"
- • Enter app name (e.g., "My Store WhatsApp") and your email
- • Click "Create App" and complete verification
Add WhatsApp Product
- • In your app dashboard, scroll to find "WhatsApp" product card
- • Click "Set up" button on the WhatsApp card
- • Select or create a Business Portfolio when prompted
- • You'll be redirected to WhatsApp API Setup page
Get Your Phone Number ID
- • On API Setup page, look for the "From" section
- • You'll see a test number (e.g., +1 555...)
- • Below it, copy the Phone Number ID (looks like:
123456789...) - • Save this ID - you'll need it for Mujteknify Chat settings
Generate Access Token (Temporary)
- • On the same page, find "Temporary access token" section
- • Click "Generate Token" button
- • Copy the token immediately (starts with
EAAA...) - • ⚠️ Warning: This token expires in 24 hours!
Create Permanent Token (Highly Recommended)
- • Go to Meta Business Settings → System Users
- • Click "Add" to create new system user (name it "Mujteknify Chat Bot")
- • Give it Admin role
- • Click on the newly created user
- • Click "Generate New Token"
- • Select your app and check permissions:
whatsapp_business_messaging - • Click "Generate Token" and copy it
- • ✅ This token never expires - perfect for production!
Configure Mujteknify Chat Plugin
- • In WordPress, go to Mujteknify Chat → Settings
- • Paste your Phone Number ID in the first field
- • Paste your Access Token (permanent or temporary) in the second field
- • Click "Save Changes"
- • Click "Test Connection" button to verify
- • ✅ If successful, you're ready to send WhatsApp messages!
Required Credentials
Found in API Setup panel. Looks like:
10593...
Generate this in Business Settings -> System Users.
Webhooks Setup
Webhooks allow Mujteknify Chat to receive real-time updates (like message delivery status) from WhatsApp.
Your Webhook Configuration
Paste these values in your Meta App Dashboard under WhatsApp > Configuration > Webhooks.
Automation Rules
Set up automated WhatsApp messages triggered by WooCommerce order status changes. Keep your customers informed without lifting a finger.
Save Time: Automation rules send messages automatically when order status changes (e.g., Pending → Processing → Completed)
How to Set Up Automation:
Navigate to Automation
Go to: Mujteknify Chat → Automation
Create New Rule
- • Click "Add New Rule"
- • Give it a descriptive name (e.g., "Order Confirmed")
- • Select trigger: Order Status Changed
Choose Status Trigger
Select which status change triggers the message:
Write Your Message
Compose the message using variables:
Your order #{{order_id}} is now being processed!
Total: {{order_total}}
We'll notify you once it ships. 📦
💡 Use variables section for available placeholders
Enable & Save
- • Toggle the rule to Active
- • Click Save Rule
- • ✅ Automation is now live!
💡 Popular Automation Rules
Bulk Messaging
Send promotional campaigns, announcements, or updates to multiple customers at once. Perfect for flash sales, new product launches, or important notices.
Best Practice: Always include opt-out options and send valuable content to maintain high engagement rates.
How to Send Bulk Messages:
Go to Bulk Messaging
Navigate to: Mujteknify Chat → Bulk Messaging
Select Recipients
Choose your target audience:
- • All Customers: Everyone in your database
- • Filter by Orders: Customers who placed orders (e.g., last 30 days)
- • Filter by Amount: Customers who spent over $X
- • Custom List: Upload phone numbers via CSV
Compose Your Campaign
Hey {{customer_name}}!
Get 30% OFF everything for the next 24 hours!
Use code: FLASH30
Shop now: {{shop_url}}
- {{shop_name}}
🎯 Personalize with variables for better engagement
Schedule or Send Now
- • Send Immediately: Messages go out right away
- • Schedule: Pick date & time for future delivery
- • Batch Sending: Add delays to avoid rate limits
Review & Launch
- • Preview your message
- • Check recipient count
- • Click Send Campaign
- • ✅ Monitor delivery in the dashboard
💡 Campaign Ideas That Work
Limited-time discounts with urgency
Announce new products to engaged customers
Special discounts for customer birthdays
Notify about popular item restocks
Chat Widget
Add a floating WhatsApp button to your website so customers can contact you directly with one click.
Pro Tip: The widget appears on all pages and opens WhatsApp with a pre-filled message.
Widget Setup:
Enable Widget
Go to: Mujteknify Chat → Settings → Widget Tab
Toggle "Enable Chat Widget" to ON
Configure Settings
- • WhatsApp Number: Enter your business WhatsApp number
- • Pre-filled Message: Default text (e.g., "Hi! I need help with...")
- • Button Position: Bottom-left or bottom-right
- • Button Color: Match your brand colors
Customize Appearance (Optional)
Save & Test
- • Click Save Changes
- • Visit your website in a new tab
- • Look for the floating WhatsApp button
- • Click it to test the functionality!
✨ Widget Features
Variable System
Use these variables to personalize your messages. They will be replaced dynamically.
{{customer_name}}
John Doe
{{order_id}}
12345
{{order_total}}
$99.00
{{tracking_url}}
https://...
{{checkout_url}}
Recovery Link
{{shop_name}}
My Store
Troubleshooting
Messages Not Sending
Possible Causes:
- • Invalid or expired Access Token
- • Incorrect Phone Number ID
- • WhatsApp number not verified with Meta
Solutions:
- ✅ Generate a new permanent access token (see API Configuration)
- ✅ Double-check Phone Number ID is correct
- ✅ Test connection in Mujteknify Chat Settings
- ✅ Verify your phone number in Meta Business Portfolio
Webhook Verification Failed
Possible Causes:
- • Incorrect Verify Token
- • SSL certificate issues (site not HTTPS)
- • Webhook URL not accessible
Solutions:
- ✅ Copy Verify Token EXACTLY from Mujteknify Chat Settings
- ✅ Ensure your site has a valid SSL certificate (HTTPS)
- ✅ Check that your webhook URL is publicly accessible
- ✅ Temporarily disable security plugins that might block Meta
Bulk Messages Partially Failing
Possible Causes:
- • Invalid phone number format
- • Rate limiting from Meta (too many messages too fast)
- • Some customers blocked your number
Solutions:
- ✅ Ensure phone numbers include country code (e.g., +234XXXXXXXXXX)
- ✅ Add delays between bulk messages (use batch sending feature)
- ✅ Check Meta Business Manager for any restrictions
- ✅ Review failed messages in log for specific errors
Variables Not Replacing
Possible Causes:
- • Incorrect variable syntax
- • Variable not supported for that message type
Solutions:
- ✅ Use double curly braces:
{{customer_name}} - ✅ Check Variables section for supported variables
- ✅ Test with a simple variable first like
{{order_id}}
Frequently Asked Questions
Why are my messages not sending?
Check your API credentials in Settings. If you are using a Temporary Access Token, it may have expired (they last 24 hours). Generate a Permanent Token in Meta Business Settings.
Does it work with HPOS?
Yes! Mujteknify Chat Pro is fully compatible with WooCommerce High-Performance Order Storage (HPOS).