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.
- 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
- QR/Pairing Code Login
- Custom Session
- Admin Roles System
- Self Mode
- 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
- Pretty Logger
- Log Incoming Messages
- Log Level Control
- Context Info
- Typing Simulation
- Text
- Image
- Video
- Audio
- Document
- Location
- Contact
- Reaction
- Quote
- Install dependencies:
npm install- Run the bot:
npm startnpm run cc
npm run cp
npm run clone plugin <url>
npm run clone command <url>
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
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