Open WhatsApp β Linked devices β Link a device
β± Refreshing in 20s
Getting βCouldnβt link deviceβ? Retry first. If it keeps failing, clear the
session for a completely fresh one β that sometimes links when a stale
session will not.
β
WhatsApp Connected
You can now use Groups, Send, Schedule and Attendance.
Chats or messages not loading? Restart first β it reconnects WhatsApp and
keeps you logged in. Only log out if you actually need to link a different
phone: re-linking needs a new QR scan, which can be hard to complete.
β οΈ
Disconnected
Reconnecting automaticallyβ¦
π₯ Customer Groups
Google Sheets not configured.
Add these to your .env file on the VPS, then restart the app:
GOOGLE_CLIENT_EMAIL β service account email
GOOGLE_PRIVATE_KEY β private key from the JSON file
GOOGLE_SPREADSHEET_ID β from the sheet URL
Each sheet tab in your spreadsheet = one customer group.
Required columns: Name and Phone (headers auto-detected).
Loading groups from Google Sheetsβ¦
π¬ WhatsApp Groups
Every group this WhatsApp account belongs to, with the ID to paste into the
phone column of a sheet tab. Loading reads the full chat list
from WhatsApp, so it is not automatic β press Load when you need it.
Reading groups from WhatsAppβ¦
π¨ View Messages
Fetches up to 500 recent messages per contact within the selected range.
Messages
Loading messagesβ¦
Select a group and date range, then click Load Messages.
0 selected
π€ Forward Selected Messages
No groups loaded
π New Schedule
No groups loaded
Timezone: = TIMEZONE ?>
Use 1β28 to avoid month-end issues
Saved Schedules
No schedules yet.
π¨ Awaiting your approval
β New rule
New rules are saved switched off. Turn one on only after
βCheck nowβ shows it matching what you expect.