Aerion

Aerion is a powerful WhatsApp bot built with Node.js. It can automatically respond to messages, execute custom commands, and handle various events on WhatsApp. Aerion supports plugins, advanced logging, user and session management, context-aware commands, and anti-spam protections, making it highly customizable and suitable for both personal and group chats. With Aerion, you can automate tasks, monitor chats, and extend functionality through custom commands or plugins.

---

🚀 Key Features

Command & Plugin System

• Command System
• Plugin System
• Custom Prefix Commands
• Command Access Control
• Command Cooldown (Anti-Spam Protection)
• Context-Aware Mode (Private / Group / Both)
• Show Executed Commands
• CLI Command

User & Session Management

• QR/Pairing Code Login
• Custom Session
• Admin Roles System
• Self Mode

Message & Event Handling

• New Message Event
• Message Update Event
• Message Receipt Event
• Message Reaction Event
• Call Event
• Label Association Event
• Label Edit Event
• Presence Update Event
• Chat Update Event
• Contact Update Event
• Chat Delete Event
• History Sync Event
• History Sync & Placeholder Resync
• Placeholder Message Handling
• Poll Aggregation

Logging & Monitoring

• Pretty Logger
• Log Incoming Messages
• Log Level Control
• Context Info
• Typing Simulation

---

💬 Supported Message Types

• Text
• Image
• Video
• Audio
• Document
• Location
• Contact
• Reaction
• Quote

---

🛠 Installation & Running the Bot

1. Install dependencies:

npm install

2. Run the bot:

npm start

---

📦 CLI

Create Command Template

npm run cc

Create Plugin Template

npm run cp

Clone Command/Plugin

npm run clone plugin <url>
npm run clone command <url>

---

📘 API Reference

Command

Commands are stored in:

/commands/

Each Command must export an object with the structure:

module.exports = {
  prefix: ["PrefixCustom"],
  admin: true/false,
  context: 'private' | 'group' | 'both',
  name: 'CommandName',
  description: 'CommandDesc',

  execute: async (client, msg, args) => {
    await msg.send({
      // key logic
    });
  }
};

Command Properties

Property	Type	Required	Description
name	string	✔️	The command name.
description	string	✔️	A short description of the command.
execute()	function	✔️	The function that is executed when the command is invoked.
prefix	array	❌	A special prefix other than the global prefix.
admin	boolean	❌	Only admins may use.
context	string	❌	private, group, or both.

Supported Key List

Key	Writing Format	Description
text	text: "message"	Sends plain text.
quote	quote: true	Reply to a message sent by the user.
react	react: "❤️"	Sends an emoji reaction.
mediaType	mediaType: "image"	Media type (image, video, etc.).
source	source: "url/filepath"	Media file source (URL / local).
caption	caption: "text"	Caption for the media.
location	location: { degreesLatitude: 0, degreesLongitude: 0 }	Sends location.
contacts	contacts: { displayName, contacts:[vcard] }	Sends contact/vCard.
document	mediaType: "document"	Sends document.
audio	mediaType: "audio"	Sends audio.
video	mediaType: "video"	Sends video.
ctxInfo	ctxInfo: true	Sends custom context info.

Examples: text.js

Plugin

Plugins are stored in:

/plugins/

Each plugin must export an object with the structure:

module.exports = {
  name: "PluginName",
  events: [...],

  async execute(client, ...args) {
    // plugin logic
  }
}

Plugin Properties

Property	Type	Required	Description
name	string	✔️	Plugin name (default = filename if not provided).
events	array	✔️	List of events the plugin listens for, e.g., ["init", "messages.upsert", "messages.update"].
async execute(client, ...args)	function	✔️	Function that is executed when any of the listed events occurs. Arguments depend on the event:

List of Supported Events

Event	Description
init	Called when the bot starts.
messages.upsert	New message.
messages.update	Message updated.
messages.delete	Message deleted.
presence.update	Online / typing status.
connection.update	Connection update.
contacts.update	Contact changed.
chats.update	Chat changed.
chats.delete	Chat deleted.
labels.association	Label added.
labels.edit	Label changed.
call	Incoming call.
message-receipt.update	Update message status.
reaction.update	Message reactions.
history.sync	Sync history.
poll.update	Poll updates.
group.update	Group info changes.

Examples: webhook.js