How does this integration work?
Envoy sends visitor information to UniFi, which then provisions a temporary voucher for Wi-Fi access to your network. Upon sign-in, the visitor will receive an email (if you collect visitor email addresses) and/or text message (if you collect visitor phone numbers) with a voucher code for Wi-Fi access.
PREREQUISITES
You must collect either visitor email addresses or phone numbers at sign-in. Learn more about how to configure your Envoy sign-in fields.
Whitelist Envoy's IP addresses to allow a connection to your UniFi controller.
54.84.138.60
54.84.66.109
Enabling the Envoy + Ubiquiti UniFi integration
Under Wi-Fi, find Ubiquiti UniFi (beta 2025). Click Install and then Configure.
Enter your UniFi Controller URL (on-prem IP and port, or Cloud URL). Example URL: https://136.xx.xx.xx:8443
Enter your API Token, then click Next Step.
Select your network site from the drop-down, then click Next Step.
Please ensure that this site has a guest network and guest portal configured.
Enter your Guest Network name that visitors will connect to.
Optional: Select Visitor types to block from receiving Wi-Fi credentials.
Optional: Send guest Wi-Fi credentials to hosts. This is useful when visitors do not have easy access to email or text messages or if they are not required to enter their email address or phone number at sign-in.
Click Complete setup.
After completing the Envoy installation, navigate to the Ubiquiti UniFi dashboard, then select Settings -> Guest Control. Find Authentication under Guest Policies and select Hotspot.
UniFi Network portal setup
Guest Control configuration example:
Wireless Networks configuration example:
FAQ
Have you updated to UID and having issues with your credentials?
You will need to update settings to allow previous admin credentials.
