Why Omada + VoqadoWiFi Is the Most Common Deployment
TP-Link Omada is the most frequently installed enterprise WiFi system among our new customers, accounting for approximately 58% of onboarding venues. Its combination of affordable hardware, reliable performance, and a capable cloud management platform makes it the default choice for most hospitality operators who want to move beyond consumer-grade routers without the cost of Cisco Meraki or Aruba.
The VoqadoWiFi integration with Omada is the most mature we offer, with a direct API connection to the Omada Software Controller for captive portal management and session data. This guide covers the complete setup from start to first live portal session.
What You Need Before You Start
Before beginning the setup, confirm you have the following in place:
Hardware: - TP-Link Omada EAP access point(s) — any model from the EAP225 or newer is supported. EAP670 and EAP670 Outdoor are the recommended choices for hospitality environments due to their client capacity. - Omada OC200 hardware controller, or access to the Omada Software Controller running on a local server or cloud instance.
Network: - A router or firewall with a free LAN port and the ability to create a VLAN (optional but recommended for guest network isolation) - Static IP address or DHCP reservation for the Omada controller - Outbound internet access from the controller on port 443
VoqadoWiFi account: - An active VoqadoWiFi subscription (any tier) - Your Omada controller URL and admin credentials - Your Mailchimp (or other email platform) API key, if configuring email integration at setup
Step 1: Setting Up the Guest SSID in Omada
Log into your Omada controller. Navigate to Settings > Wireless Networks and create a new SSID.
Recommended SSID settings: - Name: Your venue name + "WiFi" (e.g., "Koffie & Ko WiFi") — avoid "Guest" in the name, which signals a lower-priority network - Security: Open (no password) — the captive portal handles authentication - Band steering: Enabled — automatically places capable devices on 5GHz - Client isolation: Enabled — prevents guests from seeing other devices on the network - Rate limiting: Set download to 20–30 Mbps and upload to 5–10 Mbps per client — this prevents a single heavy user from degrading the experience for others
If your router supports VLANs, assign the guest SSID to a dedicated VLAN (e.g., VLAN 20) and configure your router to isolate that VLAN from your main business network. This ensures that guest devices cannot access your POS system, back-office computers, or business NAS.
Step 2: Enabling the Captive Portal in Omada
In the Omada controller, navigate to Settings > Authentication > Portal.
Select your guest SSID and enable the portal. Choose "External Portal Server" as the portal type — this is the configuration that allows VoqadoWiFi to serve the portal page instead of the Omada default.
You will see a field for the "Portal URL." Leave this blank for now — you will fill it in from VoqadoWiFi after completing the next step.
Copy and save the following values from this screen: - RADIUS Server IP (or the Omada controller IP if using RADIUS authentication) - RADIUS Shared Secret - Authentication port
These will be needed when configuring the VoqadoWiFi side of the integration.
Step 3: Connecting VoqadoWiFi to Omada
Log into your VoqadoWiFi dashboard and navigate to Locations > Add Location.
Fill in your venue details and select "TP-Link Omada" as the hardware platform.
Enter the following values: - Omada Controller URL: The full HTTPS URL of your Omada controller (e.g., https://192.168.1.10:8043 for a local OC200, or the cloud URL if using Omada Cloud) - Controller Username and Password: An Omada admin account with API access (create a dedicated API account rather than using your personal admin login) - Site Name: The site name as it appears in your Omada controller - SSID: Select the guest SSID you created in Step 1
VoqadoWiFi will verify the connection and confirm the integration is active. If the connection fails, the most common causes are: incorrect controller URL (ensure it includes the port number), firewall rules blocking outbound HTTPS from VoqadoWiFi's IP range to your controller, or the Omada account lacking API permissions.
Step 4: Designing Your Portal
Navigate to Portals > Design in VoqadoWiFi.
The portal designer offers full customisation of: - Background: Solid colour, gradient, or uploaded image. For a strong brand impression, use a high-resolution interior photo of your venue. - Logo: Upload your venue logo in SVG or PNG with transparency. - Welcome message: Keep this to one or two sentences. "Welcome to [Venue Name]. Connect to our free WiFi and we'll keep you updated on events and offers." is a proven format. - Opt-in form fields: First name and email are the recommended minimum. Do not add fields you will not use in segmentation. - Opt-in statement: This is the legally required consent text. VoqadoWiFi provides a GDPR-compliant template that you can customise with your venue name. Do not remove the unsubscribe reminder or privacy policy link. - Post-login redirect: The URL the guest is redirected to after connecting. Options: your venue website, your menu, your reservations page, or a custom landing page.
Test the portal on both desktop and mobile before going live. The majority of WiFi logins occur on mobile devices, so check the mobile layout carefully. Ensure the submit button is large enough to tap comfortably and that the form fields are not obscured by the mobile keyboard when active.
Step 5: Configuring Email Integration
In VoqadoWiFi, navigate to Integrations > Email Platforms.
For Mailchimp: enter your API key (found in Mailchimp under Account > Extras > API Keys) and select the audience you want opted-in WiFi contacts added to. VoqadoWiFi creates a tag ("WiFi Opt-in") on all imported contacts so you can segment them from existing list members.
Configure the automation trigger options: - Immediate welcome email: Sent within 60 seconds of opt-in. Recommended: a brief confirmation with your WiFi credentials (for return visits) and a simple welcome offer. - First return visit trigger: Sent when the contact reconnects to WiFi for the second time. Recommended: a loyalty acknowledgement and an offer that rewards return. - Lapsed visitor trigger: Sent when a previously active contact has not connected for 30 days. Recommended: a "we haven't seen you" message with a light incentive.
Step 6: Going Live and Monitoring
Return to your Omada controller and update the Portal URL field with the URL provided by VoqadoWiFi from your portal settings. Save the configuration.
Test the complete flow: connect to your guest SSID from a mobile device, confirm the portal appears, complete the opt-in form, and verify the redirect occurs and the contact appears in your email platform within 60 seconds.
In VoqadoWiFi's analytics dashboard, monitor the following in the first 48 hours: - Session count (should match expected footfall) - Opt-in rate (below 30% suggests the form may need simplification or the incentive may need strengthening) - Failed authentication events (indicates a configuration issue with the Omada portal settings)
If opt-in rate is low in the first week, the most effective single change is adding a concrete immediate incentive to the welcome message: "Enter your email for 10% off your next visit" consistently outperforms generic "stay updated" messaging.
Common Issues and Fixes
Portal page not loading after SSID connection: Check that the Omada "External Portal Server" setting is saved and that the VoqadoWiFi portal URL is entered correctly including the full path.
Contacts not appearing in Mailchimp: Verify the API key has write access to the selected audience. In Mailchimp, API keys can be scoped to read-only; ensure yours is a full-access key.
Guests reporting slow WiFi: Check the rate limiting settings — if the per-client limit is too low (under 5 Mbps download), guests with video-streaming habits will report poor performance. Also check channel utilisation in the Omada RF environment panel; congested channels on 2.4GHz are a common performance issue in urban venues.
Opt-in data not syncing: The VoqadoWiFi → Mailchimp sync runs every 60 seconds. If data is consistently missing, check the integration status in VoqadoWiFi under Integrations > Status and re-authenticate if the connection shows as expired.
The complete setup from hardware in place to live portal typically takes 45–90 minutes for a single-location venue with one Omada site. Our customer success team is available via in-app chat throughout the process and can screen-share for any configuration steps that are unclear.