iDeep WhatsApp Bot — Control Panel

WhatsApp Login

Click "Connect" to generate a QR code

Or use a pair code

Status

State-

Connected since-

Messages stored0

Auto-replyDisabled

Contacts cached0

API integration

                            
                                curl -H "X-API-Key: YOUR_KEY" \

                                  http://localhost:8000/api/v1/messages/send \

                                  -d '{"phone":"989...", "message":"Hello!"}'

Send Message

Search Messages

Conversations

Select a conversation

💬

Pick a chat on the left to view the conversation.

Restore Chats from Backup

Bring old conversations into the message store so they show up in history, search, and the assistant's context. Supported files (auto-detected):

Per-chat backup — a WhatsApp "Export chat" .txt file, or the .zip it comes in (Chat > ⋮ > More > Export chat)
Full backup — a decrypted Android msgstore.db, an iOS ChatStorage.sqlite, or a .zip bundling many exported chats
Media bundle — a .zip with the DB plus the actual media files (build it with scripts/export_ios_backup_bundle.py); photos, voice notes, stickers and documents are imported with thumbnails

Encrypted .crypt14/.crypt15 files must be decrypted with your 64-digit backup key first (e.g. with wa-crypt-tools). Re-uploading the same backup is safe — duplicates are skipped.

Auto-Reply

LLM:none

Auto-replies fire on incoming 1-on-1 chats. Group messages are ignored.

Auto-Reply enabled

Assistant name

Default reply (used when a rule has no message and LLM is off)

LLM-powered replies

Provider and model are read from .env (LLM_PROVIDER, LLM_MODEL, LLM_API_KEY). Restart the server after changing them.

Use LLM by default for auto-replies

System prompt

Per-contact personas (below) can override this prompt.

Quiet hours

Enable quiet hours

Start (HH:MM)

End (HH:MM)

Timezone (IANA)

Away message during quiet hours (leave blank to stay silent)

Defer scheduled sends until window closes

Human handover & commands

The bot waits before replying and backs off when you handle a chat yourself. Control it from WhatsApp with your own messages: #mute / #unmute inside a chat, #bot off, #bot off 2h, #bot on, #status anywhere — or bare codes (off, on, status) in the control chat. Only messages sent by you are ever treated as commands.

Reply delay (seconds)

Cancelled if you reply first. 0 = immediate.

Back off after I reply (minutes)

Bot stays out of a chat you replied in.

Hold after I read (minutes)

Extra wait when you open the chat on your phone.

Command prefix

Control chat (phone, optional)

Bare codes work in this chat, no prefix needed.

Muted chats

Auto-Reply Rules

Rules are evaluated by priority (lowest first). The first match wins.

Contact Personas

Per-contact context fed into the LLM. Use this to make replies sound right for specific people.

Schedule a Message

The scheduler fires every 20 seconds. During quiet hours, sends defer until the window closes.

Pending

History

Allowed Contacts

Curate the contacts the assistant (Manus / LLM) may send WhatsApp messages to. Turn the master switch off to allow sending to anyone.

Enforce Allow-List

LLM Instructions Endpoint

Point Manus / your agent at one of these endpoints at session start so it knows the send policy and the curated contacts.

                        GET /api/v1/instructions             # full bootstrap (includes allow-list)
GET /api/v1/permissions/instructions # allow-list policy only
Header: X-API-Key: YOUR_KEY
                    

API Configuration

API Base URLhttp://localhost:8000

API Docs/docs (Swagger UI)

ReDoc/redoc

Health Check/health

LLM Provider

Change provider/model/key in .env and restart. Supported: openai, anthropic.

Webhooks

Manus Integration

Configure an MCP server or use the HTTP API directly.

# Manus reading chats
GET /api/v1/messages/chats
Header: X-API-Key: your_api_key

# Manus searching messages
POST /api/v1/messages/search
Body: {"query": "date with Masoud", "contact": "Masoud Nayebi"}

# Manus replying as assistant
POST /api/v1/assistant/reply-as-assistant
Body: {"phone": "989...", "message": "Hi, Alireza will contact you soon."}

Authentication Required