Checklist voor de uitrol van gastenwifi voor MSP's: van site survey tot oplevering
Deze checklist loopt van het locatieonderzoek vóór de verkoop tot het einde van de eerste week van een zaak. Hij sluit aan op de uitrolhandleiding voor partners van CaptiFi en de installatiehandleidingen per leverancier, met links naar de documentatie van leveranciers voor telefoons, controllers en e-mail.
De checklist in één oogopslag
In de tabel staat bij elk punt wie verantwoordelijk is en met welke test je weet dat het klaar is; de details staan in de genummerde paragrafen eronder.
| Checklistpunt | Eigenaar | Klaar als |
|---|---|---|
| 1. Locatieonderzoek | MSP | Access points en kabeltrajecten zijn gepland op dekking en op het drukste uur, en de controller en de versie zijn genoteerd |
| 2. Gasten-SSID en VLAN | MSP | Gasten hebben hun eigen SSID en VLAN met client isolation, gescheiden van kassa's, camera's en kantoorcomputers |
| 3. Extern portal en walled garden | MSP, waarbij CaptiFi de instellingen bij sommige verbindingen zelf wegschrijft | De gasten-SSID verwijst naar CaptiFi, alle vermeldingen voor de walled garden zijn toegevoegd en de eigen portalmethoden van de controller staan uit |
| 4. Inlogpagina en toestemmingsvraag | MSP en zaak | De eigenaar heeft de pagina goedgekeurd en de vraag om marketingtoestemming staat aan |
| 5. Telefoontests | MSP | Een iPhone en een Android-telefoon die het netwerk nog niet kennen, krijgen de pagina allebei vanzelf te zien en komen online, en beide staan in Gastbezoeken |
| 6. Installatielabel | MSP | Op het label van de klant staat Klaar |
| 7. Klantlogin en overdracht | MSP en zaak | De eigenaar heeft een wachtwoord ingesteld en weet wie hij moet bellen |
| 8. Afzenderdomein | Zaak, vaak met de MSP voor de DNS | Het domein staat op Geverifieerd onder Marketing, Instellingen, Afzender & domein |
| 9. Controles in de eerste week | MSP | Elke dag gasten, en niets over de zaak in het statusoverzicht van de ochtend |
| 10. Escalatie | MSP eerste lijn, CaptiFi tweede lijn | Je weet wat je naar partners@captifi.io moet sturen |
1. Onderzoek de locatie voordat je een offerte maakt
Onderzoek de dekking en het drukste uur, want in een ruimte die één access point kan dekken, kan het met een volle bar toch misgaan. De gids over hoeveel access points een zaak nodig heeft legt uit hoe je het aantal bepaalt. Noteer tijdens hetzelfde bezoek:
- het merk, het model en de firmwareversie van de controller, en of je beheerderstoegang hebt
- of de controller vanaf internet bereikbaar is: de route met een API-sleutel van CaptiFi voor UniFi heeft dat nodig, terwijl de Remote Tunnel zelf een uitgaande verbinding opzet, zonder inkomende poorten; een Omada-controller op locatie heeft een port forward nodig, en de gratis versie Central Essentials van Omada (voorheen Cloud Essentials) wordt niet ondersteund
- apparaten die geen inlogpagina kunnen doorlopen, zoals pinautomaten, smart-tv's en printers
- wie het domein en de DNS van de zaak beheert, voor stap 8
Een zaak zonder compatibele apparatuur kan het CaptiFi-apparaat gebruiken, dat je met een ethernetkabel op het bestaande netwerk aansluit, zonder controller, vast IP-adres of wijziging in de firewall.
2. Geef gasten hun eigen SSID en VLAN
Zet gasten op een aparte SSID en VLAN met client isolation, zodat ze niet bij de kassa's, de camera's, de kantoorcomputers of elkaar kunnen komen. Cisco Meraki omschrijft Wireless Client Isolation als een functie die "voorkomt dat draadloze clients met elkaar communiceren"; op een SSID in bridgemodus blijft die uit totdat je hem inschakelt. Controleer de vergelijkbare instelling bij elk merk dat je installeert.
Het portal werkt op gasten-SSID's die open zijn of Enhanced Open, WPA2 of WPA3 gebruiken (zie captive portal of wifi-wachtwoord). Laat op Omada de optie Guest Network van de SSID uit, omdat gasten daarmee het portaladres van de controller niet meer bereiken, en vertrouw in plaats daarvan op het VLAN. Pinautomaten horen op het personeelsnetwerk. Een tv waarnaar gasten casten kan op het gastennetwerk blijven als je het MAC-adres vooraf autoriseert, wat CaptiFi ondersteunt op zijn eigen access points en op UniFi; zie de gids over smart-tv's op gastenwifi.
3. Stel het externe portal en de walled garden in
Laat de gasten-SSID naar CaptiFi verwijzen als extern portal, voeg de hosts van CaptiFi toe aan de walled garden en schakel de eigen inlogmethoden van de controller uit, zodat er maar één portal actief is. De waarden verschillen per platform:
| Platform | Portalinstelling | Walled garden | Hoe gasten online komen |
|---|---|---|---|
| UniFi | Hotspot Portal, External Portal Server: 46.62.168.7 en site.app.captifi.io (CaptiFi schrijft deze weg via een verbinding met API-sleutel of Remote Tunnel) | site.app.captifi.io, app.captifi.io, fonts.googleapis.com, fonts.gstatic.com, plus *.captifi.io als de firmware wildcards accepteert | UniFi Controller API, geen RADIUS |
| TP-Link Omada | Portal, External Portal Server, https:// en app.captifi.io/guest/omada?site_id=YOUR_SITE_ID | app.captifi.io, 46.62.168.7 als IP-bereik met masker 32, fonts.googleapis.com, fonts.gstatic.com; geen wildcards | Een Hotspot-operatoraccount dat je voor CaptiFi aanmaakt |
| Cisco Meraki | Custom splash URL met het MAC-adres van de client, click-through, alle toegang blokkeren tot het inloggen | app.captifi.io, site.app.captifi.io, *.captifi.io, network-auth.com, *.network-auth.com, fonts.googleapis.com, fonts.gstatic.com | De grant-URL van Meraki, waarvoor de vermeldingen van network-auth.com nodig zijn |
| Aruba Instant On | Guest portal, External, met de Portal URL en de Redirect URL van CaptiFi | app.captifi.io, captifi.io, fonts.googleapis.com, fonts.gstatic.com | RADIUS naar radius.captifi.io, poorten 1812 en 1813 |
Vink op UniFi Show Landing Page, HTTPS Redirection Support, Encrypted URL en Secure Portal aan, en schakel de eigen methoden Password, Voucher, Facebook, Payment en RADIUS van UniFi uit; twee actieve portals veroorzaken een redirectlus. Vul op Omada de Controller URL, het Controller ID van 32 tekens en de operatorlogin in op my.captifi.io, en met een Open API-app met de rol Admin kan CaptiFi het portal en de pre-authenticatielijst voor je instellen. Voor FortiGate, Ruckus, MikroTik en Cisco Catalyst is er telkens een installatiehandleiding, gelinkt vanaf de hardwarepagina; voor MikroTik en DrayTek stuurt de support van CaptiFi de portalgegevens die je nodig hebt.
Voeg fonts.gstatic.com bij naam toe, nooit als *.gstatic.com, een wildcard die ook het adres dekt dat Android-telefoons testen. Android herkent een portal met "onversleutelde HTTP-probes naar bekende bestemmingen (zoals connectivitycheck.gstatic.com)", en de documentatie waarschuwt dat zulke probes "per abuis kunnen worden toegelaten of geblokkeerd (in plaats van omgeleid)" (Android Developers), dus een probe die de walled garden doorlaat, verbergt de pagina voor Android-telefoons.
4. Bouw de inlogpagina en de toestemmingsvraag
Bouw de pagina in de huisstijl van de zaak en laat de eigenaar hem goedkeuren voordat hij live gaat. Vraag om het logo als PNG, JPG of WebP van minimaal 200 bij 200 pixels, op een transparante achtergrond als de zaak die heeft. Controleer voordat je opslaat in de editor voor inlogpagina's dat:
- toestemming voor e-mailmarketing aanstaat, zoals standaard het geval is: marketingtoestemming wordt los van het online gaan gevraagd, en op de standaardinlogpagina is het een eigen vraag nadat de gast op Verbinden tikt, met de knoppen Accepteren en Weigeren, en gasten die weigeren komen nog steeds online
- de links naar het eigen privacybeleid en de eigen voorwaarden van de zaak zijn ingesteld, met een privacymelding op het formulier waar de lokale wet die bij het verzamelen van gegevens voorschrijft
- Doorsturen na verbinden verwijst naar de pagina die de eigenaar kiest, zoals de menukaart
5. Test op een iPhone en een Android-telefoon
Test met één iPhone en één Android-telefoon die nog nooit met het gastennetwerk verbonden zijn geweest. Een telefoon die eerder verbonden was, kan een fout verbergen, omdat CaptiFi een terugkerend apparaat direct doorlaat, en Apple zegt dat op iOS 18 en nieuwer het vergeten van een netwerk het privéadres van de telefoon niet opnieuw instelt als de telefoon dat netwerk minder dan 24 uur eerder voor het laatst moest vergeten, twee weken op oudere versies (Use private Wi-Fi addresses on Apple devices). Daarna:
- Schakel op beide telefoons mobiele data uit.
- Maak verbinding met de gasten-SSID en wacht zonder een browser te openen. In de handleiding van Apple over captive wifi-netwerken staat dat je op de netwerknaam tikt en "wacht tot er een inlogscherm verschijnt"; Android behandelt een omgeleide probe als een portal en vraagt de gebruiker om in te loggen.
- Doorloop de pagina op beide telefoons, tik op de ene op Accepteren en op de andere op Weigeren, en controleer of beide online komen.
- Open op elke telefoon een gewone HTTPS-site.
- Controleer of beide testgasten in Gastbezoeken op my.captifi.io staan.
Sluit het venster op de iPhone niet met Gebruik zonder internet, want volgens Apple wordt daarmee "het welkomstscherm gesloten en automatisch inloggen voor het netwerk uitgeschakeld". Verschijnt de pagina helemaal niet, dan loopt de gids over een captive portal dat niet verschijnt de oorzaken op volgorde door.
6. Lees het installatielabel voordat je vertrekt
Blijf op locatie tot op het installatielabel van de klant Klaar staat. Op de pagina Klanten van het partnerdashboard van CaptiFi heeft elke reseller- en white-labelklant een label dat bijhoudt of de locatie is aangemaakt, het apparaat online is, de inlogpagina live is en de eerste gast verbonden is, en bij een oranje teller zoals 2/4 staat in een tooltip wat er nog moet gebeuren. Staat de eerste gast na je tests uit stap 5 nog steeds in de tooltip, dan zijn die logins niet bij CaptiFi aangekomen, dus ga terug naar stap 3.
7. Draag de klantlogin over
Geef de eigenaar een login en vertel wie hij moet bellen. Een login is optioneel (sommige partners beheren zaken volledig zelf), maar een eigenaar die zijn gasten wil zien, heeft er een nodig:
- Gebruik Uitnodiging versturen in de rij of op de detailpagina van de klant om een link te mailen waarmee hij een wachtwoord instelt; je kunt die altijd opnieuw versturen.
- Loop met de eigenaar door my.captifi.io. Een klant ziet alleen zijn eigen locaties en geen prijzen van CaptiFi; op de plek van de facturering staat een melding dat zijn dienstverlener die regelt.
- Leg uit wat de pagina verzamelt, hoe toestemming werkt en hoe de support loopt. Supporttickets van klanten gaan naar je eigen supportadres en je pagina Tickets, niet naar CaptiFi.
White-labelklanten zien je logo en kleuren zodra ze zijn ingelogd, maar de inlogpagina van het dashboard op my.captifi.io is die van CaptiFi, dus vertel de eigenaar wat hij ziet als hij de eerste keer inlogt. Of stuur hem naar je eigen domein, waar de inlogpagina jouw merk draagt.
8. Verifieer het afzenderdomein voor e-mail aan gasten
Verifieer het verzenddomein van de zaak in de eerste week, want CaptiFi verstuurt campagnes alleen vanaf een geverifieerd domein. Tot die tijd gaan reviewverzoeken en andere automatische e-mails aan gasten op naam van de zaak de deur uit vanaf een CaptiFi-adres voor de zaak.
- Open in het account van de klant Marketing, Instellingen, Afzender & domein, en sla een afzendernaam en een adres op het domein van de zaak op.
- Voeg de DNS-records toe die CaptiFi genereert, waaronder een TXT-record op _captifi. gevolgd door het domein. Met Deze instructies mailen stuur je ze naar degene die de DNS beheert, zonder dat een CaptiFi-login nodig is.
- Klik op Nu verifiëren zodra de records zijn doorgevoerd (meestal binnen enkele minuten, maximaal 48 uur). Bij elk record staat Geslaagd en bij het domein staat Geverifieerd.
Een domein kan in maar één CaptiFi-account worden geverifieerd, dus gebruik het account van de klant en niet je eigen account. Inboxproviders controleren verzenddomeinen: de richtlijnen voor e-mailafzenders van Gmail verplichten iedereen die naar Gmail-accounts verstuurt om SPF of DKIM in te stellen en het spampercentage dat in Postmaster Tools wordt gerapporteerd onder 0.3% te houden. Wie meer dan 5,000 berichten per dag naar Gmail-accounts stuurt, heeft bovendien zowel SPF als DKIM nodig, DMARC, een From-domein dat op SPF of DKIM is afgestemd, en afmelden met één klik in marketingmail.
9. Controleer de eerste week met het statusoverzicht
Controleer in de eerste week of de zaak elke dag gasten heeft en buiten het statusoverzicht van de ochtend blijft. Het overzicht van CaptiFi mailt je supportadres alleen als iets aandacht nodig heeft, zoals apparaten die offline zijn, openstaande meldingen of locaties die een week geen gasten hadden, en stuurt elke maandag een volledige samenvatting.
In het overzicht van al je klantlocaties telt de tegel Apparaten online alleen CaptiFi-apparaten, dus let bij een zaak met UniFi of Omada op Gasten vandaag en Laatste activiteit, waaraan je ziet dat een zaak is stilgevallen terwijl de hardware zich nog online meldt.
10. Escaleer met het bewijs dat CaptiFi nodig heeft
Jij bent de eerste lijn en CaptiFi is de tweede lijn via partners@captifi.io; meld het als een zaak plat ligt, zodat het als urgent wordt behandeld. Sluit vóór je escaleert een lokaal netwerkprobleem uit, controleer de verbinding met de controller en test met een schoon apparaat zonder portal in de cache. Stuur daarna de naam van de zaak, het controllerplatform en de versie, welke apparaten falen en wat ze tonen, wanneer het begon en wat er is veranderd, met screenshots en logs.
Oefen de checklist vóór je eerste klant
Doorloop het instellen van de controller en de telefoontests eerst op een eigen locatie voordat je dat bij een klant doet. Goedgekeurde CaptiFi-partners krijgen een gratis licentie van 6 maanden voor één interne testlocatie, nooit voor een live klantlocatie, en op de pagina Gastbezoeken daarvan zie je je testlogins binnenkomen. De pagina Klanten, het installatielabel en het statusoverzicht die hierboven zijn gebruikt, horen bij het reseller- en het white-labelmodel; de gids over gastenwifi voor MSP's en white-labelresellers vergelijkt de modellen, en op de pagina van het partnerprogramma staan de voorwaarden. Voor de verkoop die aan de installatie voorafgaat, lees je hoe je gastenwifimarketing verkoopt aan horecazaken. Wil je de licentie krijgen, meld je dan aan voor het partnerprogramma.
Bronnen: Apple Support, Use captive Wi-Fi networks on your iPhone or iPad en Use private Wi-Fi addresses on Apple devices; Android Developers, Captive portal API support; Cisco Meraki Documentation, Wireless Client Isolation; Gmail Help, Email sender guidelines; TP-Link, Omada Central Essentials (persbericht, 19 mei 2025), allemaal geraadpleegd op 22 oktober 2026; de pagina's van het partnerprogramma, de installatiehandleidingen en de klantdocumentatie van CaptiFi, oktober 2026. iPhone, UniFi, Omada, Meraki, Aruba Instant On, FortiGate, Ruckus, MikroTik, Cisco Catalyst, DrayTek, Android, Gmail en Omada Central zijn handelsmerken van hun respectieve eigenaren; CaptiFi is niet aan hen verbonden en is niet door hen goedgekeurd.
Veelgestelde vragen
Korte antwoorden op de meest gestelde vragen over dit onderwerp.
Wat moet een MSP controleren voordat hij gastenwifi bij een zaak installeert?
Welke vermeldingen in de walled garden heeft CaptiFi nodig op UniFi, Omada en Meraki?
Hoe test ik een captive portal op een iPhone en een Android-telefoon?
Wat laat het installatielabel in het partnerdashboard van CaptiFi zien?
Moet een zaak een afzenderdomein verifiëren voor e-mails aan gasten op CaptiFi?
Wat moet een MSP naar CaptiFi sturen bij het escaleren van een storing in de gastenwifi?
Hoe ga je om met pinautomaten en smart-tv's op een netwerk met een captive portal?
Heeft het gastenwifinetwerk van een zaak client isolation nodig?
De redactie van CaptiFi schrijft over gastenwifimarketing, captive portals, het vastleggen van gegevens volgens de AVG en lokale SEO voor ondernemers met een zaak. Als we CaptiFi met een ander platform vergelijken, gebruiken we de eigen website van dat bedrijf, met de datum waarop we die hebben geraadpleegd.
Klaar om van je gastenwifi een marketingmachine te maken?
CaptiFi legt bij elke wifi-login klantgegevens vast, automatiseert Google-reviews en opvolgmails, en sluit aan op de tools die je al gebruikt. Het CaptiFi-apparaat zit bij elk abonnement, tegen een borg die je terugkrijgt, de prijzen staan op de prijzenpagina en elk abonnement heeft een gratis proefperiode van 30 dagen.