1. Install and Activate
After uploading the ZIP file, go to Extensions → My Extensions. Click Install and then Activate for WhatsApp Connect. Clear the cache under Settings → System → Caches & Indices.
2. Basic Settings
Open the plugin configuration at Extensions → My Extensions → WhatsApp Connect → Configuration.
Card: Basic Settings for WhatsApp Connect
Enter your WhatsApp number in international format, e.g. 4917612345678 (without +, spaces or dashes). Choose one of the 4 widget designs:
- Floating Bubble — Round button, freely positionable
- Side Tab — Vertical tab on the page edge
- Banner Bar — Slim stripe across full width
- Minimal Button — Just a small WhatsApp icon
Optional: Set a pre-filled message. The placeholder {page_url} is automatically replaced with the current page URL so you can see which page the customer is writing from.
3. Configure Chat Window (Single User or Company Profile)
Card: Chat Window for WhatsApp Connect (Single User or Company Profile)
Set the profile name and a short description (e.g. "Customer Service" or "Reply within 24h"). Optional: profile image as URL, welcome message and offline message.
The four placeholder texts automatically adapt to the status (online, select member, fallback, closed). These are translatable per sales channel.
4. Set Up Team Mode (optional)
Card: Team Mode for WhatsApp Connect
Enable team mode and choose the selection mode:
- Customer Choice — The customer selects their contact from a list
- Random — A random available agent is assigned
Set a fallback number for when no agent is available.
Cards: Team Member 1-5 for WhatsApp Connect
For each team member you can configure:
- Name, WhatsApp number, department, caption
- Profile image (as URL)
- Individual working hours per weekday (format: 09:00-18:00)
- Vacation mode with date range and absence message
Members who are on vacation or outside their working hours are automatically removed from the selection.
5. Schedules and Availability
Card: Online/Offline Schedule for WhatsApp Chat Messages
Enable the global schedule to set maximum availability. Enter times for each weekday in the format 09:00-18:00. Empty = not available on that day.
Important: Even if individual team members have longer working hours configured, they are only reachable within the global schedule. All times are based on the Europe/Berlin timezone.
Choose the offline status color (yellow = "will read later", red = "unavailable") and whether to hide the widget completely when offline.
6. Auto Message
Card: Auto Message for WhatsApp Connect
Enable the automatic welcome message. After the configured delay (3-120 seconds), a notification badge with "1" appears on the bubble, optionally with a notification sound. The message is shown once per browser session.
The auto message text is displayed in the chat popup as a shop owner message when the customer clicks the bubble.
7. Device-Specific Settings
Card: WhatsApp Connect Device Settings
Set on which devices the widget is visible and which chat method to use:
- Start Chat — Opens WhatsApp directly (recommended for mobile)
- Send Message — Shows an input field (recommended for desktop)
Both methods always show a chat preview first so the customer sees the shop's message.
8. Position and Layout
Card: Position & Layout for WhatsApp Connect Widget
Set alignment (left/right), vertical and horizontal offsets, corner radius and z-index. Widget size can be scaled per device in percent (50-150%).
9. Customize Colors
Card: Color Customization for WhatsApp Connect
Customize all colors to match your shop design: bubble background, icon color, chat header, message bubbles, send button and more.
10. Advanced Settings
Card: Advanced Settings for WhatsApp Connect
- Scroll Behavior: Hide widget while scrolling
- Google Tracking: Automatically send events to GTM/GA4
- Debug Mode: Detailed information in browser console (developers only)
- Custom CSS/JS: Custom adjustments without theme changes
Multilingual Support
All text fields (welcome message, offline message, button texts, placeholders etc.) can be configured differently per sales channel. Switch the sales channel at the top of the configuration page.