Projects in OdogboluProjects in Odogboluβ‘ SMSGang WhatsApp Cloud Assistant
A premium, feature-rich Go-based WhatsApp automation bot that turns your personal WhatsApp account into a smart virtual assistant. Unlike typical bots that require expensive official Business APIs, this bot securely runs as a linked web device on your account, enabling you to manage features directly by "messaging yourself"
π οΈ The Tech Stack: How it's Built
The bot is constructed using a high-performance, lightweight, and modern stack designed for speed, ease of deployment, and low memory consumption:
Programming Language: Go (Golang v1.25) - guarantees ultra-low CPU/RAM usage, concurrency safety, and fast compilation.
WhatsApp Gateway: whatsmeow (go.mau.fi/whatsmeow) an unofficial Go library that implements the WhatsApp Web protobuffer-based E2E protocol. It links your WhatsApp account via a simple terminal QR code scan.
AI Engine: Grok AI (xAI API) - powers all automated chat responses, homework solving, translation, and birthday greetings.
Database: SQLite (modernc.org/sqlite) - a pure Go, zero-dependency embedded SQLite database. No CGO required, ensuring the binary remains highly portable across systems.
Protocol Serialization: Google Protocol Buffers (protobuf) handles message parsing and serializing directly into WhatsApp's internal structure.
Deployment Options:
Docker & Docker Compose for containerized high-availability.
Systemd Service (babebot.service) for running as a background service on any Linux VPS.
π Key Features
1. π€ Multi-Contact Auto-Reply (AI Texting Style)
Smart Inactivity Window: If you receive a message and don't reply within a customized time (e.g., 60 seconds), the bot steps in. If you reply yourself first, the auto-reply is automatically cancelled.
Texting Style Adaptation: Uses Grok AI to analyze your conversation context and reply in a natural, human-like voice that mimics your messaging style.
2. π Per-Contact Personality Profiles
Customize how the bot interacts with different people in your life:
babe: Calm, soft, sweet, affectionate, and uses pet names. (Includes protection filters to prevent accidentally removing your babe from the bot's system).
friend: Casual, warm, and friendly.
formal: Professional and business-oriented.
chill: Short, concise, and direct answers.
3. ποΈ Auto Status Viewing
Automatically views all your contacts' statuses as soon as they are uploaded. Keep your presence active without manually scrolling through status pages. Toggleable with /statusview on|off.
4. β° Advanced Message Scheduling
Schedule messages to send to any contact at any specific time (e.g., /schedule mybro 14:30 Join the video meeting). A background worker processes pending schedules every 30 seconds.
5. π Automated Birthday Greetings
Store birthdays for your contacts. The bot runs a check every hour and automatically drafts a unique, AI-generated birthday greeting in the exact tone matching the recipient's personality profile (e.g., sweet for babe, chill/casual for friends).
6. π Anti-Call & Blocker
Automatically rejects incoming voice and video calls when enabled, preventing unexpected interruptions. Toggleable via /anticall on|off.
7. π‘οΈ Anti-Spam Filters
Filter and ignore unknown numbers that aren't on your registered whitelist, protecting your account from spam. Toggleable via /antispam on|off.
8. π AFK (Away From Keyboard) Mode
Activate a custom away message (e.g., /afk Studying for exams π). The bot will instantly inform anyone who messages you of your status and can be turned off simply by typing /afk off.
9. π ViewOnce Media Extractor (.vv / /vv)
Never lose ephemeral media. By quoting/replying to any ViewOnce image, video, or voice note with .vv or /vv, the bot extracts the media and sends a permanent copy directly to your direct message (DM).
10. πΌοΈ Instant Sticker Maker
Reply to any image in any chat with /sticker and the bot will instantly convert it into a WhatsApp sticker.
11. π£ Marketing Campaign Automation
Bulk Campaign Tool: Broadcast marketing campaigns to target lists with ease.
Target Selection: Load targets from harvested contacts, manual JIDs, joined groups, or file uploads (.txt, .csv, .vcf).
Media Support: Send both text and custom image payloads (by quoting an image with /campaign image).
Anti-Ban Safety: Fixed delay interval (30 seconds per message) ensures WhatsApp's rate limiters aren't tripped.
12. π₯ Contact Harvesting & Management
Harvest contacts automatically from group chats or status viewers.
Export your entire harvested database directly in your chat as a .vcf vCard contact card file.
Use /tagall in group chats to mention/ping every group participant with a custom message.
Broadcast custom messages to all registered contacts.
13. π§ Smart Utilities (Smart Ask, Translate & Homework Solver)
/ask <question>: Query Grok AI for instant answers to general questions in chat.
/translate <lang> <text>: Fast AI-powered language translation.
/solve <question>: Academic step-by-step homework helper. It parses questions (or quoted messages) and outputs clear, student-friendly tutorials.
SMSGANG Integrations (/cheapdata): Promotes and displays cheap student data bundles (MTN, Airtel, Glo, 9mobile) from smsgang.org (http://smsgang.org) to keep students online affordably.
π² Command Directory
You control all these features directly from your WhatsApp "Message Yourself" chat:
βοΈ Core Controls
/bot status β Check bot health, active toggles, tracked presence, and settings.
/bot on | /bot off Globally toggle auto-replies on/off.
/anticall on|off Toggle automatic call blocker.
/antispam on|off Toggle filtering for unknown numbers.
/statusview on|off Toggle auto-viewing of contact statuses.
/help Render the custom interactive help menu.
π₯ Contact Management
/add <number> <profile> [nickname] Add contact to auto-reply.
/remove <number|nickname> Remove contact.
/list View all configured contacts and birthdays.
/profile <number|nick> <profile> Update a contact's AI personality profile.
/pause <nick> | /resume <nick> Pause/resume auto-reply for a single contact.
/birthday <nick> <MM-DD> Add birthday for automated greetings.
β° Scheduling & Summaries
/schedule <nick> <HH:MM> <msg> Schedule a message.
/schedules View list of pending scheduled messages.
/summary Get a manual summary/digest of unread messages over the last 24 hours.
/summarize <nick> Let AI analyze and summarize your recent chat history with a contact.
π£ Campaign & Marketing (Admin Only)
/export Export harvested contact database as a .vcf document.
/broadcast <msg> Send a message to all registered contacts.
/tagall [msg] Mention everyone in a group chat.
/campaign text <msg> | /campaign image β Configure campaign text and media.
/campaign contacts <harvested|groups|status|nums> β Load target numbers.
/campaign file Load target numbers by quoting a .txt/.csv/.vcf file.
/campaign start|pause|stop|status Execution and monitoring of the marketing campaign.
π Utility & AI
/ask <question> Ask Grok AI a question.
/solve <question> Get step-by-step explanations for homework questions.
/cheapdata Check affordable student data bundles available via SMSGang.
/translate <lang> <text> Translate text to any language.
/note <text> | /notes | /delnote <id> Keep scratchpad notes directly in chat.
/sticker Reply to an image to make a sticker.
/bio <text> Remotely change your WhatsApp About/Status bio.
to connect the bot dm me 
