Complete User Handbook & Onboarding v1.0.0

User Setup & Quickstart Guide

Step-by-step instructions to generate your free Google Gemini AI Key, connect your WhatsApp number via QR code or 8-digit pairing code, and launch intelligent automation.

Connect WhatsApp Configure AI Key
1. Gemini AI Key 2. Connect WhatsApp 3. 8-Digit Pairing Code 4. PDF Knowledge Base 5. Broadcast & Anti-Ban 6. FAQ
1
Generate Gemini Key

Get your 100% free API key from Google AI Studio in 60 seconds.

2
Save Key in Sessions

Go to Sessions ➔ Click 🤖 AI Persona ➔ Paste your key.

3
Connect WhatsApp

Scan QR code or link with 8-digit phone pairing code instantly.

4
Start Automation

Upload PDF notices, launch campaigns & handle customer inquiries.

1. How to Generate Google Gemini AI Key (Free)
Google provides 100% free Gemini API access with generous quota limits.
Open Google AI Studio
Step 1 Sign In with your Google Account

Visit aistudio.google.com/app/apikey and log in with your Gmail / Google account.

You do NOT need any credit card or billing details. Free tier is activated instantly.
Step 2 Click "Create API Key"

Click the blue "Create API Key" button. Select your default Google Cloud project or click "Create key in new project".

Example Key: AIzaSyD9...X8kLm4Q
Step 3 & 4
Where to Save your Gemini API Key in WA Platform

Once copied, go to Sessions, find your connected WhatsApp number card, and tap the Robot Icon ("AI Persona").

Inside the modal, paste your key into the "Custom Gemini AI API Key(s)" box and tap "Save AI Settings". Auto-Inherit: You only need to set this on any one session — your key is automatically shared and auto-inherited by all your other sessions!

Model: gemini-2.5-flash Multi-Key Round-Robin Supported Auto-Inherited Across All Sessions
2. How to Connect WhatsApp Session
You can link your WhatsApp number using either Camera QR Scan or 8-Digit Pairing Code.
Go to Sessions Page
Method A: QR Code Scan Recommended for Mobile Camera
1
Go to Sessions and tap "Add Session".
2
Enter a friendly Session Name (e.g. MyShop WA) and choose QR Code mode.
3
Open WhatsApp on your Phone:
  • Android: Tap 3 dots (top right) → Linked devices → Link a device.
  • iPhone: Go to Settings (bottom right) → Linked Devices → Link a Device.
4
Point your phone camera at the QR code. The session turns ONLINE within 3 seconds!
Method B: 8-Digit Pairing Code No Camera Needed!
1
On the Sessions page, tap "Add Session" & switch to "Pairing Code" tab.
2
Type your full phone number with country code (e.g. 919876543210) and click "Request Pairing Code".
3
An 8-character code appears on screen: ABCD-1234
4
Open WhatsApp → Linked Devices → Link a Device → tap "Link with phone number instead" → enter code. Done!
Pro Tip: Ensure your phone has active internet and disable "Aggressive Battery Saver" for WhatsApp so your socket remains online 24/7.
3. How to Setup PDF Knowledge Base (RAG)
Train the AI on your specific business files, catalogues, price lists, or admission notices.
Open Knowledge Base
1. Upload Document

Drop any PDF (digital or scanned). Google Gemini Document AI extracts all tables, dates, and text in Bengali and English with 100% precision.

2. Semantic Vector Indexing

The system chunks the document and stores 768-dimensional vector embeddings in your database for instant semantic search in milliseconds.

3. Smart WhatsApp Auto-Reply

When customers ask questions on WhatsApp, Gemini AI automatically searches relevant chunks from your PDF and sends an accurate, polite reply!

4. Bulk Broadcast & Anti-Ban Rules
Best practices to broadcast to thousands of contacts safely without WhatsApp bans.
Open Broadcast Page
Always Use Spintax

Spintax randomly rotates wordings so WhatsApp spam filters never see identical repetitive messages.

{Hello|Hi|Hey} {{name}}, {our offer|new deals} waiting!
Use the "Test Spintax" button in Composer to preview live variations!
CSV / Excel File Format

Column 1 must contain phone numbers with country code (e.g. 919876543210). Other columns can be referenced as variables like {{name}} or {{city}}.

phone,name,city
919876543210,Rahul,Kolkata
919876543211,Priya,Mumbai
5. Frequently Asked Questions (FAQ)
Quick answers to common questions and troubleshooting tips.

Yes! Google AI Studio provides a free tier for Gemini models (like gemini-2.5-flash) with up to 15 Requests Per Minute (RPM) and 1,500 requests per day for free, requiring no credit card.

WhatsApp QR codes refresh every 20 seconds. If it expires, click the "Refresh QR" button in the modal. Alternatively, switch to the 8-Digit Pairing Code method which is much faster and never times out!

Yes! This platform supports full Multi-Session WhatsApp rotation. You can connect 2, 5, or more WhatsApp accounts. During broadcasts, the system automatically rotates sender accounts to balance outgoing load.

Because this engine uses the official WhatsApp Multi-Device protocol (Baileys), the server stays linked even if your phone temporarily loses battery. However, WhatsApp requires your primary phone to check in online at least once every 14 days to keep linked sessions alive.