Skip to content

OneMessengerHub WhatsApp

What It Does

Send WhatsApp notifications to customers and admins when orders are placed. Uses the OneMessengerHub API service to deliver messages directly to WhatsApp.

When to Use It

Enable this plugin if you want to:

  • Send automatic order confirmations to customers via WhatsApp
  • Get instant WhatsApp alerts when new orders arrive
  • Reach customers on their preferred messaging platform
  • Maintain a professional communication channel
  • Use a reliable WhatsApp business messaging service

How It Works

You register for an OneMessengerHub account, configure your API key, and the system automatically sends WhatsApp messages when orders are placed. Messages are delivered through the OneMessengerHub WhatsApp Business API.

Setup Instructions

Step 1: Create an OneMessengerHub Account

  1. Visit onemessengerhub.com
  2. Register for an account
  3. Complete the verification process
  4. Navigate to the Session API settings in your dashboard

Step 2: Get Your API Key

  1. In your OneMessengerHub dashboard, go to Session API settings
  2. Create a new API key or copy your existing one
  3. Save this API key - you'll need it in Step 3

Step 3: Enable the Plugin

  1. In your store admin, click Modules → System Settings → Plugins
  2. Find the OneMessengerHub WhatsApp card
  3. Click Configure
  4. Enable the plugin using the toggle switch
  5. Fill in the configuration fields:
  6. API Key: Paste the API key from Step 2
  7. Configure notification settings (see below)
  8. Click Save

Step 4: Test the Plugin

  1. Click the Test button on the plugin card
  2. Enter a phone number to receive a test message
  3. The system will send a test WhatsApp message
  4. Check WhatsApp - you should receive the test message

If the test works, you're all set!

Configuration Fields

API Configuration

API Key

Type: Text Required: Yes Description: Your OneMessengerHub API key from the Session API settings

Where to get it: Create or copy from your OneMessengerHub dashboard

Notification Settings

Notify Customer

Type: Checkbox Default: Enabled (checked) Description: Send WhatsApp confirmation to customers when they place orders

Requirements: - Customers must have a valid mobile number in their account - The mobile number must be registered on WhatsApp

When to disable: If you only want admin notifications

Notify Admin

Type: Checkbox Default: Enabled (checked) Description: Send WhatsApp alert to admin when new orders arrive

Requirements: - Admin must have a valid mobile number configured - The mobile number must be registered on WhatsApp

When to disable: If you don't want to receive order notifications

Phone Number Format

OneMessengerHub requires phone numbers in international format:

Correct formats: - 966501234567 (Saudi Arabia) - 971501234567 (UAE) - 201001234567 (Egypt)

Incorrect formats: - +966 50 123 4567 (spaces and + sign) - 0501234567 (missing country code) - 00966501234567 (double zero prefix)

The plugin automatically cleans phone numbers by: - Removing spaces, dashes, and parentheses - Converting Arabic numerals to English - Removing + prefix - Removing 00 prefix

How Messages Are Sent

Messages are sent asynchronously using background jobs:

  • Orders are created immediately
  • WhatsApp messages are queued and sent within seconds
  • If the service is temporarily unavailable, messages are retried automatically
  • Failed messages are logged for troubleshooting

This ensures fast checkout even if message delivery is delayed.

Troubleshooting

Messages not sending?

  1. Verify your API Key is correct (no extra spaces)
  2. Check your OneMessengerHub account is active
  3. Ensure the phone number is valid and on WhatsApp
  4. Check the message logs in your OneMessengerHub dashboard

"Missing API key configuration" error?

  1. Go to plugin configuration
  2. Enter your API key from OneMessengerHub dashboard
  3. Save the configuration

Customer not receiving messages?

  1. Verify "Notify Customer" is enabled
  2. Check customer has a valid phone number saved
  3. Ensure the phone number is registered on WhatsApp
  4. Verify the phone number format is correct

Admin not receiving messages?

  1. Verify "Notify Admin" is enabled
  2. Check admin phone number is configured correctly
  3. Ensure the phone number is registered on WhatsApp

Best Practices

Phone Number Collection

  • Request phone numbers in international format during registration
  • Validate phone numbers before saving
  • Allow customers to verify their WhatsApp number

Message Content

Do: - Keep messages concise and professional - Include essential order information - Provide tracking links when available

Don't: - Send excessively long messages - Include sensitive payment details - Send promotional content without consent

Privacy & Compliance

  • Get customer consent for WhatsApp notifications
  • Comply with WhatsApp Business messaging policies
  • Respect customer preferences for communication channels
  • Follow privacy regulations (GDPR, etc.)