How gianllucaleme/bot_inaters works
Bot iNaters automates commands in private WhatsApp groups. Members send a command; main.js normalizes and filters the message, applies group and cooldown checks, then dispatches it to command-family routers. Those routers resolve aliases and command data, invoke handlers, and send mentions, media, or help replies through WhatsApp. Administration and pause state are separate runtime concerns. The README also documents a watchdog that restarts the bot; its implementation is present, but source details are not excerpted.
Main entry points: main.js Message listener · utils.js Shared utilities · agaSender.js AGA sender · helpSender.js Help replies
Components 27
Message runtime
- Message listener
main.js - Restart watchdog
watchdog.js - Connectivity check
lib/internet.js
Command routing
- Mention router
commands/core.js - Easter router
commands/easter.js - AGA router
commands/aga.js - Admin router
commands/admin.js - Help router
commands/help.js
Command features
- Mention definitions
commands/helpers/mentionCommands.js - Mention aliases
commands/maps/mentionAliases.js - Mention sender
commands/handlers/mentionSender.js - Easter definitions
commands/helpers/easterCommands.js - Easter aliases
commands/maps/easterAliases.js - Easter sender
commands/handlers/easterSender.js - AGA audio map
commands/helpers/agaCommands.js - AGA aliases
commands/maps/agaAliases.js - AGA sender
commands/handlers/agaSender.js - Admin actions
commands/handlers/adminSender.js - Help replies
commands/handlers/helpSender.js
Configuration and state
- Command registry
config/commandList.js - Allowed groups
config/groups.js - Contact data
config/contacts_load.js - Group pause state
lib/pauseManager.js - Shared utilities
lib/utils.js - Runtime paths
config/paths.js
Other components
- Group members
- WhatsApp service
Connections 41
- Group members → Message listener: send commands
README.md - Message listener → Mention router: dispatches
main.js - Message listener → Easter router: dispatches
main.js - Message listener → AGA router: dispatches
main.js - Message listener → Admin router: dispatches
main.js - Message listener → Help router: dispatches
main.js - Message listener → Command registry: checks commands
main.js - Message listener → Allowed groups: checks groups
main.js - Message listener → Group pause state: checks pause
main.js - Message listener → Shared utilities: normalizes text
main.js - Message listener → Contact data: loads contacts
main.js - Mention router → Mention aliases: resolves aliases
commands/core.js - Mention router → Mention definitions: reads definitions
commands/core.js - Mention router → Mention sender: calls sender
commands/core.js - Easter router → Easter aliases: resolves aliases
commands/easter.js - Easter router → Easter definitions: reads definitions
commands/easter.js - Easter router → Easter sender: calls sender
commands/easter.js - AGA router → AGA aliases: resolves aliases
commands/aga.js - AGA router → Command registry: reads registry
commands/aga.js - AGA router → AGA sender: calls sender
commands/aga.js - Admin router → Admin actions: uses admin checks
commands/admin.js - Admin router → Group pause state: pauses group
commands/admin.js - Admin router → Shared utilities: shuffles contacts
commands/admin.js - Help replies → Command registry: lists commands
commands/handlers/helpSender.js - Help replies → Mention definitions: describes commands
commands/handlers/helpSender.js - Help replies → Mention aliases: describes aliases
commands/handlers/helpSender.js - Help router → Help replies: calls sender
commands/help.js - Mention sender → Shared utilities: builds mentions
commands/handlers/mentionSender.js - AGA sender → AGA audio map: reads audio map
commands/handlers/agaSender.js - AGA sender → Shared utilities: builds mentions
commands/handlers/agaSender.js - AGA sender → Contact data: reads contacts
commands/handlers/agaSender.js - Admin actions → Contact data: reads contacts
commands/handlers/adminSender.js - Group pause state → Shared utilities: loads and saves
lib/pauseManager.js - Shared utilities → Runtime paths: uses pause path
lib/utils.js - Restart watchdog → Message listener: restarts process
README.md - Restart watchdog → Connectivity check: checks connectivity
- Message listener → WhatsApp service: sends replies
main.js - Mention sender → WhatsApp service: sends mentions
- Easter sender → WhatsApp service: sends media
- AGA sender → WhatsApp service: sends audio
- Help replies → WhatsApp service: sends help