Platform Demo (Watch This First)
Locations Step-by-Step Guide
Devices Step-by-Step Guide
Campaigns Step-by-Step Guide
Connecting Your SH100 Hotspot
Account Management Overview
Contacting Technical Support
Managing your Account Details
Changing your Account Password
The Social Wi-Fi Guest Experience
How to whitelist MyWiFi emails to receive all announcements
Devices & Hardware
White Label Hardware
Enabling the DNS Content Filter
SH100 Firmware Upgrade
How To Install SH100 On Location
Presence Analytics for MyWiFi Networks Devices
SH100 Recovery Firmware Upgrade
Guest Hotspot Manual Firmware Upgrade
SH50 Guest Hotspot User Guide
Cisco Meraki Cloud Integration (Existing Manual Setup)
Cisco Meraki Presence Analytics (CMX) Integration
Cisco Meraki Cloud Integration (Automated API Setup)
Open Mesh CloudTrax API Integration
Open Mesh CloudTrax Integration (Manually)
Open Mesh CloudTrax Presence Analytics Integration
CloudTrax Demo (Video)
CloudTrax Setup Part 1: Overview
CloudTrax Setup Part 2: Creating A New Network
CloudTrax Setup Part 3: Configuring Your Network and SSIDs
CloudTrax Monitoring, Management and Troubleshooting
Cisco Enteprise Wireless
Firmware Installation for GLI GL-AR150 Devices
Firmware Installation For Nexx WT-3020F (Mini Device)
How to Install MyWiFi OpenWRT Firmware on Teltonika RUT900
Compatible OpenWRT Devices
How to Install Linksys WRT160NL Firmware
List of Supported Hardware Devices
How to Set Session Time Limits
Automatic Firmware Updates for MyWiFi Supported Devices
Disabling and Deleting Devices
Supported Session Controls for Devices
White Label Radius Servers
Adding Devices to Your Location
Editing Location Settings
Add Sub-Users to Locations
How to Limit Bandwidth and Session Times Per Guest
Whitelisting and Blacklisting Devices
Smart Lists & Broadcast Actions
Default Language for Locations
Creating Campaigns From Facebook Pages
How to add Custom Terms & Conditions to your campaign
Create a Multi-Language campaign
Edit or Change your SSID
Creating Your Thank You Page
Adding a Redirect
Mobile Application Redirect
WhatsApp Post-Login Redirect
How To Use The Campaign Preview Link
Adding A Weather Widget
Add your Facebook Pixel for Ad Retargeting
Customizing Campaigns with CSS
Dynamic URL Merge Tags for Redirects
Branding Your Campaign
Advanced Campaign Settings
Email Custom Form
Text Message (SMS)
Credit Card Payments
Choosing Your Login Options
WYSIWYG Email Editor
Marketing Automation Overview
Dynamic Merge Tags for E-Mail / SMS - Automations
Analytics & Reports
Global Analytics Dashboard
Timeline Guest Stream
Location Analytics Overview
Exporting Your Guest Data
What is Presence Analytics?
Custom Analytics Report
Clients Manager Overview
Editing Users and User Access Levels
Creating Sub Users via API
Sub-Users → Clients Manager Update
Sending Analytics Reports to Your Clients
Privacy & Compliance
Privacy & Compliance Tools
Who Does The GDPR Apply To?
The GDPR Obligations for EU Channel Partners
The GDPR Platform Compliance Process
The GDPR Overview
About Compliance and Consent
Device Connection Issues
Why is my router is showing offline/never connected?
Why is my Device Not Displaying the SSID From My Campaign? (Flashed Device)
How Can I Manually Change My Device's IP Address?
Social App Issues
MAC Address Issues
I Entered the Wrong MAC Address. How Can I fix it?
Why Does My MAC Address Not Match the Default SSID?
Landing Page Issues
Why aren't my guests seeing a landing page?
Why Are Guests Unable to Access the Splash Page on Open Mesh?
Why Are Guests Unable to Access the Splash Page? (Flashed Device)
Mikrotik Configuration Troubleshooting
Do repeat users have to login on each visit?
Why is Google Login not supported?
Logging Off A Connected User
Which connection methods does MyWiFi support?
How do I approach a customer who is already receiving Free Wi-Fi?
What if I have customers that don’t use social media?
Where can I get routers?
Will my business/personal internet be secure?
What if the business has several locations?
Does this work in my country?
What is MyWiFi?
What happens if you purchase a device from shop.mywifi.io and the client cancels?
What's included with the Enterprise plan?
How do I find out my Device MAC address?
How do you setup a client with multiple venues within the location, such as a Hotel?
Does every location require an Access Point?
Where can I download firmware for my router?
What is the user limit of the SH100?
Session Times Overview & Use Cases
Why are the ports on the back of the pre-programmed Hotspot disabled?
When multiple routers are used, how does a customer connect to the network?
My router is showing "offline" or "Never Connected"
Why choose free Wi-Fi over data?
Where can I find a list of supported devices?
What is a mesh network and how does it work?
How do I reset my router?
When deploying multiple routers at the same location, do they have to be the same model?
Can you use a router as a switch?
Why do my AdSense Ads show as code in my Campaign?
Why am I receiving a 400 error when trying to login with Instagram?
Why is Open Mesh/Cloudtrax not reporting Presence Analytics?
Why is my Gmail app is not working in my Automation?
Why am I receiving demo page when visiting my Custom Social Portal?
Where is the Website Template?
Why am I seeing so many Automation errors?
Why can’t I upload an image to my Campaign?
How do I set up up CNAMEs for my Custom Domains?
Why am I not seeing the Splash page after Adding Cloudtrax by API?
Why am I receiving an 18005 error when flashing my TP-Link device?
Why am I receiving the generic Demo Campaign when I login?
Which login apps capture names and email addresses?
Why Don’t I see my Campaign’s SSID?
Why am I receiving an error when trying to add a UniFi device?
Do you offer Corporate Website Customization?
Why am I getting an error when trying to create a campaign/location from Facebook?
Why am I receiving a URL blocked error when I try to login with Facebook?
Why is my Mikrotik device not displaying the Splash Page?
Why am I receiving the error "Make sure your CNAME is pointed correctly"?
Why are Guests are not seeing the Splash Page when they login?
Why are my Ads not redirecting when clicked on?
How can I test my social logins?
Why is my device showing online when it is disconnected?
Why is the SH100 showing slow bandwidth speeds?
How can I customize my Sales CRM Previews?
Why are my Automations being withheld?
How far back does accessible Analytics data go?
Why am I not seeing Presence Analytics on the SH100?
How can I create/edit an email for my Automation?
What are session limits?
Why is my custom app not available in my Campaign?
Do you supply me with a router?
When clients/customers are retargeted on their Smartphone, does it transfer to their home computer?
Will I need technical assistance to set this up?
I have a Cruise Terminal interested in Wi-Fi services, what do you recommend for a revenue share?
Where do I find the analytics for each location?
Why can I no longer access my router's Admin console?
Do I need to have Social Media accounts to use MyWiFi?
Do I need an internet connection to use MyWiFi?
Can you have more than one campaign per location?
Which retargeting service do you recommend?
Do you need to setup a Facebook App for each client?
Where can I find Guest data from logins?
Can I purchase pre-configured Social Powered Hotspots directly from MyWiFi?
What is the shipping cost and how long will it take to get my unit?
How does the MyWiFi Platform work?
Do I have to be technical to use MyWiFi?
What Cloud Controllers does MyWiFi integrate with?
What is the typical signal range of a Social Powered Hotspot?
Will I receive a tracking number for the package?
How to Change Your Subscription Plan
Which social network login options do you support?
How do I allow my client to preview their campaign?
Can my clients login and manage their own campaigns?
What languages do you support?
Will my customers know I am using MyWiFi?
How much bandwidth does my Internet Speed need to be?
Do you ship to my country?
Can I limit the amount of bandwidth and time users can consume?
I already have a Wi-Fi router, why do I need a new device?
How does advertising work with Social Powered Wi-Fi Marketing?
What is the user limit of a Social Powered Hotspot?
Do I have to be in the client’s location to manage their Social Powered WiFi Hotspot?
What is the minimum recommended Internet speed to use a Social Powered Hotspot?
What hardware can I use with MyWiFi?
Can I see how many customers have connected to Social Wi-Fi campaigns?
Can I use my own social connection apps?
Do you provide marketing materials with your Social Wi-Fi Marketing program?
Which autoresponders do you currently integrate with?
What can I charge my clients for Social Powered Wi-Fi Marketing services?
What type of campaigns can I create?
Where can I find the Members Area?
List of All Platform Features
Glossary of Wi-Fi and Networking Terms
Submitting A New Feature Request
Table of Contents
Updated by Kevin Zicherman
This guide will assist you in preparing your UniFi Cloud Controller (v5+) for Social Guest Access, and associating it to the MyWiFi system for the purpose of enabling Social Campaigns and Guest authorization through Social Login.
UniFi Controller Pre-Setup
Retrieve the credentials to an existing administrator account OR create an additional administrator account within your UniFi Cloud Controller. This is necessary to grant the MyWiFi System the ability to manage the following items on your behalf:
- To enable Guest Portal access on the UniFi Site you select
- To associate Social Login functionality to a Wireless Network of your choice that you have named “mywifi” [NOTE: You may change this post-setup]
- To authorize the MAC Address of Guest devices for Internet access after they perform the Social Login
NOTE: The credentials we are requesting are collected and stored securely in a 256-bit encrypted format. Our system retrieves and applies these credentials only for the purpose of communicating with your UniFi Cloud Controller API. It performs this strictly for the uses outlined above. We do not share this information with any 3rd parties, and we do not access, collect or use this information for purposes other than the uses outlined above.
In your UniFi Cloud Controller >> Settings >> Site:
Create or identify a SITE within your UniFi Cloud Controller that contains the Access Points you have selected for Guest Access, and that will be associated with the MyWiFi System.
In your UniFi Cloud Controller >> Settings >> Wireless Network:
Create a Wireless Network that will be Enabled for Guest Access and associated with the MyWiFi System for the purposes of Social Guest Access, with the following settings:
- Name/SSID: mywifi
- Enabled: Checked
- Security: Open
- Guest Policy: Checked
- Login into the MyWiFi Dashboard with your MyWiFi Account
- Create/identify an appropriate Social WiFi Campaign with the Social Media Logins and customize it according to your needs.
- Create/identify an Existing Location for your deployment & assign your created Campaign as the Default Campaign for this Location.
Once you have completed these actions you may add the UniFi Cloud Controller as a new MyWiFi Device.
- Click on Devices >> Add New Device button - to bring up the Add Device form
- Select UniFi Cloud Controller from the Supporters Routers dropdown & proceed to enter the following information:
- Name for this Device
- Username/Password credentials for the UniFi Cloud Controller Administrator Account you created previously
- The URL of your UniFi Cloud Controller (excluding PORT)
- Port of the UniFi Cloud Controller
[port 8443 is the DEFAULT port]
- Select the Dashboard Location you have previously created/identified
- Click NEXT once you have entered the appropriate information correctly
- On Step 2: Select the UniFi SITE that you have identified earlier, to associate to the MyWiFi System
- Click on Complete Setup once you have selected a SITE
When you perform this action, the following will be done by the MyWiFi System automatically through API Access to your Cloud Controller:
- Load & Associate the Wireless Network you have created and named “mywifi”
- Load & Associate the Access Points MAC Addresses contained within the Site selected
- Apply Guest Control Settings to the Site Selected [Enable Guest Portal, External Portal Server, Custom Portal IP, Custom Portal Hostname, Enable HTTPS Redirection, Set Access Control List]
Confirm UniFi Cloud Settings
You may now log in again into your UniFi Cloud Controller to confirm the settings have been applied successfully.
In your UniFi Cloud Controller >> Settings >> Wireless Networks:
You may now modify the name of the Wireless Network to one of your choosing. (You may alter the Wireless Network name at any time now or in the future, it will not adversely affect anything regarding this setup)
In your UniFi Cloud Controller >> Settings >> Guest Control:
Ensure you have the following selections.
- Authentication: external portal server
- Use Secure Portal: Checked
- Redirect using hostname: <Your Custom Portal Domain> OR securewifilogin.com
- Enable HTTPS Redirection: Unchecked
Also please ensure that you have the confirmed your Access Control - Pre-Authorization Access List.
Ensure you have your Custom Portal Domain listed if Enabled within your MyWiFi Dashboard.
The UniFi Pre-Authorization Access List (aka. Whitelist) does not support wildcard domain names. As such it is inflexible and might not be entirely accurate in its coverage of whitelisting the appropriate domains necessary.
We attempt to maintain and set an accurate list of all the domains & IP Addresses necessary to perform social login through the external social networks we support. However this list may need custom additions/alterations based on localized version of the social login methods you employ, or custom items you may have in your captive portal process.
Do note that we have added the Facebook IP Range on the list we provision during the setup performed in the earlier steps. We do NOT however include the Google IP Range to the provisioning list.
More information regarding these IP Ranges can be found in this Ubiquiti Support Guide: https://help.ubnt.com/hc/en-us/articles/115000871247-UniFi-Social-Media-Guest-Authentication
The reason we have omitted the Google IP Range, is because whitelisting the Google IP Range will prevent the Captive Portal Assistant from launching on Android Devices.
Congratulations! You have completed the UniFi Cloud Controller Integration.
Please review the additional information below as it is very important.
Access Point Changes
If you make changes to your UniFi Access Points by Re-Configuring, Adding and/or Removing Access Points. You will have to Refresh the MyWiFi Access Point Lists for the MyWiFi Device associated to your UniFi Site.
You can perform that by navigating in the MyWiFi Dashboard to Devices >> click on Edit button for the Device Associated to your UniFi Site, and click on the Refresh button located by the Access Point MAC Address List.
SSID [Wireless Network Name]
The Wireless Network name is strictly controlled from your UniFi Cloud Controller >> Settings >> Wireless Network. The SSID field located in the MyWiFi Dashboard >>> Campaign section does not apply to Cloud Controlled Devices such as your UniFi Cloud Controller.
Guest Authorization Optimization
Depending on your individual installation specifications, the time between the Guest completes the Social Login and the time they are actually authorized for full internet access by the Access Point might be of an extended duration (10-60s).
The MyWiFi System performs the authorization to your UniFi Cloud Controller instantly after the Guest completes the Social Login.
However there is an additional authorization step between the Cloud Controller and the Access Point. Depending on the deployment method, location and the communication time, this process can take a considerable amount of time affecting the quality of the guest experience.
We recommend that you optimize your deployment to facilitate optimal communication between the MyWiFi System to your Cloud Controller and between your Cloud Controller and your Access Points.
We also recommend that you set a Campaign Redirect time of 30 seconds.
Bandwidth & Session - Set Session Limits
This UniFi Cloud Controller integration will allow you to control the Guest Session Time limit in the MyWiFi Dashboard. This can be set in the MyWiFi Dashboard >> Location >> Location Edit >> Options tab.
This UniFi Cloud Controller integration will NOT allow you to control Guest Bandwidth Limits or any other Session limits. This can be further controlled at your discretion from the UniFi Cloud Controller.
Guest Bandwidth and Session Information Limits
This UniFi Cloud Controller integration will not import any Guest Bandwidth or Session Time information within the MyWiFi Dashboard. This is because the UniFi Guest Access system does NOT support External RADIUS servers for External portal server guest access. You may view this information in the Client section of the UniFi Cloud Controller and co-relate to the MyWiFi System it by matching up the Guest MAC address.
Refreshing / Reprovision - UniFi Cloud Controller Guest Settings
You may refresh / re-provision the settings applied to your UniFi Cloud Controller at any time by navigating in the MyWiFi Dashboard to Devices >> click the Edit button on the Device Associated to your UniFi Site, and click on the Update button located on the lower right.
This will re-provision all the appropriate settings for Guest Access [Enable Guest Portal, External Portal Server, Custom Portal IP, Custom Portal Hostname, Enable HTTPS Redirection, Set Access Control List].
The "Disconnect" Trigger is not supported on Automations that are attached to Locations and/or Campaigns that are deployed to UniFi Devices. Automations that are set for this trigger type will be ignored. However these Automations still work appropriately on the same Location and/or Campaign that deploy Devices that are not Unifi. This is related to the same limitation previously outlined above: "Guest Bandwidth and Session Information Limits".