LOCAL DATA • USB PHONE CONTROL

WhatsApp Campaign

Online dashboard, local Windows agent, local SQLite database. No cloud database required.

Agent offline

1. Windows Agent

The customer downloads one EXE. Python, ADB and app logic are bundled in the release build.

Download Windows Agent

Expected version 1.1.0

2. Android Phone

Connect one Android phone by USB and authorize USB debugging.

Serial—

Keyboard—

Resolution—

Profile—

3. Keyboard Setup

Clean V1 uses six row anchors instead of OpenCV/EasyOCR. It is lighter, predictable, and still physically taps the phone keyboard.

Before keyboard calibration

English setup

Open a WhatsApp chat, tap the message field, set the PHONE keyboard to ENGLISH, keep it visible, then click Set English.

Arabic setup

After English is captured, switch the PHONE keyboard to ARABIC, keep it visible, then click Set Arabic.

Test Keyboard

This test physically types a draft on the phone. It does not press Send.

Phone keyboard currently starts in

PHONE KEYBOARD MUST CURRENTLY BE: ENGLISH

Open a WhatsApp chat on the phone.
Tap the message field so the keyboard is visible.
Set the PHONE keyboard to ENGLISH.
Keep the keyboard visible, then click Test Keyboard.

Mixed English/Arabic test text is allowed. The agent starts from the selected phone language and switches when needed.

4. Contacts

CSV/XLSX columns: name and phone.

Import behavior Replace current contactsUse only the contacts in the new file. Add to current contactsKeep old contacts and add/update the new ones.

Your current contact list will be replaced by this file.

Stored locally 0

5. Local Database

Contacts, templates, keyboard profiles and campaign results stay on this PC.

Storage SQLite • Local PC

6. Ten Message Variants

Use {name}. Variants rotate from 1 → 10 → 1.

7. Campaign

Campaign name Delay between contacts Keyboard starts in Before starting, set the PHONE keyboard to ENGLISH.

Sent0

Failed0

Remaining0

Ready