Mobile App (PWA) Setup Guide
Overview
The Mobile App (PWA) in WPiko Chatbot Pro lets Administrators and WPiko Agents monitor conversations, receive new message alerts, and reply to visitors without opening the WordPress admin dashboard. The app is served from your own website and can be installed on supported phones and tablets as a Progressive Web App.
This guide covers the main setup flow, installation requirements, and first sign-in steps.
What the Mobile App Includes
- Real-time conversation list for active and recent chats
- Live conversation view with visitor presence details
- Admin Takeover for replying as a human agent
- Push Notifications for new incoming messages
- Home screen installation on supported mobile browsers
Requirements
Plugin Requirements
WordPress Requirements
– Administrator
– WPiko Agent
Site Requirements
Device Requirements
– Service Workers
– Push API
– Notifications API
Initial Setup
Step 1: Enable the Mobile App
When enabled, the app becomes available at:
/wpiko-app/
Example:
https://yourdomain.com/wpiko-app/
Step 2: Set the App Name
The App Name is used for the installed app label and the PWA manifest.
Use a short name that is easy to recognize on a phone home screen.
Examples:
- Store Chat
- Support Inbox
- Live Chat Team
Step 3: Create an Application Password
The Mobile App does not use the user’s normal WordPress password.
Each Administrator or WPiko Agent should:
- Go to Users > Profile.
- Scroll to Application Passwords.
- Enter a name such as
WPiko Mobile App. - Click Add New Application Password.
- Copy the generated password.
Step 4: Sign In
The app uses the site’s own REST API and authenticates with the WordPress username plus Application Password.
Step 5: Install to Home Screen
iPhone and iPad
Android
First Use Checklist
- Confirm the conversation list loads successfully
- Open a conversation and verify messages load
- Confirm the visitor presence status appears in the conversation header
- Enable push notifications if you want alerts for new visitor messages
- Test takeover on a conversation before relying on the app for live support
Notes
Access URL
The Mobile App is not hosted on a third-party service. It is served directly from your WordPress site through the dedicated PWA route.
Secure Access
On live websites, non-HTTPS requests are blocked for the Mobile App and its API endpoints.
License Dependency
If the Pro license expires or the Mobile App feature is disabled, the PWA route and related REST access will stop working until the feature is re-enabled with a valid license.
