How to White-Label Our WhatsApp Widget Plugin for Your WordPress Agency: A Step-by-Step Guide

by

Hey there, agency owners and WordPress wizards! If you’re managing multiple client sites and want to offer a seamless, branded WhatsApp click-to-chat experience, our free ToChat.be WordPress plugin is a game-changer. This white-label version lets you rebrand the entire plugin as your own—your name, your links, your control panel—making it look like a custom tool you’ve built just for your clients.Why bother? It adds massive value: clients get a floating WhatsApp button for instant chats, lead capture, and analytics, all tied back to your branded dashboard. No “powered by ToChat.be” anywhere. Perfect for agencies handling 5, 10, or 20+ sites—bundle it with your services for that premium feel and easier upsells.In this tutorial, we’ll walk you through downloading, customizing, installing, and configuring the plugin. It’s straightforward, with just a quick code edit for full white-labeling. Let’s dive in!

Full video with demo and links: https://youtu.be/5VTudh9rRp0

Prerequisites

  • A ToChat.be account (sign up free at tochat.be if you haven’t).
  • Access to a white-label domain (optional but recommended for agencies—set this up in your ToChat.be account for custom branding like youragency.tochat.be).
  • Basic file editing skills (we’ll use a text editor like Notepad++ or VS Code).
  • Admin access to your (or your client’s) WordPress site.

Note: This plugin isn’t in the official WordPress repository—it’s a direct download for our users.

Step 1: Download the Plugin

  1. Head to our blog post for the latest version: New Plugin for WordPress WhatsApp Widget.
  2. Click the download link for the ZIP file (version 1.4.1 as of now): Direct ZIP Download.

Unzip the file to a folder on your computer. You’ll see files like init.php—that’s where the magic happens next.

Step 2: Customize for White-Labeling (Edit the Code)

This is the key step to make it 100% yours. We’re just tweaking four lines in one file—no advanced coding required.

  1. Open the unzipped folder.
  2. Locate and open init.php in a text editor (e.g., right-click > Open with Notepad).
  3. Find these four lines (they’re clearly marked near the top):

Example before / after:

  1. // Before define('TOCHATBE_PLUGIN_NAME', 'ToChat.be WhatsApp Widget'); define('TOCHATBE_AGENCY_URL', 'https://tochat.be'); define('TOCHATBE_DOCS_URL', 'https://tochat.be/docs'); define('TOCHATBE_PANEL_URL', 'https://services.tochat.be'); //

  1. After define('TOCHATBE_PLUGIN_NAME', 'Awesome Agency Chat Pro'); define('TOCHATBE_AGENCY_URL', 'https://awesomeagency.com'); define('TOCHATBE_DOCS_URL', 'https://awesomeagency.com/help/chat-widget'); define('TOCHATBE_PANEL_URL', 'https://awesomeagency.tochat.be');
  2. Save the file. That’s it—your plugin is now branded!

Pro Tip: If you have a white-label ToChat.be account, use your custom domain for the panel URL to keep everything seamless.

Step 3: Re-Zip the Folder

  1. Select the entire folder (not just the files inside—make sure it’s the root folder named something like “tochatbe-widget-white-label”).
  2. Right-click and compress it into a new ZIP file:
    • On Mac: Right-click > Compress.
    • On Windows: Right-click > Send to > Compressed (zipped) folder.
  3. Name it something clear, like “youragency-whatsapp-widget.zip”.

Step 4: Upload and Install on WordPress

  1. Log into your WordPress admin dashboard.
  2. Go to Plugins > Add New > Upload Plugin.
  3. Choose your new ZIP file and click Install Now.
  4. Once installed, click Activate Plugin. You’ll see a new menu item with your custom name (e.g., “Awesome Agency Chat Pro”).

Step 5: Configure the Plugin

  1. Navigate to your new plugin settings (under the custom name in the sidebar).
  2. Paste your Widget Key from ToChat.be:
    • Log into your ToChat.be account > Go to your widget > Copy the unique key.
  3. For analytics: Enter your ToChat.be username and password to connect (this pulls in stats like clicks, leads, and referrals securely).
  4. Customize display options:
    • Exclude specific pages/posts (use wildcards like /blog/).
    • Show only on certain categories or languages.
  5. Save changes. Visit your site (not in preview mode) to test the floating WhatsApp button.
  6. Enable the dashboard module: In your WP dashboard, click Screen Options (top right) and check the box for your custom plugin’s analytics widget. Now you’ll see real-time metrics right there!

Step 6: Share with Clients and Manage Access

  • Install the plugin on client sites using the same customized ZIP.
  • For client access: Use the white-label panel URL you set—share a guest link so they can view stats/leads without full account access.
  • Track everything centrally in your agency dashboard.

Tips and Best Practices

  • Updates: When we release a new version, download it, repeat the edit/re-zip steps, and update via WordPress (deactivate old, upload new). It’s quick!
  • Security: Always use your own credentials; the connection is encrypted.
  • Advanced Features: Combine with Google Site Kit or Jetpack for a unified analytics view. Future updates will add bookings and deeper lead insights.
  • Testing: After install, clear your cache and test on mobile/desktop for the best user experience.
  • Troubleshooting: If the widget doesn’t show, double-check the key and display rules. Reach out to our support or check our YouTube tutorials (search “Cesar from ToChat.be”).

By white-labeling this plugin, you’re not just adding a chat button—you’re delivering a polished, agency-branded solution that boosts client retention and showcases your expertise. If you manage multiple sites, this could save hours of tab-switching and make your services stand out.Give it a try and let us know in the comments how it works for you!

Questions? Use our WhatsApp Widget.

Leave a comment